Exports
Exports
Quatro exports do lado do cliente, para outros recursos que precisam ler ou alterar o combustível de um veículo. Esta página documenta apenas o que realmente existe no recurso.
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 | Argumentos | Retorna |
|---|---|---|
GetFuel |
vehicle (handle da entidade) |
O nível de combustível como um número, 0.0–100.0 |
SetFuel |
vehicle, level (número) |
Nada |
GetFuelType |
vehicle (handle da entidade) |
Uma string com a chave do combustível — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (handle da entidade) |
true ou false |
Notas
GetFuel retorna 0.0 para uma entidade inválida ou inexistente. Se o veículo nunca foi visto antes, esta é a chamada que define o nível Config.Consumption.SpawnFuel dele e o grava no state bag — portanto, simplesmente ler o combustível de um carro novo é o que atribui um a ele.
SetFuel limita o valor entre 0.0 e 100.0. Em um veículo em rede (networked), ele grava no state bag da entidade, que é replicado para todos os clientes; em um veículo local, ele define apenas o nível nativo. É uma porcentagem, não litros — para litros, multiplique pelo tamanho do tanque da classe daquele veículo.
GetFuelType resolve na mesma ordem que a bomba: a lista elétrica, depois Config.VehicleFuel.Model, depois a tabela de classes, recorrendo a 'gasoline' como padrão.
IsElectric é um atalho para GetFuelType(vehicle) == 'electric'.
O combustível é replicado através do state bag fuel na entidade do veículo. Qualquer recurso que queira monitorar alterações de combustível sem usar polling pode adicionar o seu próprio AddStateBagChangeHandler('fuel', ...) em vez de chamar GetFuel em um loop.
Manipulador de item de inventário
bupa-fuel.useJerryCan é o manipulador de uso de item do ox_inventory para o item jerrycan. Você faz referência a ele na definição do item — você não o chama diretamente.
client = { export = 'bupa-fuel.useJerryCan' }No QBox, QB-Core e ESX, o item utilizável é registrado internamente pelo recurso, portanto nenhuma configuração de export é necessária nesses frameworks.