Установка

Пять минут. Никакого SQL-файла и настройки фреймворка — одно разрешение и перезапуск.

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

Что нужно	Зачем
ESX, QBCore или QBox	Используемые предметы, работы, уведомления и статусы берутся из фреймворка
oxmysql	Конфигурации предметов сохраняются в таблице `mic_itemcreator`
Инвентарь, запускающий используемые предметы фреймворка	Именно так использование предмета доходит до этого ресурса
ox_lib, ox_target / qb-target, screenshot-basic	Необязательно; см. Настройка

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

Скачайте mic_itemcreator из ваших Cfx.re granted assets и переместите папку в ресурсы, например resources/[mic]/mic_itemcreator.

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

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

Фреймворк определяется по запущенному es_extended или qb-core, поэтому порядок важен: если запустить слишком рано, ничего не найдётся. QBox определяется через слой совместимости с QBCore — qbx_core предоставляет qb-core — поэтому ничего настраивать не нужно.

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

При первом запуске ресурс создаёт таблицу mic_itemcreator (одна строка на каждый настроенный предмет) и добавляет все столбцы, которых не было в старой версии. SQL-файла для импорта нет.

Всё сработало, если после первого запуска таблица mic_itemcreator появилась в вашей базе данных.

4. Предметы

Item Creator не добавляет предметы в ваш инвентарь — он наделяет поведением те предметы, которые у вас уже есть. Каждый настраиваемый предмет сначала должен существовать в вашем инвентаре.

Определения предметов и картинки в комплект не входят. Для новых предметов Registry Tool в меню пишет определение за вас: выберите OX, QBCORE или ESX SQL, заполните поля и скопируйте результат в ox_inventory/data/items.lua, qb-core/shared/items.lua или в таблицу items вашего ESX. Картинки кладутся в собственную папку изображений вашего инвентаря и называются по названию предмета.

5. Выдайте себе доступ к меню

Меню закрыто ACE-разрешением mic_itemcreator.open. Выдайте его в server.cfg строкой add_ace — одному человеку, например add_ace identifier.discord:YOUR_DISCORD_ID mic_itemcreator.open allow, или группе, например add_ace group.admin mic_itemcreator.open allow.

Разрешение проверяется при входе на сервер. Выдали его, пока вы уже были подключены? Переподключитесь.

Всё сработало, если /itemcreator открывает меню на панели управления. Без разрешения вы получите уведомление об отсутствии прав.

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

/itemcreator → Usable Items, выберите предмет, который существует в вашем инвентаре, например water.
Добавьте функцию Notification с сообщением и функцию Food/Thirst с некоторым значением жажды.
Откройте настройки предмета, включите Remove on Use со значением 1 и сохраните.
Выдайте себе предмет (в меню для этого есть кнопка, по одному) и используйте его из инвентаря.

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

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

Разрешение mic_itemcreator.open есть только у нужных людей. С его помощью любой предмет можно наделить чем угодно, включая создание машин, выполнение команд и выдачу суперспособностей.
Каждый настроенный предмет существует в вашем инвентаре с тем же названием.
Проверьте, что Config.ImageInventoryPath указывает на папку изображений вашего инвентаря, иначе меню не покажет картинки.
Расскажите игрокам про клавишу отмены — по умолчанию X, — которая останавливает анимации, сценарии, стили ходьбы, скорость, суперспособности и пропы, запущенные предметом.