Agency-Seatbelt V2 Exports & API
Cinturón standalone para FiveM, reconstruido desde cero para la 2.0.0.
01Exports de cliente
| Export | Descripción |
|---|---|
isSeatbeltOn() | Devuelve true mientras el cinturón del jugador local está abrochado, tanto si se lo abrochó él como si lo hizo el coche. |
enableSeatbelt() | Abrocha el cinturón del jugador local con el sonido y el aviso habituales. |
disableSeatbelt() | Desabrocha el cinturón del jugador local con el sonido y el aviso habituales. |
toggleSeatbelt() | Cambia el cinturón del jugador local. Devuelve true cuando el estado cambió de verdad, no el nuevo estado, para distinguir un cambio rechazado (sin vehículo o sin cinturón en ese asiento) de uno que funcionó. |
isAutoBuckled() | Devuelve true mientras el cinturón lo abrochó el coche y no el jugador. |
autoBuckle(on: boolean) | Abrocha o desabrocha el cinturón como cinturón automático, igual que un coche autónomo. |
getSeatbeltState() | Devuelve una tabla con el estado del cinturón, si es automático, el asiento y el vehículo. |
setSeatbeltEnabled(on: boolean) | Desactiva o activa todo el cinturón para este jugador, para cinemáticas o situaciones de admin. |
isPlayerSeatbeltOn(serverId: number) | Devuelve el estado del cinturón de otro jugador, leído del state bag replicado. |
bucklesItselfVehicle(vehicle: number) | Indica si este vehículo abrocha él mismo a sus ocupantes, según la lista de modelos o el state bag agAuto. |
openSettings() | Abre la tarjeta de ajustes. |
closeSettings() | Cierra la tarjeta de ajustes. |
isSettingsOpen() | Indica si la tarjeta de ajustes está abierta. |
02Exports de servidor
| Export | Descripción |
|---|---|
isSeatbeltOn(source: number) | Devuelve en el servidor el estado del cinturón de un jugador, leído del state bag replicado. |
getBuckledPlayers() | Devuelve las ids de servidor de todos los jugadores que llevan el cinturón abrochado. |
setSeatbelt(source: number, on: boolean) | Abrocha o desabrocha desde el servidor el cinturón de un jugador. |
03Eventos
| Nombre | Lado | Descripción |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Cliente | Se dispara en cada cambio con el nuevo estado. Agency-HUD lo escucha; cualquier otro resource también puede. |
+Conviene saber
Esta página lista los exports disponibles proporcionados por Agency-Seatbelt para uso en otros recursos. Los desarrolladores pueden usar estos exports del lado cliente para controlar o consultar el estado del cinturón para el jugador local. No se proporcionan exports del lado servidor. Asegura que Agency-Seatbelt esté iniciado antes que cualquier recurso que use sus exports para evitar errores en tiempo de ejecución o comportamientos indefinidos.
- Solo exports del lado cliente
- Agency-Seatbelt proporciona cuatro exports que son todos del lado cliente. Estos permiten a los scripts activar, desactivar, alternar o verificar el estado del cinturón para el jugador local. No hay exports o eventos del lado servidor expuestos por este recurso.
- Uso dentro de otros recursos
- Para usar estos exports, asegúrate de que Agency-Seatbelt esté iniciado antes que cualquier recurso dependiente. Llama a los exports directamente desde tus scripts cliente para integrar la funcionalidad del cinturón o verificaciones de estado del HUD según sea necesario.
- Sin dependencias ni SQL
- Agency-Seatbelt no requiere dependencias externas ni configuración SQL. Todas las funciones, incluyendo las funciones exportadas, están disponibles desde el inicio tras arrancar el recurso.
?Preguntas frecuentes
¿Existen exports del lado servidor disponibles para Agency-Seatbelt?
No, Agency-Seatbelt solo proporciona exports del lado del cliente. No hay exports ni eventos del lado del servidor expuestos. Toda la interacción con el estado del cinturón debe realizarse desde scripts del cliente usando los exports disponibles.
¿Qué sucede si llamo a un export antes de que Agency-Seatbelt esté iniciado?
Si intentas usar un export antes de que Agency-Seatbelt esté iniciado, el export no estará disponible y tu script puede lanzar un error o no funcionar como se espera. Siempre asegúrate de que Agency-Seatbelt esté iniciado primero.
¿Necesito configurar alguna dependencia o importar SQL para usar estos exports?
No, Agency-Seatbelt no requiere dependencias ni importaciones SQL. Los exports están disponibles inmediatamente después de que el recurso se inicia y no es necesario ningún ajuste adicional.
¿Cómo verifico si el cinturón del jugador local está abrochado desde otro script?
Puedes usar el export del cliente isSeatbeltOn() para comprobar si el cinturón del jugador local está abrochado actualmente. Llama a este export desde tu script del cliente para obtener el estado actual del cinturón.