Exports
Exports
Čtyři client-side exporty pro ostatní resource, které potřebují číst nebo měnit palivo vozidla. Tato stránka dokumentuje pouze to, co v resource skutečně existuje.
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 | Argumenty | Vrací |
|---|---|---|
GetFuel |
vehicle (entity handle) |
Hladinu paliva jako číslo, 0.0–100.0 |
SetFuel |
vehicle, level (číslo) |
Nic |
GetFuelType |
vehicle (entity handle) |
Řetězec klíče paliva — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (entity handle) |
true nebo false |
Notes
GetFuel vrací 0.0 pro neplatnou nebo neexistující entitu. Pokud vozidlo ještě nikdy nebylo detekováno, tento příkaz vygeneruje hodnotu Config.Consumption.SpawnFuel a zapíše ji do state bagu – pouhé přečtení paliva nového auta mu takové palivo přidělí.
SetFuel omezuje hodnotu v rozmezí 0.0–100.0. U síťového vozidla zapisuje do entity state bagu, který se replikuje na každého klienta; u lokálního nastavuje pouze nativní úroveň. Jde o procenta, nikoliv litry – pro litry vynásobte velikostí nádrže pro danou třídu vozidla.
GetFuelType se vyhodnocuje ve stejném pořadí jako stojan: seznam elektromobilů, následně Config.VehicleFuel.Model, poté tabulka tříd a jako výchozí hodnota slouží 'gasoline'.
IsElectric je zkrácený zápis pro GetFuelType(vehicle) == 'electric'.
Palivo se replikuje přes state bag fuel na entitě vozidla. Každý resource, který chce sledovat změny paliva bez neustálého dotazování (pollingu), může použít vlastní AddStateBagChangeHandler('fuel', ...) namísto volání GetFuel ve smyčce.
Inventory item handler
bupa-fuel.useJerryCan je ox_inventory item-use handler pro item jerrycan. Odkazujete se na něj z definice itemu – sami jej nevoláte.
client = { export = 'bupa-fuel.useJerryCan' }Na QBox, QB-Core a ESX je použitelný item registrován interně pomocí resource, takže zde není potřeba žádné propojování exportů.