QBESXStandalone
Agency-Repairkit V2 Exports & API
Realistischer Fahrzeugschaden und vier Reparaturkits für FiveM, bei QBCore, QBox, ESX oder komplett standalone.
v2.0.0Bezahlt5 Seiten
01Client-Exports
| Export | Beschreibung |
|---|---|
IsRepairing() | Gibt true zurück, während der lokale Spieler an einem Fahrzeug arbeitet, zum Beispiel um dein eigenes Menü geschlossen zu halten. |
GetVehicleCondition(vehicle) | Motor, Karosserie und Tank in %, die Reifen, der Schmutz, die Schadensstufe und ob der Tank leckt. Ohne Argument liest es das Fahrzeug aus, in dem der Spieler sitzt. |
OpenMenu() | Öffnet das /arepairkit-Menü, zum Beispiel aus einer Phone-App oder einem Radialmenü. |
CloseMenu() | Schließt das Menü und gibt die Maus zurück ans Spiel. |
IsMenuOpen() | Gibt true zurück, solange das Menü offen ist. |
02Server-Exports
| Export | Beschreibung |
|---|---|
UseKit(source, kit) | Startet ein Kit für einen Spieler, als wäre das Item benutzt worden, mit allen Prüfungen. Gibt true zurück, oder false und den Grund. Für eigene Inventare und Shops. |
GiveKit(source, kit, amount) | Fügt einem Spieler Kits über das erkannte Inventar hinzu. Gibt bei Erfolg true zurück. |
IsRepairing(source) | true, solange dieser Spieler an einem Fahrzeug arbeitet. |
GetKits() | Jedes konfigurierte Kit mit Item, Label, Arbeitsart und Dauer. |
useKit(event, item, inventory, slot, data) | Der ox_inventory-Item-Export. Die Item-Einträge in install/ox_inventory.lua verweisen darauf; er ist nicht dafür gedacht, direkt aufgerufen zu werden. |
03Events
| Name | Seite | Beschreibung |
|---|---|---|
agency-repairkit:repaired | Server | Wird auf dem Server mit (source, netId, kit) ausgelöst, nachdem eine Reparatur abgeschlossen und das Kit aufgebraucht wurde. Gut für Logs, Zahlungen oder Job-Fortschritt. |
agency-repairkit:client:repaired | Client | Wird auf dem Client des reparierenden Spielers mit (netId, kit) ausgelöst, wenn eine Reparatur abgeschlossen ist. |
agency-repairkit:client:damageLevel | Client | Wird auf dem Client des Fahrers mit (level, vehicle) ausgelöst, wenn sich die Schadensstufe ändert: ok, light, medium, heavy oder critical. |
+Gut zu wissen
Andere Resources können Kits starten, sie vergeben, abfragen, ob ein Spieler gerade arbeitet, und den Zustand eines Fahrzeugs auslesen. Drei Events melden abgeschlossene Reparaturen und Änderungen der Schadensstufe.
- Kits aus eigenem Code starten
- UseKit(source, kit) führt dieselben Prüfungen aus wie ein Item im Inventar: Distanz, Job, Cooldown und das Item selbst. So lässt sich ein eigenes Inventar oder ein Shop-NPC anbinden.
- Auf Reparaturen reagieren
- agency-repairkit:repaired feuert auf dem Server, nachdem das Kit verbraucht wurde, mit dem Spieler, der Netzwerk-ID des Fahrzeugs und dem Kit, zum Beispiel um einen Mechaniker zu bezahlen oder ein Log zu schreiben.
?Häufige Fragen
Kann mein HUD die Schadensstufe anzeigen?
Ja. Lausche auf agency-repairkit:client:damageLevel auf dem Client, oder rufe jederzeit GetVehicleCondition für Motor, Karosserie, Tank, Reifen und die Stufe auf.