Agency-Seatbelt V2 Exports & API
Standalone-Gurt für FiveM, für 2.0.0 von Grund auf neu gebaut.
01Client-Exports
| Export | Beschreibung |
|---|---|
isSeatbeltOn() | Gibt true zurück, solange der Gurt des lokalen Spielers angelegt ist, egal ob er sich selbst angeschnallt hat oder das Auto. |
enableSeatbelt() | Legt den Gurt des lokalen Spielers mit dem üblichen Ton und der üblichen Rückmeldung an. |
disableSeatbelt() | Löst den Gurt des lokalen Spielers mit dem üblichen Ton und der üblichen Rückmeldung. |
toggleSeatbelt() | Schaltet den Gurt des lokalen Spielers um. Gibt true zurück, wenn sich der Zustand wirklich geändert hat, nicht den neuen Zustand. So lässt sich ein abgelehntes Umschalten (kein Fahrzeug oder kein Gurt auf diesem Sitz) von einem erfolgreichen unterscheiden. |
isAutoBuckled() | Gibt true zurück, solange der Gurt vom Auto angelegt wurde und nicht vom Spieler. |
autoBuckle(on: boolean) | Legt den Gurt als Automatikgurt an oder löst ihn, so wie es ein selbstfahrendes Auto macht. |
getSeatbeltState() | Gibt eine Tabelle mit dem Gurtzustand zurück, ob er automatisch ist, dem Sitz und dem Fahrzeug. |
setSeatbeltEnabled(on: boolean) | Schaltet den gesamten Gurt für diesen Spieler aus oder ein, für Zwischensequenzen oder Admin-Situationen. |
isPlayerSeatbeltOn(serverId: number) | Gibt den Gurtzustand eines anderen Spielers zurück, gelesen aus der replizierten State Bag. |
bucklesItselfVehicle(vehicle: number) | Gibt zurück, ob dieses Fahrzeug seine Insassen selbst anschnallt, laut Modellliste oder State Bag agAuto. |
openSettings() | Öffnet die Einstellungskarte. |
closeSettings() | Schließt die Einstellungskarte. |
isSettingsOpen() | Gibt zurück, ob die Einstellungskarte offen ist. |
02Server-Exports
| Export | Beschreibung |
|---|---|
isSeatbeltOn(source: number) | Gibt auf dem Server den Gurtzustand eines Spielers zurück, gelesen aus der replizierten State Bag. |
getBuckledPlayers() | Gibt die Server-IDs aller Spieler zurück, die gerade angeschnallt sind. |
setSeatbelt(source: number, on: boolean) | Legt vom Server aus den Gurt eines Spielers an oder löst ihn. |
03Events
| Name | Seite | Beschreibung |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Client | Wird bei jeder Änderung mit dem neuen Zustand ausgelöst. Agency-HUD hört darauf, jede andere Resource darf das auch. |
+Gut zu wissen
Diese Seite listet die verfügbaren Exports auf, die von Agency-Seatbelt für die Nutzung in anderen Ressourcen bereitgestellt werden. Entwickler können diese clientseitigen Exports verwenden, um den Sicherheitsgurtstatus des lokalen Spielers zu steuern oder abzufragen. Serverseitige Exports werden nicht bereitgestellt. Stellen Sie sicher, dass Agency-Seatbelt vor jeder Ressource, die seine Exports nutzt, gestartet wird, um Laufzeitfehler oder undefiniertes Verhalten zu vermeiden.
- Nur clientseitige Exports
- Agency-Seatbelt stellt vier Exports bereit, die alle clientseitig sind. Diese erlauben es Scripts, den Sicherheitsgurtstatus des lokalen Spielers zu aktivieren, deaktivieren, umschalten oder abzufragen. Es gibt keine serverseitigen Exports oder Events, die von dieser Ressource bereitgestellt werden.
- Verwendung in anderen Ressourcen
- Um diese Exports zu verwenden, stellen Sie sicher, dass Agency-Seatbelt vor jeder abhängigen Ressource gestartet wird. Rufen Sie die Exports direkt aus Ihren Client-Scripts auf, um Sicherheitsgurt-Funktionalität oder HUD-Statusabfragen nach Bedarf zu integrieren.
- Keine Abhängigkeiten oder SQL
- Agency-Seatbelt benötigt keine externen Abhängigkeiten oder SQL-Einrichtung. Alle Funktionen, einschließlich der Exportfunktionen, sind direkt nach dem Start der Ressource verfügbar.
?Häufige Fragen
Gibt es serverseitige Exports für Agency-Seatbelt?
Nein, Agency-Seatbelt bietet nur clientseitige Exports. Es gibt keine serverseitigen Exports oder Events. Alle Interaktionen mit dem Sicherheitsgurtzustand müssen von Client-Skripten aus über die verfügbaren Exports erfolgen.
Was passiert, wenn ich einen Export aufrufe, bevor Agency-Seatbelt gestartet ist?
Wenn Sie versuchen, einen Export aufzurufen, bevor Agency-Seatbelt gestartet ist, steht der Export nicht zur Verfügung und Ihr Skript kann einen Fehler auslösen oder nicht wie erwartet funktionieren. Stellen Sie immer sicher, dass Agency-Seatbelt zuerst gestartet ist.
Muss ich Abhängigkeiten konfigurieren oder SQL importieren, um diese Exports zu verwenden?
Nein, Agency-Seatbelt benötigt keine Abhängigkeiten oder SQL-Importe. Die Exports sind sofort nach dem Start der Ressource verfügbar, und es ist keine zusätzliche Einrichtung notwendig.
Wie überprüfe ich in einem anderen Skript, ob der lokale Spieler den Sicherheitsgurt angelegt hat?
Sie können den clientseitigen Export isSeatbeltOn() verwenden, um zu prüfen, ob der Sicherheitsgurt des lokalen Spielers angelegt ist. Rufen Sie diesen Export in Ihrem Client-Skript auf, um den aktuellen Sicherheitsgurtstatus zu erhalten.