Установка

Пять минут. Одна папка, один предмет, одна строка в config.lua.

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

Что нужно	Зачем
Запущенный ESX, QBCore или QBox	Предмет-верёвка регистрируется через ваш фреймворк
Инвентарь, способный хранить предмет `rope`	Подойдут ox_inventory, qb-inventory и стандартный инвентарь ESX
ox_target или qb-target (по желанию)	Только если вам нужно меню таргета вместо 3D-текста

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

Переместите mic_drag в папку ваших ресурсов, например внутри resources/[mic]/. Сохраните папку stream/, которая идёт в комплекте: в ней находятся проп верёвки (prop_stag_do_rope) и его текстура, и без неё верёвка никогда не появится в руке игрока.

2. Запустите после фреймворка

В server.cfg поставьте ensure mic_drag ниже вашего фреймворка (es_extended, qb-core или qbx_core) и ниже вашего инвентаря. Если вы используете таргет, запустите его тоже раньше mic_drag — хотя верёвка подхватит таргет сама, если он запустится позже.

Всё сработало, если при запуске в консоли сервера нет красных строк от mic_drag. Та, которую видеть не нужно, — «Config.Framework must be esx or qbcore».

3. База данных — собственной нет

mic_drag ничего не хранит. Единственный шаг с базой данных — строка предмета ESX на шаге 4, и только если вы используете стандартный инвентарь ESX.

4. Добавьте предмет-верёвку

Название предмета — rope (задаётся в Config.Item).

Предмет	Что делает
`rope`	Используйте, чтобы взять верёвку в руку или убрать. Должен быть в инвентаре, чтобы начать буксировку. Никогда не расходуется

Готовые определения лежат в папке ресурса inventory/:

Инвентарь	Файл в `mic_drag/inventory/`	Куда добавить
ox_inventory	`ox_inventory.md`	Добавьте запись в `ox_inventory/data/items.lua`
QBCore / qb-inventory	`qb_inventory.md`	Добавьте запись в `qb-core/shared/items.lua`
Стандартный инвентарь ESX	`esx_inventory.sql`	Импортируйте один раз в вашу базу данных

Картинка предмета вместе с ресурсом не поставляется. Если в вашем инвентаре пустая иконка, положите любой rope.png в папку изображений вашего инвентаря (ox_inventory/web/images/ или qb-inventory/html/images/).

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

5. Укажите ваш фреймворк и взаимодействие

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

Config.Framework — esx (по умолчанию) или qbcore. Автоопределения нет; значение должно совпадать. На QBox выберите qbcore: QBox запускает ресурсы QBCore через слой совместимости.
Config.InteractionSystem — ox_target (по умолчанию), qb-target или drawtext.

Если вы выберете незапущенный таргет, в клиентской консоли (F8) появится «ox_target is not started; using drawtext until it starts», а верёвка тем временем будет работать с 3D-текстом.

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

Для этого понадобится второй игрок — верёвка хватает только игроков.

Используйте предмет rope. Верёвка появится в вашей правой руке.
Подойдите к другому игроку (в пределах 2 м). С таргетом посмотрите на него и выберите Drag with rope. С drawtext нажмите E, когда появится подсказка.
Отойдите. Он последует за вами на канате. Удерживайте стрелку вверх / стрелку вниз, чтобы изменить длину.
Встаньте рядом с машиной и выберите Tie to vehicle (или нажмите Y в режиме drawtext). Поезжайте.

Всё сработало, если другой игрок болтается в рэгдолле на конце видимой верёвки, а при привязывании верёвка перемещается из вашей руки к задней части автомобиля.

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

Config.Framework совпадает с фреймворком, который вы действительно используете (qbcore на QBox).
QBCore: name предмета — rope, в нижнем регистре.
Подписи в Config.Labels написаны на языке вашего сервера — это единственный текст, который видят игроки.
Config.KeyLabels по-прежнему соответствует клавишам, если вы меняли Config.AttachKey или Config.AttachToVehicleKey.
Решите, что делать с Config.EnableMaxDragTime. Если выключено, верёвка держится, пока кто-нибудь её не отпустит.