Skip to content

Exports

Exports

Fyra klient-side-exports för andra resurser som behöver läsa eller ändra ett fordons bränsle. Denna sida dokumenterar endast det som faktiskt existerar i resursen.

client-side
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 Argument Returnerar
GetFuel vehicle (entitetshandtag) Bränslenivån som ett nummer, 0.0100.0
SetFuel vehicle, level (nummer) Ingenting
GetFuelType vehicle (entitetshandtag) En bränsle-nyckelsträng — 'gasoline', 'diesel', 'premium', 'electric'
IsElectric vehicle (entitetshandtag) true eller false

Notes

GetFuel returnerar 0.0 för en ogiltig eller icke-existerande entitet. Om fordonet aldrig har setts tidigare är detta anropet som genererar dess Config.Consumption.SpawnFuel-nivå och skriver den till state bag – så att helt enkelt läsa ett nytt fordons bränsle är det som tilldelar det ett.

SetFuel begränsas till 0.0100.0. På ett nätverksanslutet fordon skriver det till entitetens state bag, vilket replikeras till varje klient; på ett lokalt sätter det endast den interna nivån. Det är en procentandel, inte liter – för liter, multiplicera med tankstorleken för den fordonsklassen.

GetFuelType avgörs i samma ordning som pumpen gör: el-listan, sedan Config.VehicleFuel.Model, sedan klasstabellen, och återgår till 'gasoline' som standard.

IsElectric är en genväg för GetFuelType(vehicle) == 'electric'.

Bränsle replikeras via fuel-state bag på fordonets entitet. Alla resurser som vill övervaka bränsleändringar utan pollande kan lägga till sin egen AddStateBagChangeHandler('fuel', ...) istället för att anropa GetFuel i en loop.

Inventory item handler

bupa-fuel.useJerryCan är ox_inventory item-use-hanteraren för jerrycan-föremålet. Du refererar till den från föremålsdefinitionen – du anropar den inte själv.

ox_inventory/data/items.lua
client = { export = 'bupa-fuel.useJerryCan' }

På QBox, QB-Core och ESX registreras det användbara föremålet internt av resursen, så ingen export-koppling behövs där.