Предмет — это список функций, которые выполняются сверху вниз, когда игрок использует предмет, и набор ограничений, проверяемых до запуска любой из них.
- Игрок использует предмет из инвентаря.
- На сервере проверяются ограничения кулдауна, требуемого предмета и работы. Если одно не выполнено, игроку сообщают причину, и ничего не происходит.
- Выполняются серверные функции (Bundle).
- Клиентские функции выполняются в том порядке, в котором вы их перечислили. У каждой может быть задержка в миллисекундах, которую ждут перед запуском, — так строится последовательность: анимация, затем через 3 секунды уведомление, затем проп.
- Если включён Remove on Use, забирается указанное количество предметов.
Длящиеся функции — анимации, сценарии, стили ходьбы, скорость, суперспособности, прикреплённые пропы — игрок может остановить клавишей отмены (по умолчанию X).
| Функция | Что делает |
|---|
| Animation | Проигрывает анимацию из словаря. Loop работает до отмены; иначе повторяется заданное время. Movable оставляет ноги свободными (только верхняя часть тела); static проигрывает анимацию всем телом. В транспорте не проигрывается |
| Scenario | Запускает сценарий GTA на месте на заданное время |
| Walking Style | Меняет походку игрока на заданное время (15 секунд, если оставить пустым) |
| Speed | Ускоряет (или замедляет) движение игрока на множитель, на заданное время или до отмены |
| Superpower | Любое из: Teleport (на метку карты), Invisibility, Invincibility, Superjump и Stamina (бесконечный бег), у каждого своя длительность |
| Clothes | Надевает предметы одежды и аксессуары, отдельно для мужской и женской моделей freemode, с соответствующей анимацией надевания из data/clothing.lua |
| Функция | Что делает |
|---|
| Attach Prop | Прикрепляет объект к кости игрока, позиционируется в редакторе в реальном времени. Его видят все вокруг. Loop держит его до отмены; иначе он убирается по истечении времени. В транспорте не используется |
| Placeable Prop | Игрок ставит объект в мир: превью следует за взглядом, колёсико мыши поворачивает, ↑ / ↓ поднимает и опускает, E ставит, X отменяет. Поставленный объект можно снова поднять — см. ниже |
| Particles | Эффект частиц на игроке, по названию ассета и эффекта, с масштабом и длительностью |
| Visual Effect | Полноэкранный эффект на заданное время |
| Sound | Звук GTA, по названию и набору звуков, с заданной громкостью |
| Функция | Что делает |
|---|
| Health/Armor | Добавляет здоровье и броню, не выше максимума |
| Food/Thirst | Добавляет голод и жажду через esx_status на ESX или события consumables на QBCore |
| Stress | Добавляет стресс или снимает его, если указать отрицательное число |
| Функция | Что делает |
|---|
| Notification | Уведомление через ваш фреймворк с типом (по умолчанию success) |
| Progress Bar | Индикатор прогресса с подписью на заданное время: встроенный или ox_lib, согласно Config.ProgressBar |
| Webhook | Отправляет в Discord webhook ваше сообщение, идентификаторы игрока и, по желанию, скриншот (нужен screenshot-basic). Принимаются только URL Discord webhook |
| Функция | Что делает |
|---|
| Command | Выполняет команду от имени игрока. Начальный / допустим |
| Trigger | Вызывает клиентское событие, серверное событие или экспорт, записанный как resourceName:exportName. Каждый получает название предмета |
| Car | Создаёт модель транспорта там, где стоит игрок, лицом по его направлению, и по желанию сажает его на место водителя |
| Bundle | Выдаёт несколько предметов сразу — упаковку из шести бутылок пива, аптечку. Выполняется на сервере. Сочетайте с Remove on Use, чтобы сама коробка расходовалась; набор никогда не выдаёт предмет, которому он принадлежит |
Когда игрок ставит Placeable Prop, объект создаётся для всех. Игрок, поставивший его, может поднять его обратно — с помощью 3D-текста и E или через ox_target / qb-target, если так указано в Config.Interaction. Подбор возвращает столько предметов, сколько забрал Remove on Use, так что поставленный конус возвращается в тот карман, откуда был взят.
Они находятся в настройках предмета. У каждого есть собственный переключатель.
| Ограничение | Что делает |
|---|
| Cooldown | Время, которое игрок должен ждать между использованиями этого предмета, в миллисекундах (60000 — одна минута). Запоминается до перезапуска сервера |
| Job Restriction | Использовать могут только игроки с одной из перечисленных работ и рангом не ниже минимального для этой работы |
| Required Item | Игрок должен иметь при себе столько-то другого предмета — например, зажигалку для сигареты |
| Remove on Use | Сколько предметов забирается при каждом использовании |
| Always Attached Prop | Пока предмет в инвентаре, Attach Prop предмета остаётся на игроке; он исчезает, когда уходит последний. Этот проп видит только тот игрок, у которого предмет |
- Save сохраняет предмет в таблице
mic_itemcreator и сразу делает его используемым для всех.
- Меню может выдать вам предмет, по одному, чтобы протестировать его.
- Delete удаляет конфигурацию: после этого использование предмета ничего не делает. Фреймворк сохраняет регистрацию предмета как используемого до следующего перезапуска, это безвредно.
