Exports
Exports
Vier client-side exports voor andere resources die het brandstofniveau van een voertuig willen uitlezen of wijzigen. Deze pagina beschrijft alleen wat daadwerkelijk in de resource aanwezig is.
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 | Argumenten | Retouren |
|---|---|---|
GetFuel |
vehicle (entity handle) |
Het brandstofniveau als getல், 0.0–100.0 |
SetFuel |
vehicle, level (nummer) |
Niets |
GetFuelType |
vehicle (entity handle) |
Een brandstof-sleutelstring — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (entity handle) |
true of false |
Notities
GetFuel retourneert 0.0 voor een ongeldige of niet-bestaande entiteit. Als het voertuig nog nooit eerder is geladen, zorgt deze aanroep ervoor dat het Config.Consumption.SpawnFuel-niveau wordt bepaald en weggeschreven naar de state bag — dus simpelweg het brandstofniveau van een nieuwe auto uitlezen wijst er direct eentje toe.
SetFuel begrenst de waarde tussen 0.0 en 100.0. Bij een genetwerkt voertuig schrijft dit naar de entity state bag, die synchroniseert met elke client; bij een lokaal voertuig wordt alleen het native niveau ingesteld. Het is een percentage, geen liters — vermenigvuldig voor liters met de tankinhoud van die voertuigklasse.
GetFuelType zoekt in dezelfde volgorde als de pomp: de elektrische lijst, dan Config.VehicleFuel.Model, dan de klassentabel, en valt anders terug op 'gasoline'.
IsElectric is een verkorte schrijfwijze voor GetFuelType(vehicle) == 'electric'.
Brandstof wordt gerepliceerd via de fuel state bag op de voertuig-entiteit. Elke resource die brandstofwijzigingen wil volgen zonder te pollen kan een eigen AddStateBagChangeHandler('fuel', ...) toevoegen in plaats van continu GetFuel aan te roepen in een loop.
Inventory item handler
bupa-fuel.useJerryCan is de ox_inventory item-use handler voor het jerrycan-item. Je verwijst hiernaar vanuit de item-definitie — je roept dit niet zelf aan.
client = { export = 'bupa-fuel.useJerryCan' }Op QBox, QB-Core en ESX wordt het bruikbare item intern geregistreerd door de resource, dus hiervoor is geen extra export-koppeling nodig.