snt-fuelstations

---

Exports: Server

exports['snt-fuelstations']:setVehicleFuelLevel(model,plate,level)
-- model : string/number : modelo (hash) do veículo
-- plate : string : placa do veículo
-- level : number : valor de combustível a ser setado para o veículo em questão.

Setar a gasolina de um veículo (útil para quando ele for gerado pela garagem, por exemplo). Não é obrigatória a sua utilização! A sincronização será realizada de forma automática, basta setar o nível de combustível corretamente na entidade do veículo quando ele for criado (cliente).

---

exports['snt-fuelstations']:getVehicleFuelLevel(model,plate)
-- model : string/number : modelo (hash) do veículo
-- plate : string : placa do veículo

Retorna a gasolina atual de um veículo, pelo modelo e placa (atenção: se o nível de gasolina do veículo ainda não possuir um valor de gasolina sincronizado, seja pela primeira utilização do veículo por um jogador ou pelo uso do export setVehicleFuelLevel, o retorno deste export será nulo).

---

exports['snt-fuelstations']:addMoneyForStation(id,amount)
-- id : string : conforme cadastrado em config.lua > stations.
-- amount : number : quantidade de dinheiro a ser adicionada ao caixa

Adiciona valores ao caixa de uma estação.

---

exports['snt-fuelstations']:removeMoneyFromStation(id,amount)
-- id : string : conforme cadastrado em config.lua > stations.
-- amount : number : quantidade de dinheiro a ser removida do caixa

Remove valores do caixa de uma estação.

---

exports['snt-fuelstations']:setTankFuel(id,amount)
-- id : string : conforme cadastrado em config.lua > stations.
-- amount : number : valor a ser definido de combustível

Define a quantidade de combustível no tanque de uma estação.

---

exports['snt-fuelstations']:increaseTankFuel(id,amount)
-- id : string : conforme cadastrado em config.lua > stations.
-- amount : number : quantidade de combustível a ser adicionada ao tanque

Adiciona combustível ao tanque de uma estação.

---

exports['snt-fuelstations']:decreaseTankFuel(id,amount)
-- id : string : conforme cadastrado em config.lua > stations.
-- amount : number : quantidade de combustível a ser removida do tanque

---

exports['snt-fuelstations']:tryRefuelNearestVehicle(source,amount)
-- source : source do jogador
-- amount : quantidade de gasolina a ser 

Realizar o reabastecimento de veículo próximo do jogador, usando um item "galão de combustível" por exemplo, no inventário.

O export, retornará true, caso haja um veículo próximo que pode ser reabastecido. Ao chamá-lô, ele fará o jogador olhar pro veículo, fazer uma animação e também abastecerá o veículo com a quantidade (amount) de combustível passada. Veja no exemplo abaixo a função do item, no snt-inventory:

inventory.lua

if item == 'petrolcan' then
    closeInventory(src)
    if isInVehicle(src) then
        return
    end
    if GetResourceState('snt-fuelstations') == 'started' then
        if exports['snt-fuelstations']:tryRefuelNearestVehicle(src,100) then
            removeInventoryItem(characterId,item,1,true,slot)
            TriggerClientEvent('Notify',src,'sucesso','Veículo reabastecido!',3000)
            return
        end
        TriggerClientEvent('Notify',src,'negado','Não há nenhum veículo próximo que possa ser reabastecido com este combustível!',5000)
    end
    return
end

---

Exports: Client

exports['snt-fuelstations']:trySyncVehicleFuel(ped,vehicle,ignoreFlood)
-- ped : number : ped do jogador em questão
-- vehicle : number : handle do veículo em questão
-- ignoreFlood : boolean : true / false (forçar a sincronização, mesmo que uma já tenha sido feito recentemente).

Forçar a sincronização do combustível de um veículo, via CLIENTE. O ped deve estar no volante (p1) do veículo em questão, para que a sincronização seja efetuada. Para outros casos, faça a sincronização via server. Utilize somente em casos que a gasolina do veículo é alterada/ajustada no cliente, por algum motivo.

---

exports['snt-fuelstations']:getVehicleFuelConsumption
(vehicle,vehicleClass,vehicleModel,vehiclePlate)
-- vehicle : number : handle do veículo em questão
-- vehicleClass : number : classe do veículo em questão (GetVehicleClass)
-- vehicleModel : number : modelo / hash do veículo em questão (GetEntityModel)
-- vehiclePlate : string : placa do veículo em questão (GetVehicleNumberPlateText)

Pegar o consumo de gasolina de um veículo, no momento em que o export está sendo chamado. Retorna um double (0.0 - consumo).

Remove combustível do tanque de uma estação.

---

exports['snt-fuelstations']:isVehicleConsumptionDisabled
(vehicleClass,vehicleModel,vehiclePlate)
-- vehicleClass : number : classe do veículo em questão (GetVehicleClass)
-- vehicleModel : number : modelo / hash do veículo em questão (GetEntityModel)
-- vehiclePlate : string : placa do veículo em questão (GetVehicleNumberPlateText)

Retorna true caso o consumo de gasolina do veículo estiver desativado.

---

exports['snt-fuelstations']:getVehicleFuelLevel(model,plate)
-- model : string/number : modelo (hash) do veículo
-- plate : string : placa do veículo

Retorna a gasolina atual de um veículo, pelo modelo e placa (atenção: se o nível de gasolina do veículo ainda não possuir um valor de gasolina sincronizado, seja pela primeira utilização do veículo por um jogador ou pelo uso do export setVehicleFuelLevel, o retorno deste export será nulo).

---