Exports
Exports
Vier client-side Exports für andere Ressourcen, die den Tank eines Fahrzeugs auslesen oder ändern müssen. Diese Seite dokumentiert ausschließlich das, was tatsächlich in der Ressource existiert.
local fuel = exports['bupa-fuel']:GetFuel(vehicle)
exports['bupa-fuel']:SetFuel(vehicle, 75.0)
local kind = exports['bupa-fuel']:GetFuelType(vehicle)
local ev = exports['bupa-fuel']:IsElectric(vehicle)| Export | Argumente | Rückgabewert |
|---|---|---|
GetFuel |
vehicle (Entity-Handle) |
Der Tankstand als Zahl, 0.0–100.0 |
SetFuel |
vehicle, level (Zahl) |
Nichts |
GetFuelType |
vehicle (Entity-Handle) |
Ein Kraftstoff-Schlüsselstring — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (Entity-Handle) |
true oder false |
Notes
GetFuel gibt 0.0 für eine ungültige oder nicht existierende Entity zurück. Wenn das Fahrzeug zuvor noch nie erfasst wurde, generiert dieser Aufruf den Config.Consumption.SpawnFuel-Wert und schreibt ihn in den State Bag – das bloße Auslesen des Tankstands eines neuen Autos weist ihm also einen zu.
SetFuel begrenzt den Wert auf 0.0–100.0. Bei einem netzwerkbasierten Fahrzeug wird in den Entity State Bag geschrieben, was an jeden Client repliziert wird; bei einem lokalen Fahrzeug wird nur der native Wert gesetzt. Es handelt sich um einen Prozentsatz, keine Liter – für Liter multiplizieren Sie diesen mit der Tankgröße der jeweiligen Fahrzeugklasse.
GetFuelType ermittelt den Typ in derselben Reihenfolge wie die Zapfsäule: die Liste der Elektrofahrzeuge, dann Config.VehicleFuel.Model, gefolgt von der Klassentabelle, mit einem Fallback auf 'gasoline'.
IsElectric ist eine Kurzschreibweise für GetFuelType(vehicle) == 'electric'.
Kraftstoff wird über den fuel State Bag auf der Fahrzeug-Entity repliziert. Jede Ressource, die Kraftstoffänderungen ohne Polling überwachen möchte, kann ihren eigenen AddStateBagChangeHandler('fuel', ...) hinzufügen, anstatt GetFuel in einer Schleife aufzurufen.
Inventory item handler
bupa-fuel.useJerryCan ist der ox_inventory item-use handler für das Item jerrycan. Sie verweisen darauf in der Item-Definition – Sie rufen ihn nicht selbst auf.
client = { export = 'bupa-fuel.useJerryCan' }Auf QBox, QB-Core und ESX wird das verwendbare Item intern von der Ressource registriert, sodass dort keine Export-Verknüpfung erforderlich ist.