Exports
Exports
Four client-side exports, for other resources that need to read or change a vehicle's fuel. This page documents only what actually exists in the resource.
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 | Arguments | Returns |
|---|---|---|
GetFuel |
vehicle (entity handle) |
The fuel level as a number, 0.0–100.0 |
SetFuel |
vehicle, level (number) |
Nothing |
GetFuelType |
vehicle (entity handle) |
A fuel key string — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (entity handle) |
true or false |
Notes
GetFuel повертає 0.0 для недійсного або неіснуючого об'єкта. Якщо транспортний засіб ніколи раніше не з'являвся, цей виклик визначає його рівень за параметром Config.Consumption.SpawnFuel та записує його в state bag — тож звичайне зчитування рівня пального нового автомобіля автоматично призначає його.
SetFuel обмежує значення в діапазоні від 0.0 до 100.0. Для мережевого транспортного засобу він записує дані в state bag об'єкта, який реплікується на кожен клієнт; для локального — встановлює лише нативний рівень. Це відсоткове значення, а не літри — для отримання літрів помножте його на об'єм бака для відповідного класу транспортного засобу.
GetFuelType визначає тип у тому ж порядку, що й колонка: список електромобілів, потім Config.VehicleFuel.Model, потім таблиця класів, з резервним варіантом 'gasoline'.
IsElectric — це скорочення для GetFuelType(vehicle) == 'electric'.
Пальне реплікується через state bag fuel на об'єкті транспортного засобу. Будь-який ресурс, який хоче відстежувати зміни пального без опитування у циклі, може додати власний AddStateBagChangeHandler('fuel', ...).
Inventory item handler
bupa-fuel.useJerryCan is the ox_inventory item-use handler for the jerrycan item. You reference it from the item definition — you do not call it yourself.
client = { export = 'bupa-fuel.useJerryCan' }На QBox, QB-Core та ESX предмет, який можна використовувати, реєструється внутрішньо самим ресурсом, тому додаткове налаштування експорту там не потрібне.