> For the complete documentation index, see [llms.txt](https://docs.snt.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snt.gg/resources/snt-fuelstations.md).

# snt-fuelstations

***

## Exports: Server

```lua
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).*

***

```lua
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**).*

***

```lua
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.

***

```lua
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.

***

```lua
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.

***

```lua
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.

***

```lua
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
```

***

```lua
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`:

{% code title="inventory.lua" overflow="wrap" %}

```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
```

{% endcode %}

***

## Exports: Client

{% code overflow="wrap" %}

```lua
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).
```

{% endcode %}

> 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.*

***

```lua
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.

***

<pre class="language-lua"><code class="lang-lua"><strong>exports['snt-fuelstations']:isVehicleConsumptionDisabled
</strong>(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)
</code></pre>

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

***

```lua
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**).*

***