Как ховерборд в FiveM работает без скрипта

Есть два способа добавить ховерборд на сервер. Первый: скрипт, который прикрепляет проп доски к игроку и перемещает его. Второй: обычный аддон-транспорт в виде доски. На этой странице описан второй вариант.

	Ховерборд как транспорт	Ховерборд как скрипт
Что летает	Транспорт, с собственной физикой полёта игры	То, что скрипт перемещает каждый кадр
Его видят другие игроки	Через обычную синхронизацию транспорта в игре	Зависит от того, как синхронизирует скрипт
Код, работающий во время езды	Никакого	Скрипт
Как встать и сойти	Действие посадки в транспорт и выхода из него, с анимациями из layout транспорта	Команда или клавиша, которую обрабатывает скрипт
Настройка скорости	handling.meta	Конфиг скрипта
Гаражи, ключи, магазины	Работает как любая другая модель транспорта	Нужна своя интеграция

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

Поведение	Откуда берётся	Гайд
Он существует и его можно заспавнить	Запись в vehicles.meta	Разбор vehicles.meta
Он парит и летает	Запись handling, включая её блок особого режима полёта	Разбор handling.meta
Райдер стоит на деке	Собственный layout транспорта со своей анимацией сиденья	Разбор vehiclelayouts.meta
Можно встать на доску слева или справа	Точки входа и клипы входа в том же layout
Струи двигателей под доской	Данные эффектов транспорта, привязанные к костям модели
Он становится легче с расстоянием	Меши LOD внутри модели	Оптимизация транспорта FiveM

Поскольку у layout своё имя, позу стоя использует только доска. Остальные мотоциклы на сервере сохраняют свои обычные анимации.

Одна деталь из опыта их создания: файл эффектов нужно объявить в манифесте раньше vehicles.meta, потому что запись транспорта ищет свои эффекты по имени в момент загрузки. О порядке загрузки рассказано в гайде о fxmanifest.lua и data_file для транспорта.

Доска	Внешний вид	Имя для спавна
Airglider	Классическая розовая доска Dinka.	airglider
Girlboard	Более длинная доска 1.43 м с вращающейся турбиной и зелёным неоном.	girlboard
Neonboard	Тонкая дека с неоном по всей доске.	neonboard

У всех трёх одинаковые возможности: своя анимация езды стоя с ногами на деке, посадка и выход с обеих сторон, фиолетовый эффект двигателей с собственным звуком и четыре LOD от High до Very Low. Каждая продаётся отдельно как самостоятельный ресурс, а все три вместе составляют Hoverboard Pack.

1. После покупки скачайте ресурс из Granted Assets в Cfx.re Portal. Шаги описаны в гайде об установке ресурса FiveM из Cfx.re Escrow.
2. Положите папку в папку resources сервера, не переименовывая её.
3. Добавьте ensure в server.cfg. Для одной доски это одна строка. С паком первым запускайте airglider:

   ensure airglider
   ensure neonboard
   ensure girlboard

4. Перезапустите сервер и заспавните доску по имени своей командой спавна транспорта.

В досках нет кода под фреймворки, поэтому установка одинакова на ESX, QBCore, QBox и на standalone-сервере. Чтобы продавать доску в автосалоне, добавьте её имя для спавна в список транспорта вашего фреймворка: см. гайд о добавлении своего транспорта в ESX, QBCore или QBox.

Доски используют handling от Oppressor Mk II, поэтому управляются как этот транспорт: парят, набирают высоту и планируют, а ракетное ускорение сохранено. Оружие убрано. Поскольку полёт задаётся файлом handling, он ведёт себя одинаково у всех игроков и не требует ничего работающего в фоне.