Решение проблем

Проблемы, с которыми люди действительно сталкиваются при работе с этим ресурсом, и что они означают.

Изменение в ресурсе ничего не дало

restart не перечитывает fxmanifest.lua. Если вы добавили файл — новую локаль, новую модель в mic_hookah_prop, — сначала выполните refresh в консоли сервера, а затем перезапустите ресурс. Для изменений в config.lua достаточно перезапуска.

Ошибки про фреймворк сразу при запуске

Config.Framework и параметры названий ресурсов должны соответствовать тому, что вы используете: esx с Config.ESXResourceName, qbcore с Config.QBResourceName, qbox с Config.QBoxResourceName. Ничего не определяется автоматически. Также проверьте, что mic_hookah запускается после вашего фреймворка в server.cfg.

Использование предмета-кальяна ничего не делает

Названия предмета нет в Config.HookahItems (или в Config.PlaceableProps для мебели).
Предмета нет в вашем инвентаре, или на ESX со стандартным инвентарём его нет в таблице items. Добавьте его из inventory_items/.
Config.Framework указан неверно, поэтому предмет был зарегистрирован через не тот фреймворк.

Кальян невидим, или при переноске и размещении ничего не показывается

mic_hookah_prop не запущен. Он стримит все десять моделей кальянов; запустите его в server.cfg раньше mic_hookah. Столы и стулья — модели из базовой игры, так что если мебель видна, а кальяны нет, причина всегда в этом.

На кальяне нет опций таргета

Config.Target не совпадает с вашим ресурсом таргета. Он должен быть ox_target или qb-target. Для переименованного qb-target укажите Config.QBTargetResourceName.
Ресурс таргета запускается после mic_hookah. Переместите его выше.
Опции появляются через мгновение после входа. Они добавляются, когда данные игрока загружены; после перезапуска mic_hookah подождите секунду-две.

Эти две опции показываются только игроку, поставившему этот кальян, или админу. Если вы задали в Config.AdminGroups список, все остальные видят только Grab Hose. Меню также проверяет Config.AllowedJobs, если вы его задали.

Любой может открыть или забрать чужой кальян

Config.AdminGroups по умолчанию равен false, а false делает админом каждого игрока. Укажите в нём группы вашего персонала. См. Настройка.

«Cannot turn on: missing charcoal, water, or flavor.»

Для Light Hookah нужны все три: добавьте уголь (hookah_coal), добавьте воду (hookah_water) и задайте аромат, затем разжигайте.

«Cannot use hose: Hookah is not turned on.»

Сначала откройте меню настройки и нажмите Light Hookah.

Если он горел мгновение назад, значит, закончились запасы. Каждая затяжка тратит немного угля и воды, и когда что-то одно доходит до нуля, кальян гаснет сам. Меню настройки показывает, что именно на 0 %: добавьте это и снова разожгите кальян.

«Cannot smoke: check charcoal, water, or flavor.»

Кальян зажжён, но чего-то не хватает. Откройте меню настройки и проверьте уголь, воду и текущий аромат.

Список ароматов пуст

Меню перечисляет только те ароматы, которые есть у игрока. Выдайте себе предмет-аромат, например hookah_mint_flavor, и снова откройте меню.

Иконки ароматов в меню не отображаются

Config.InventoryImagePath не указывает на папку изображений вашего инвентаря, или иконки не были туда скопированы. Для ox_inventory это nui://ox_inventory/web/images/; для qb-inventory — nui://qb-inventory/html/images/.

Шланг рвётся

Игрок отошёл от кальяна дальше, чем на Config.MaxHoseDistance (3.5 метра). Увеличьте число, если вашим лаунджам нужно больше места.

Кальяны и мебель пропадают после перезапуска

Так всё устроено: в базу данных ничего не сохраняется. Поставленные кальяны и мебель живут в памяти сервера и очищаются, когда mic_hookah останавливается или сервер перезапускается.

Перезапуск ресурса убрал стулья или столы, которые были частью карты

Когда mic_hookah останавливается, игра каждого игрока удаляет все объекты вокруг него, чья модель указана в Config.HookahItems или Config.PlaceableProps. Поставляемая мебель использует модели из базовой игры, поэтому подходящий стол или стул, принадлежащий интерьеру рядом с игроком, тоже может исчезнуть, пока тот не перезагрузит область. Перезапускайте ресурс, когда в городе тихо, или выбирайте модели мебели, которые ваша карта не использует.

Стресс не снижается

Config.Stress лишь вызывает ReduceStress в server_functions.lua, а эта функция пуста, пока вы не добавите в неё вызов вашего ресурса стресса.

«Locale [jp] does not exist»

В комментарии конфига указан jp, но японского файла в комплекте нет. Используйте один из одиннадцати в locales/ или добавьте свой.

«You are already placing an object.»

Размещение уже идёт. Завершите его по E или отмените по X, затем используйте следующий предмет.