Agency-Seatbelt V2 Exports & API
Ceinture autonome pour FiveM, entièrement reconstruite pour la 2.0.0.
01Exports client
| Export | Description |
|---|---|
isSeatbeltOn() | Renvoie true tant que la ceinture du joueur local est attachée, qu'il l'ait bouclée lui-même ou que la voiture l'ait fait. |
enableSeatbelt() | Attache la ceinture du joueur local avec le son et le retour habituels. |
disableSeatbelt() | Détache la ceinture du joueur local avec le son et le retour habituels. |
toggleSeatbelt() | Bascule la ceinture du joueur local. Renvoie true si l'état a vraiment changé, et non le nouvel état, pour distinguer une bascule refusée (pas de véhicule ou pas de ceinture à cette place) d'une bascule réussie. |
isAutoBuckled() | Renvoie true tant que la ceinture a été attachée par la voiture et non par le joueur. |
autoBuckle(on: boolean) | Attache ou détache la ceinture en mode automatique, comme le fait une voiture autonome. |
getSeatbeltState() | Renvoie une table avec l'état attaché, le mode automatique ou non, la place et le véhicule. |
setSeatbeltEnabled(on: boolean) | Désactive ou active toute la ceinture pour ce joueur, pour les cinématiques ou les situations d'admin. |
isPlayerSeatbeltOn(serverId: number) | Renvoie l'état de ceinture d'un autre joueur, lu depuis le state bag répliqué. |
bucklesItselfVehicle(vehicle: number) | Indique si ce véhicule attache lui-même ses occupants, via la liste de modèles ou le state bag agAuto. |
openSettings() | Ouvre la carte des réglages. |
closeSettings() | Ferme la carte des réglages. |
isSettingsOpen() | Indique si la carte des réglages est ouverte. |
02Exports serveur
| Export | Description |
|---|---|
isSeatbeltOn(source: number) | Renvoie côté serveur l'état de ceinture d'un joueur, lu depuis le state bag répliqué. |
getBuckledPlayers() | Renvoie les ids serveur de tous les joueurs actuellement attachés. |
setSeatbelt(source: number, on: boolean) | Attache ou détache depuis le serveur la ceinture d'un joueur. |
03Événements
| Nom | Côté | Description |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Client | Se déclenche à chaque changement avec le nouvel état. Agency-HUD l'écoute ; toute autre resource peut le faire aussi. |
+Bon à savoir
Cette page liste les exports disponibles fournis par Agency-Seatbelt pour une utilisation dans d'autres ressources. Les développeurs peuvent utiliser ces exports côté client pour contrôler ou interroger l'état de la ceinture pour le joueur local. Aucun export côté serveur n'est fourni. Assurez-vous qu'Agency-Seatbelt est démarré avant toute ressource qui utilise ses exports pour éviter les erreurs à l'exécution ou un comportement indéfini.
- Exports côté client uniquement
- Agency-Seatbelt fournit quatre exports qui sont tous côté client. Ceux-ci permettent aux scripts d'activer, désactiver, basculer ou vérifier le statut de la ceinture pour le joueur local. Il n'y a pas d'exports ou d'événements côté serveur exposés par cette ressource.
- Utilisation dans d'autres ressources
- Pour utiliser ces exports, assurez-vous qu'Agency-Seatbelt est démarré avant toute ressource dépendante. Appelez les exports directement depuis vos scripts client pour intégrer la fonctionnalité de ceinture ou les vérifications de statut HUD selon vos besoins.
- Pas de dépendances ni SQL
- Agency-Seatbelt ne nécessite aucune dépendance externe ni configuration SQL. Toutes les fonctionnalités, y compris les fonctions d'export, sont disponibles immédiatement après le démarrage de la ressource.
?Questions fréquentes
Existe-t-il des exports côté serveur disponibles pour Agency-Seatbelt ?
Non, Agency-Seatbelt ne fournit que des exports côté client. Il n'y a pas d'exports ou d'événements côté serveur exposés. Toute interaction avec l'état de la ceinture doit être effectuée depuis des scripts clients en utilisant les exports disponibles.
Que se passe-t-il si j'appelle un export avant que Agency-Seatbelt ne soit démarré ?
Si vous tentez d'utiliser un export avant que Agency-Seatbelt ne soit démarré, l'export ne sera pas disponible et votre script peut générer une erreur ou ne pas fonctionner comme prévu. Assurez-vous toujours que Agency-Seatbelt est démarré en premier.
Dois-je configurer des dépendances ou importer du SQL pour utiliser ces exports ?
Non, Agency-Seatbelt ne nécessite aucune dépendance ni importation SQL. Les exports sont disponibles immédiatement après le démarrage de la ressource, et aucune configuration supplémentaire n'est nécessaire.
Comment vérifier si la ceinture du joueur local est bouclée depuis un autre script ?
Vous pouvez utiliser l'export client isSeatbeltOn() pour vérifier si la ceinture du joueur local est actuellement bouclée. Appelez cet export depuis votre script client pour obtenir le statut actuel de la ceinture.