Instalacja

Dziesięć minut. Bez pliku SQL i bez zasobu z propami — tabele tworzą się same, a kamery to propy, które gra już posiada.

Zanim zaczniesz

Potrzebujesz	Dlaczego
ESX, QBCore lub QBox, uruchomiony	Identyfikatory, prace i używalne przedmioty. Wykrywane automatycznie
oxmysql, uruchomiony	Kamery, klucze dostępu, dowody i logi
fmLib	Twarda zależność: `mic_cctv` nie uruchomi się bez tego zasobu
screenshot-basic	Siatka na żywo i każde zdjęcie. Bez niego siatka pozostaje pusta
Konto FiveManage i token API	Tam przesyłane są zdjęcia dowodowe. Utwórz token na fivemanage.com w zakładce Tokens
ox_inventory (zalecane)	Wydrukowany przedmiot `cctv_photo` zachowuje swój obrazek dzięki metadanych przedmiotu

1. Umieść folder na miejscu

Wrzuć mic_cctv do swoich zasobów, na przykład do resources/[mic]/. Zachowaj oryginalną nazwę: ekran tabletu komunikuje się ze skryptem właśnie za jej pomocą.

2. Kolejność uruchamiania

W pliku server.cfg, poniżej swojego frameworka i ekwipunku, uruchom oxmysql, screenshot-basic oraz fmLib, a następnie mic_cctv — każdy w osobnej linii ensure.

Zadziałało, gdy konsola serwera pokazuje przy starcie:

[MIC-CCTV] Server Bridge initialized. Detected Framework: esx (lub qbcore, co pokazuje się również w przypadku QBox)
[MIC-CCTV] Server Main Loop & Database initialized.
[MIC-CCTV] FiveManage integration loaded (server-side).

Jeśli pierwsza linia mówi standalone, zasób mic_cctv uruchomił się przed twoim frameworkiem — przenieś go niżej.

Na QBox zostaw Config.Framework ustawione na 'auto': QBox jest wykrywany poprzez swoją warstwę kompatybilności z QBCore — qbx_core dostarcza qb-core — więc nie trzeba nic zmieniać.

3. Baza danych — nic do roboty

Pierwsze uruchomienie automatycznie tworzy cztery wymagane tabele — mic_cctv_cameras, mic_cctv_private_access, mic_cctv_evidence oraz mic_cctv_logs — i dodaje ewentualne brakujące kolumny ze starszych wersji.

Zadziałało, gdy te cztery tabele pojawią się w twojej bazie danych po pierwszym uruchomieniu.

4. FiveManage

Wklej swój token API FiveManage do serwerowego pliku z tokenem w zasobie. Jest on ładowany wyłącznie po stronie serwera, więc gracze nigdy go nie otrzymują.

Potrzebują go tylko zdjęcia. Wszystko inne — siatka, kamery, logi — działa bez niego.

Zadziałało, gdy zrobisz zdjęcie (krok 7), a w konsoli pojawi się komunikat FiveManage upload success.

5. Dodaj przedmioty

Przedmiot	Co robi
`cctv_tablet`	Otwiera tablet bezpieczeństwa
`cctv_wall`	Umieszcza kamerę ścienną (obraca się o 45° w obie strony)
`cctv_360_cam`	Umieszcza kamerę kopułkową 360°
`cctv_pole`	Umieszcza kamerę na słupie (obraca się o 45° w obie strony)
`cctv_360_pole`	Umieszcza kamerę 360° na słupie
`cctv_repair`	Wyciąga laser naprawczy. Nie zużywa się
`cctv_photo`	Wydrukowane zdjęcie dowodowe. Wydawane przez tablet; użycie go pokazuje obraz

Gotowe definicje znajdują się w mic_cctv/items/, a ikony w mic_cctv/items/images/:

Ekwipunek	Definicje (`mic_cctv/items/`)	Gdzie trafiają	Ikony
ox_inventory	`ox.lua`	`ox_inventory/data/items.lua`	Skopiuj `items/images/*.png` do `ox_inventory/web/images/`
QBCore / qb-inventory	`qb.lua`	`qb-core/shared/items.lua`	Skopiuj je do `qb-inventory/html/images/`
Domyślny ekwipunek ESX	`esx.sql`	Zaimportuj raz do swojej bazy danych	—

Wpisy w plikach ox.lua i qb.lua są zakomentowane — usuń początkowe znaki -- po ich wklejeniu. W folderze items/images/ nie ma ikony cctv_photo; użyj dowolnego wybranego przez siebie obrazka.

Zadziałało, gdy dodasz sobie po jednym z każdego przedmiotu i pojawią się one w twoim ekwipunku.

6. Uprawnienia kreatora dla administracji

Kreator w grze jest zabezpieczony uprawnieniem ACE, domyślnie mic_cctvcreator.open. Nadaj je swojej grupie administratorów w pliku server.cfg za pomocą linii add_ace przyznającej mic_cctvcreator.open dla group.admin.

Zadziałało, gdy komenda /camcreator otwiera kreator u administratora, a u każdego innego gracza wyświetla komunikat o braku uprawnień.

7. Pierwsza kamera

Użyj cctv_wall. Półprzezroczysta kamera podąża za twoim wzrokiem. Przewiń kółkiem myszy, aby obrócić, naciśnij E, aby postawić, prawy przycisk myszy lub ESC, aby anulować.
Nadaj jej nazwę, gdy zostaniesz o to poproszony. Przedmiot zostanie zabrany, a kamera pojawi się na ścianie.
Użyj cctv_tablet. Twoja kamera jest widoczna na siatce z ruchomym obrazem.
Otwórz ją, obróć klawiszami A / D, naciśnij Spację, aby zrobić zdjęcie, oraz Backspace, aby wrócić.

Zadziałało, gdy siatka pokazuje obraz z kamery na żywo, a chwilę później zdjęcie pojawia się w galerii dowodów.

Zanim otworzysz swoje miasto

Zdecyduj, kto może korzystać z tabletu. Puste Config.AllowedJobs oznacza wszystkich; lista prac oznacza tylko wybrane frakcje — a dodatkowo sprawia, że każda kamera postawiona przez gracza staje się kamerą dla jego pracy. Zobacz Personalizacja.
Nadaj uprawnienia do kreatora wyłącznie członkom administracji odpowiedzialnym za tworzenie sieci kamer frakcyjnych.
Sprawdź token FiveManage, robiąc jedno prawdziwe zdjęcie, zanim gracze zaczną polegać na galerii.
Upewnij się, że Config.Locale ma ustawiony wybrany przez ciebie język.