Установка

Две минуты. Выбирать фреймворк и что-либо импортировать не нужно.

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

Что нужно	Зачем
Сервер FiveM	Это всё — `mic_leafblower` автономен и работает на ESX, QBCore, QBox или вообще без фреймворка
Способ выдавать игрокам `WEAPON_RAYMINIGUN`	Воздуходувка — это и есть это оружие

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

Переместите mic_leafblower в папку ваших ресурсов, например внутрь resources/[mic]/. Не удаляйте её папку stream/: в ней лежит заменяющая модель Widowmaker (w_mg_sminigun).

2. Запустите

Добавьте ensure mic_leafblower в server.cfg. У ресурса нет зависимостей, поэтому порядок запуска не важен.

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

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

mic_leafblower ничего не хранит.

4. Оружие в вашем инвентаре

Нового предмета нет. Воздуходувка — это игровое оружие WEAPON_RAYMINIGUN, поэтому оно находится там же, где ваш инвентарь уже хранит оружие. Единственное, что вы, возможно, захотите изменить, — его название, чтобы игроки видели «Leaf Blower» вместо «Widowmaker»:

Инвентарь	Где находится подпись оружия
ox_inventory	`ox_inventory/data/weapons.lua`, запись `WEAPON_RAYMINIGUN`
ESX по умолчанию	`es_extended/shared/config/weapons.lua`, запись `WEAPON_RAYMINIGUN`
QBCore	`qb-core/shared/weapons.lua` и предмет `weapon_rayminigun` в `qb-core/shared/items.lua`

Меняйте только подпись — название оружия оставьте как есть. Ресурс ищет WEAPON_RAYMINIGUN, и это имя изменить нельзя.

Иконка в ресурс не входит; инвентарь продолжит показывать собственную картинку Widowmaker, пока вы сами не замените это изображение.

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

Выдайте себе WEAPON_RAYMINIGUN так, как ваш сервер обычно выдаёт оружие.
Достаньте его. В правой руке вместо оружия появится воздуходувка.
Создайте машину, встаньте в нескольких метрах и удерживайте правую кнопку мыши (прицеливание), целясь в неё.

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

Перед открытием сервера

Решите, кто получает Widowmaker. Любой, у кого он есть, может толкать игроков и машины.
Выберите силу. Config.Force по умолчанию равен medium; hard отбрасывает машины и игроков далеко.
Определитесь с уроном от падения. Config.FallDamage выключен: отброшенный игрок не получает урона, пока не встанет.
Переименуйте оружие в вашем инвентаре, чтобы игроки видели «Leaf Blower».