Установка

Установка занимает пять минут, большая часть которых уходит на добавление предметов в инвентарь.

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

Что нужно	Зачем
Запущенный ESX, QBCore или QBox	Четыре используемых предмета регистрируются через ваш фреймворк
Инвентарь, в который можно добавить пять новых предметов	Подойдут ox_inventory, qb-inventory или стандартный инвентарь ESX

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

Переместите mic_carbomb в папку ваших ресурсов, например в resources/[mic]/. Дополнительного ресурса с пропами для него не требуется.

2. Запустите его после фреймворка

В server.cfg пропишите ensure mic_carbomb ниже вашего фреймворка (es_extended, qb-core или qbx_core) и инвентаря.

Всё сработало, если при запуске в консоли сервера нет красных строк от mic_carbomb. Строка, которую вы точно не хотите увидеть: “Invalid framework specified in config.lua. Use ‘esx’ or ‘qbcore’.”

3. База данных — ничего лишнего

mic_carbomb хранит заложенные бомбы в оперативной памяти сервера, а не в базе данных. Единственный шаг с базой данных — это добавление предметов для ESX в шаге 4, и только если вы используете стандартный инвентарь ESX.

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

Предмет	Что он делает
`car_bomb`	Используйте, чтобы взять бомбу в руки, затем нажмите E рядом с автомобилем для установки
`phone_detonator`	Открывает телефон-детонатор: список ваших бомб, мгновенный подрыв или таймер
`bomb_detector`	Достаёт сканер; используйте предмет снова, чтобы убрать его
`bomb_defuser`	Достаёт ящик с инструментами; нажмите E рядом с заминированным авто для обезвреживания
`defused_bomb`	Неиспользуемый предмет. Выдаётся после разминирования, если включён `Config.ReturnDefusedBomb`

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

Инвентарь	Определения (`mic_carbomb/inventory_items/`)	Куда добавить	Иконки
ox_inventory	`ox_inventory.md`	`ox_inventory/data/items.lua`	Скопируйте `inventory_images/*.png` в `ox_inventory/web/images/`
QBCore / qb-inventory	`qb_inventory.md`	`qb-core/shared/items.lua`	Скопируйте их в `qb-inventory/html/images/`
Стандартный инвентарь ESX	`esx_sql_items.md`	Выполните SQL-запрос из файла один раз в вашей БД	—

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

5. Укажите ваш фреймворк

Откройте config.lua и установите Config.Framework в значение esx (по умолчанию) или qbcore. Автоопределения здесь нет. На QBox выбирайте qbcore: QBox запускает ресурсы QBCore через свой слой совместимости.

Заодно обратите внимание: Config.WebhookEnabled по умолчанию включён с тестовым URL-заглушкой. Либо вставьте ссылку на ваш Discord webhook в Config.WebhookURL, либо установите WebhookEnabled в false.

6. Первая проверка

Заспавните автомобиль и выйдите из него.
Используйте car_bomb. В вашей руке появится бомба. Подойдите к машине (ближе чем на 2 м) и нажмите E. Проиграется двухсекундная анимация установки, и бомба исчезнет из руки.
Используйте bomb_detector и посмотрите на машину. Детектор запищит, а на автомобиле появится красная метка (блип).
Снова используйте bomb_detector, чтобы убрать его. Отойдите подальше от машины, но держите её в зоне видимости — детонатор может взорвать только тот транспорт, который прогружен вокруг вас.
Используйте phone_detonator. На экране телефона отобразятся модель и номер автомобиля. Нажмите зелёную кнопку.

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

Чтобы проверить обезвреживание, заложите вторую бомбу, используйте bomb_defuser, встаньте рядом с машиной и нажмите E. Всё сработало, если анимация ремонта завершается, писк прекращается, а к вам в инвентарь возвращается car_bomb.

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

Config.Framework соответствует вашему реальному фреймворку (qbcore на QBox).
QBCore: поле name у каждого предмета совпадает с его ключом.
Webhook содержит настоящую ссылку или отключён.
Файл config.lua передаётся каждому игроку (это shared-скрипт). Любой, кто заглянет в файлы клиента, сможет прочитать URL вебхука. Используйте вебхук для канала, который не жалко в случае спама, либо отключите его.
Решите, должны ли тратиться предметы. По умолчанию установка не забирает бомбу из инвентаря (Config.RemoveItem выключен), поэтому с одной car_bomb игрок может заминировать сколько угодно машин.