Установка

Пятнадцать минут. Две папки, несколько настроек и предметы. В базе данных ничего не хранится, поэтому для самого ресурса ничего импортировать не нужно.

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

Что нужно	Зачем
Запущенный ESX, QBCore или QBox	Через него проходят предметы, владельцы и работы
Запущенный ox_target или qb-target	Все взаимодействия с поставленным кальяном или стулом
Обе папки из вашей покупки: `mic_hookah` и `mic_hookah_prop`	Скрипт и модели кальянов
Доступ к списку предметов и папке изображений вашего инвентаря	Кальяны, мебель, расходники и ароматы — это предметы

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

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

В mic_hookah_prop находятся десять моделей кальянов (mic_hookah_black … mic_hookah_yellow) и их mic_hookah.ytyp. Кода там нет; он только стримит. Столы и стулья — модели из базовой игры, им ничего дополнительного не нужно.

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

В server.cfg, ниже вашего фреймворка, инвентаря и ресурса таргета, добавьте ensure mic_hookah_prop, а затем ensure mic_hookah.

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

3. Фреймворк и таргет

Откройте config.lua:

Параметр	Установите	По умолчанию
`Config.Framework`	`esx`, `qbcore` или `qbox`	`esx`
`Config.Target`	`ox_target` или `qb-target`	`ox_target`
`Config.ESXResourceName`	Название папки ESX, если вы её переименовали	`es_extended`
`Config.QBResourceName`	Название папки QBCore, если вы её переименовали	`qb-core`
`Config.QBoxResourceName`	Название папки QBox, если вы её переименовали	`qbx_core`
`Config.QBTargetResourceName`	Название папки qb-target, если вы её переименовали	`qb-target`

Здесь ничего не определяется автоматически: эти значения решают, какие фреймворк и таргет используются.

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

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

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

Полный список находится на странице 🎒 Предметы. Вкратце:

Предмет	Что делает
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Используйте, чтобы взять и поставить этот кальян
`hookah_table` … `hookah_table5`	Используйте, чтобы поставить стол
`hookah_chair` … `hookah_chair6`	Используйте, чтобы поставить стул, на который можно сесть
`hookah_coal`	Заполняет уголь из меню настройки
`hookah_water`	Заполняет воду из меню настройки
`hookah_<flavour>_flavor`	Шестьдесят ароматов, выбираются в меню настройки

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

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

Картинки: иконки лежат в inventory_images/, по одному PNG на предмет с его названием. Скопируйте их в папку изображений вашего инвентаря — ox_inventory/web/images/ или qb-inventory/html/images/.

Затем укажите в Config.InventoryImagePath эту же папку, чтобы иконки ароматов отображались в меню настройки. По умолчанию стоит nui://ox_inventory/web/images/; для qb-inventory используйте nui://qb-inventory/html/images/.

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

6. Первый тест

Выдайте себе hookah_red, hookah_coal, hookah_water и hookah_mint_flavor.

Используйте hookah_red. Ваш персонаж держит кальян на подносе. Нажмите E.
Превью следует за вашим прицелом. Поворачивайте его колёсиком мыши, поднимайте и опускайте стрелками и нажмите E, чтобы поставить.
Наведите таргет на кальян и выберите Open Setup Menu. Добавьте уголь, добавьте воду, выберите Mint, затем Light Hookah.
Закройте меню, снова наведите таргет на кальян и выберите Grab Hose. Нажмите E.

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

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

Решите, кто может управлять кальянами. Config.AdminGroups по умолчанию равен false, и это позволяет каждому игроку открывать меню любого кальяна или предмета мебели и забирать их. Укажите ваши админские группы, чтобы ограничить это владельцем и персоналом. См. Настройка.
Config.InventoryImagePath указывает на папку изображений, которой вы действительно пользуетесь.
Стресс: Config.Stress включён, но ReduceStress в server_functions.lua пуст, пока вы не добавите в него свой вызов.
Предупредите игроков, что кальяны и мебель не сохраняются: они очищаются при перезапуске ресурса или сервера.