Установка

Десять минут. Никаких SQL-файлов и дополнительных ресурсов с пропами — таблицы создаются автоматически, а модели камер уже есть в самой игре.

Перед началом

Что нужно	Зачем
Запущенный ESX, QBCore или QBox	Идентификаторы, работы и используемые предметы. Определяется автоматически
Запущенный oxmysql	Хранение камер, ключей доступа, улик и логов
fmLib	Жёсткая зависимость: `mic_cctv` не запустится без него
screenshot-basic	Живая сетка и каждый снимок. Без него сетка останется пустой
Аккаунт FiveManage и API-токен	Туда загружаются снимки улик. Создайте токен на fivemanage.com в разделе Tokens
ox_inventory (рекомендуется)	Распечатанный предмет `cctv_photo` хранит ссылку на картинку через метаданные предмета

1. Поместите папку в ресурсы

Переместите mic_cctv в папку ваших ресурсов, например внутри resources/[mic]/. Не меняйте название папки: интерфейс планшета обращается к скрипту по этому имени.

2. Порядок запуска

В server.cfg, ниже вашего фреймворка и инвентаря, запустите oxmysql, screenshot-basic и fmLib, а затем mic_cctv — каждый ресурс на отдельной строке ensure.

Всё сработало, если при запуске в консоли сервера появляются строки:

[MIC-CCTV] Server Bridge initialized. Detected Framework: esx (или qbcore, что также отображается при использовании QBox)
[MIC-CCTV] Server Main Loop & Database initialized.
[MIC-CCTV] FiveManage integration loaded (server-side).

Если в первой строке написано standalone, значит mic_cctv запустился раньше вашего фреймворка — переместите его ниже.

На QBox оставьте Config.Framework равным 'auto': QBox определяется через слой совместимости с QBCore (qbx_core предоставляет qb-core), поэтому менять ничего не нужно.

3. База данных — ничего делать не нужно

При первом запуске скрипт сам создаст четыре необходимые таблицы — mic_cctv_cameras, mic_cctv_private_access, mic_cctv_evidence и mic_cctv_logs — а также добавит недостающие столбцы при обновлении со старой версии.

Всё сработало, если после первого запуска эти четыре таблицы появились в вашей базе данных.

4. FiveManage

Вставьте ваш API-токен FiveManage в серверный файл токена внутри ресурса. Он загружается исключительно на стороне сервера, поэтому игроки никогда не получат к нему доступ.

Токен нужен только для фотографий. Всё остальное — живая сетка, камеры, журнал событий — работает и без него.

Всё сработало, если вы делаете снимок (шаг 7) и в консоли появляется сообщение FiveManage upload success.

5. Добавьте предметы

Предмет	Что он делает
`cctv_tablet`	Открывает планшет безопасности
`cctv_wall`	Устанавливает настенную камеру (поворот на 45° в обе стороны)
`cctv_360_cam`	Устанавливает купольную камеру 360°
`cctv_pole`	Устанавливает камеру на столб (поворот на 45° в обе стороны)
`cctv_360_pole`	Устанавливает камеру 360° на столб
`cctv_repair`	Достаёт ремонтный лазер. Не расходуется при использовании
`cctv_photo`	Распечатанный снимок улики. Выдаётся планшетом; при использовании показывает изображение

Готовые определения предметов лежат в mic_cctv/items/, а иконки — в mic_cctv/items/images/:

Инвентарь	Определения (`mic_cctv/items/`)	Куда добавить	Иконки
ox_inventory	`ox.lua`	`ox_inventory/data/items.lua`	Скопируйте `items/images/*.png` в `ox_inventory/web/images/`
QBCore / qb-inventory	`qb.lua`	`qb-core/shared/items.lua`	Скопируйте их в `qb-inventory/html/images/`
Стандартный инвентарь ESX	`esx.sql`	Импортируйте один раз в вашу БД	—

Записи в файлах ox.lua и qb.lua закомментированы — удалите символы -- в начале строк после вставки. Иконки для cctv_photo в папке items/images/ нет — используйте любую подходящую картинку.

Всё сработало, если вы выдали себе по одному предмету каждого вида и они отобразились в инвентаре.

6. Права на конструктор для администраторов

Внутриигровой конструктор защищён ACE-разрешением, по умолчанию mic_cctvcreator.open. Выдайте его вашей группе администраторов в server.cfg с помощью строки add_ace, предоставляющей mic_cctvcreator.open для group.admin.

Всё сработало, если команда /camcreator открывает конструктор у администратора, а всем остальным выдаёт сообщение об отсутствии прав.

7. Первая камера

Используйте cctv_wall. Полупрозрачная модель камеры будет следовать за вашим взглядом. Крутите колёсико мыши для вращения, нажмите E для установки, правую кнопку мыши или ESC для отмены.
Введите название камеры в появившемся окне. Предмет заберётся из инвентаря, а камера появится на стене.
Используйте cctv_tablet. Ваша камера отобразится на сетке с живой картинкой.
Откройте её, поверните клавишами A / D, нажмите Пробел, чтобы сделать фото, и Backspace, чтобы вернуться назад.

Всё сработало, если на сетке видна живая трансляция с камеры, а сделанный снимок через мгновение появляется в галерее улик.

Перед открытием сервера

Решите, кто может пользоваться планшетом. Пустой список Config.AllowedJobs разрешает доступ всем; список работ ограничивает доступ только указанными фракциями — и одновременно делает каждую установленную игроком камеру фракционной камерой его текущей работы. Подробнее см. в разделе Настройка.
Выдайте права на конструктор только тем сотрудникам администрации, которые должны расставлять фракционные сети камер.
Проверьте токен FiveManage одним реальным снимком до того, как игроки начнут пользоваться галереей.
Убедитесь, что в Config.Locale выбран нужный вам язык.