Установка

Около десяти минут. Импортировать SQL не нужно — таблицы и весь контент по умолчанию создаются сами при первом запуске. Каждый шаг заканчивается пунктом «как понять, что всё сработало».

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

Что нужно	Зачем
oxmysql — запущен, с рабочей строкой подключения	Всё хранится в базе данных, включая контент админ-панели
fmLib	Объявлен как зависимость; без него ресурс не запустится
glitch-minigames	Мини-игры со взломом на этапе вскрытия замка
ESX, QBCore или QBox (необязательно)	Определяется автоматически. Без них скрипт работает как standalone
ox_target или qb-target (необязательно)	Только для соответствующего значения `Config.InteractionSystem`

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

Переместите mic_boosting в папку ваших ресурсов, например внутрь resources/[mic]/.

Не меняйте название папки mic_boosting. Название предмета mic_boosting_tablet, таблицы mic_boosting_* и всё, о чём вас спросит поддержка, используют именно это имя.

2. Запустите после того, на что он опирается

В server.cfg строка ensure mic_boosting должна стоять ниже oxmysql, вашего фреймворка (es_extended, qb-core или qbx_core), fmLib, вашего инвентаря, вашего ресурса таргета и glitch-minigames.

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

Всё сработало, если в консоли появилась строка [MIC-BOOSTING] Server Bridge initialized. Detected Framework: esx (или qbcore — это же отображается и для QBox — или standalone) и нет красных строк от mic_boosting.

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

При первом запуске ресурс создаёт таблицы mic_boosting_* в той базе данных, на которую указывает oxmysql, и наполняет их значениями по умолчанию: шесть классов, пул машин для каждого, 28 точек подбора по четыре охранника, 11 точек сдачи, шесть наборов охраны, мини-игры, магазин инструментов, задания, вехи, достижения и перки.

Файл mic_boosting.sql лежит в корне ресурса для тех, кто предпочитает создать схему вручную. Вам он не нужен.

Всё сработало, если при первом запуске в консоли выводится ряд строк [mic_boosting seeder], а при последующих — нет.

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

Обязателен только один предмет — mic_boosting_tablet, с помощью которого игроки открывают планшет. Шесть предметов-инструментов продаются во вкладке «Инструменты» планшета, и регистрировать их нужно, только если вы хотите, чтобы они работали.

Предмет	Что делает
`mic_boosting_tablet`	Открывает планшет. Обязателен в режиме `item`
`mic_gps_tracker`	Точное местоположение машины следующего контракта
`mic_signal_booster`	Круг поиска для следующего контракта становится меньше
`mic_police_scanner`	Откладывает оповещение полиции в следующем контракте
`mic_radar_jammer`	Более долгая задержка оповещения полиции
`mic_emp_jammer`	Один раз пропускает мини-игру со вскрытием замка
`mic_fake_plates`	Сбрасывает ваш heat до 0 в момент покупки

Готовые определения лежат в папке items/ — выберите файл для вашего инвентаря и перенесите его записи:

Файл	Для чего
`items/ox_inventory.lua`	ox_inventory — добавляется в `ox_inventory/data/items.lua`
`items/qbcore_items.lua`	QBCore — добавляется в `qb-core/shared/items.lua`
`items/esx_items.lua`	Собственный инвентарь ESX — строки для вашей таблицы `items`

Семь изображений лежат в items/images/. Скопируйте их в папку изображений вашего инвентаря (ox_inventory/web/images/ или qb-inventory/html/images/).

5. Фреймворк и бридж

Config.Framework в config.lua по умолчанию равен 'auto': скрипт ищет qb-core, затем es_extended, а иначе работает как standalone. Задавайте 'qbcore', 'esx' или 'standalone' принудительно, только если определение выбрало не тот фреймворк.

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

Если ваш ресурс таргета не ox_target, установите Config.InteractionSystem в 'qb_target' или 'drawtext' (простая подсказка E, ресурс таргета не нужен).

6. Выдайте себе права администратора

Админ-панель открывается командой /boostingconfig. Вы администратор, если верно любое из условий:

у вас есть ACE, указанный в Config.AdminAce (по умолчанию command — у администраторов txAdmin он обычно есть через group.admin);
ваша группа указана в Config.AdminGroups (admin, superadmin, god) — группа ESX или разрешение QBCore.

На standalone-сервере единственный путь — ACE: выдайте group.admin ACE command и добавьте себя в group.admin в server.cfg.

Всё сработало, если /boostingconfig открывает панель на вкладке Locations со списком из 28 точек.

7. Первый контракт

Выдайте себе mic_boosting_tablet и lockpick и используйте планшет.
Во вкладке Classes админ-панели установите Min Police Online для класса D равным 0 на время теста. Каждый класс по умолчанию требует 2 полицейских онлайн, поэтому на пустом тестовом сервере вместо контракта вы получите Not enough police online (0/2).
На вкладке «Главная» планшета встаньте в очередь класса D и примите пришедший контракт.

Всё сработало, если машина отмечена на карте, на ней появляется подсказка вскрытия, мини-игра запускается, а после доставки в точке сдачи в профиль добавляются MB и опыт.

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

Верните Min Police Online для каждого класса, который вы меняли во время тестирования.
Проверьте Config.PoliceJobs — в списке должны быть названия ваших полицейских работ, чтобы подсчёт минимума полиции их видел.
Оставьте Config.ForceDropoffId и Config.ForceLocationId равными nil. Они привязывают все контракты к одной точке и нужны только для тестов.
Подключите ваш диспетчер. Оповещение полиции по умолчанию — это уведомление и метка; чтобы использовать cd_dispatch, ps-dispatch или другой, отредактируйте Bridge.PoliceDispatch в bridge/client_bridge.lua.
Убедитесь, что lockpick и advancedlockpick можно где-то получить в вашем городе.