Agency-Seatbelt V2 Экспорты & API
Автономный ремень безопасности для FiveM, полностью переписан к версии 2.0.0.
01Клиентские экспорты
| Экспорт | Описание |
|---|---|
isSeatbeltOn() | Возвращает true, пока ремень локального игрока пристёгнут, неважно, пристегнулся он сам или это сделала машина. |
enableSeatbelt() | Пристёгивает ремень локального игрока с обычным звуком и откликом. |
disableSeatbelt() | Отстёгивает ремень локального игрока с обычным звуком и откликом. |
toggleSeatbelt() | Переключает ремень локального игрока. Возвращает true, если состояние действительно изменилось, а не новое состояние, чтобы отличить отклонённое переключение (нет машины или нет ремня на этом месте) от успешного. |
isAutoBuckled() | Возвращает true, пока ремень пристегнула машина, а не игрок. |
autoBuckle(on: boolean) | Пристёгивает или отстёгивает ремень как автоматический, так же как беспилотная машина. |
getSeatbeltState() | Возвращает таблицу: пристёгнут ли ремень, автоматический ли он, место и машина. |
setSeatbeltEnabled(on: boolean) | Полностью отключает или включает ремень для этого игрока, для катсцен или админ-ситуаций. |
isPlayerSeatbeltOn(serverId: number) | Возвращает состояние ремня другого игрока, считанное из реплицируемого state bag. |
bucklesItselfVehicle(vehicle: number) | Сообщает, пристёгивает ли эта машина пассажиров сама, по списку моделей или state bag agAuto. |
openSettings() | Открывает карточку настроек. |
closeSettings() | Закрывает карточку настроек. |
isSettingsOpen() | Сообщает, открыта ли карточка настроек. |
02Серверные экспорты
| Экспорт | Описание |
|---|---|
isSeatbeltOn(source: number) | Возвращает на сервере состояние ремня игрока, считанное из реплицируемого state bag. |
getBuckledPlayers() | Возвращает серверные id всех игроков, которые сейчас пристёгнуты. |
setSeatbelt(source: number, on: boolean) | Пристёгивает или отстёгивает ремень игрока с сервера. |
03События
| Название | Сторона | Описание |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Клиент | Срабатывает при каждом изменении с новым состоянием. Его слушает Agency-HUD, и любой другой ресурс тоже может. |
+Полезно знать
На этой странице перечислены доступные exports, предоставляемые Agency-Seatbelt для использования в других ресурсах. Разработчики могут использовать эти клиентские exports для управления или запроса состояния ремня безопасности локального игрока. Серверные exports не предоставляются. Убедитесь, что Agency-Seatbelt запущен до любого ресурса, использующего его exports, чтобы избежать ошибок во время выполнения или неопределенного поведения.
- Только клиентские exports
- Agency-Seatbelt предоставляет четыре exports, все они клиентские. Они позволяют скриптам включать, отключать, переключать или проверять состояние ремня безопасности локального игрока. Серверных exports или событий этим ресурсом не предоставляется.
- Использование в других ресурсах
- Для использования этих exports убедитесь, что Agency-Seatbelt запущен до любого зависимого ресурса. Вызывайте exports напрямую из ваших клиентских скриптов для интеграции функционала ремня безопасности или проверки состояния HUD по мере необходимости.
- Без зависимостей и SQL
- Agency-Seatbelt не требует внешних зависимостей или настройки SQL. Все функции, включая экспортные функции, доступны сразу после запуска ресурса.
?Частые вопросы
Есть ли серверные exports для Agency-Seatbelt?
Нет, Agency-Seatbelt предоставляет только клиентские экспорты. Серверных экспортов или событий не предусмотрено. Взаимодействие с состоянием ремня безопасности должно выполняться из клиентских скриптов с использованием доступных экспортов.
Что произойдет, если я вызову экспорт до запуска Agency-Seatbelt?
Если вы попытаетесь использовать экспорт до запуска Agency-Seatbelt, экспорт будет недоступен, и ваш скрипт может выдать ошибку или не работать должным образом. Всегда убедитесь, что Agency-Seatbelt запущен первым.
Нужно ли настраивать зависимости или импортировать SQL для использования этих экспортов?
Нет, Agency-Seatbelt не требует зависимостей или импорта SQL. Экспорты становятся доступны сразу после запуска ресурса, и дополнительная настройка не требуется.
Как проверить, пристегнут ли ремень безопасности у локального игрока из другого скрипта?
Вы можете использовать клиентский экспорт isSeatbeltOn() для проверки, пристегнут ли ремень безопасности у локального игрока. Вызовите этот экспорт из вашего клиентского скрипта, чтобы получить текущий статус ремня.