Установка

Десять минут, большая часть которых уходит на вставку определений предметов. У ресурса нет собственных таблиц и нет сопутствующего ресурса: модели вейпов стримятся из его собственной папки stream/.

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

Что нужно	Зачем
ESX (`es_extended`), QBCore (`qb-core`) или QBox (`qbx_core`), запущенный	Определяется автоматически; настройки фреймворка нет
Доступ к списку предметов вашего инвентаря	Вейпы — это предметы
Доступ к папке с картинками вашего инвентаря	Чтобы у каждого вейпа была своя иконка

1. Поместите папку на место

Положите mic_vape в ваши ресурсы, например в resources/[mic]/. Название папки не меняйте: индикатор выполнения обращается к ресурсу по его собственному имени.

Десять моделей вейпов и их def_props.ytyp лежат в stream/ и загружаются через манифест; переносить их не нужно.

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

В server.cfg поставьте ensure mic_vape ниже es_extended, qb-core или qbx_core и ниже вашего инвентаря. QBox определяется через совместимость с QBCore — qbx_core предоставляет qb-core, — так что ничего настраивать не нужно.

Здесь это важнее, чем обычно: mic_vape ищет запущенный фреймворк в момент собственного запуска. Если он запустится первым, то ничего не найдёт, не зарегистрирует ни одного предмета и ничего об этом не сообщит.

Всё сработало, если mic_vape запускается без красных строк под ним.

3. База данных

Для ресурса ничего не нужно. На ESX со стандартным инвентарём предметы-вейпы добавляются в таблицу items — это следующий шаг.

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

Каждый ключ в Config.Vapes (в config.lua) — это название предмета, и каждый регистрируется как используемый. Полный список с описанием действия каждого — на странице 🎒 Предметы. Кратко:

Группа	Предметы
Обычный	`vape`
Вейпы со способностями	`invisibility_vape`, `speed_vape`, `superjump_vape`, `teleport_vape`, `invincibility_vape`, `health_vape`, `armor_vape`, `carspeed_vape`, `random_vape`
Вкусы	`vape_watermelon`, `vape_mango`, `vape_blueberry` … всего сорок, каждый называется `vape_<flavour>`

Где лежат готовые определения — в папке inventory_items/ ресурса:

Файл	Для чего	Что делать
`esx_sql_items.sql`	ESX со стандартным инвентарём	Импортируйте один раз в вашу базу данных
`ox_inventory_items.md`	ox_inventory	Вставьте его строки в `ox_inventory/data/items.lua`
`qb_items.md`	QBCore	Вставьте его строки в `qb-core/shared/items.lua`

Картинки: иконки лежат в inventory_images/, по одному PNG на предмет с его названием. Скопируйте их в папку с картинками вашего инвентаря — ox_inventory/web/images/ или qb-inventory/html/images/. У трёх предметов из списков выше иконки нет (transform_vape, freeze_vape, gravity_vape), как и у vape_grape; если используете его, сделайте для него собственную.

Всё сработало, если вы можете выдать себе vape_watermelon, и он отображается в инвентаре со своей картинкой.

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

Выдайте себе vape и используйте его из инвентаря.

Всё сработало, если в руке персонажа появился чёрный вейп. Нажмите E: персонаж поднимет его, а через мгновение выйдет белый дым. Используйте предмет ещё раз или введите /vape, и он будет убран.

Затем попробуйте speed_vape: после затяжки вы пятнадцать секунд заметно быстрее бегаете.

Перед открытием города

mic_vape запускается после вашего фреймворка в server.cfg.
Стресс: Config.Stress включён, и «из коробки» он лишь выводит строку в консоль сервера при каждой затяжке. Либо поместите свою логику стресса в bridge/server_bridge.lua, либо задайте Config.Stress = false. См. Настройка.
Уведомления по умолчанию выключены (Config.ShowNotifications = false). Включите их, если хотите, чтобы игроки видели «кулдаун», «вейп пуст» и сообщения о способностях.
Решите, что делать со способностями. Невидимость, неуязвимость и телепорт — сильные. Назначьте им цену, магазин или работу, прежде чем они появятся в чьих-либо карманах.