Configuração

Tudo fica no config.lua, que permanece aberto e editável. Os postos ficam listados em data/stations.lua, os locais de entrega em data/delivery.lua. O emprego de entrega tem a sua própria página: Emprego de entrega de combustível.

No /hzpanel

Com o hz_lib rodando, o /hzpanel tem uma aba Fuel. Uma mudança vale na hora no servidor e para todos os jogadores, sem reiniciar. O config.lua continua sendo o padrão: um ajuste que você nunca salva no painel mantém o valor do config.lua, e um servidor sem hz_lib simplesmente usa o config.lua. Um valor salvo no painel tem prioridade sobre o arquivo. Com o hz_lib 1.2.1 ou mais recente, o botão de redefinir do painel apaga esse valor e o ajuste volta a seguir o config.lua. Com o hz_lib 1.2.0, o botão de redefinir salva no lugar o padrão do próprio painel.

• General (Geral): só cartão nas bombas modernas e nos carregadores (cardOnly), conta cobrada primeiro (paymentAccount), preço por litro de cada combustível, preços da recarga rápida e normal, preços do galão e do reabastecimento do galão, consumo de todos os veículos (globalFuelConsumptionRate).
• Delivery job (emprego de entrega): pagamento por litro entregue de cada combustível, pagamento por km, máximo que um motorista ganha por hora, caução do caminhão.

Geral

Blips, comandos e admins

commands = {
    fuelType = 'fueltype',      -- what the current vehicle drinks
    tanker = 'tanker',          -- delivery job: what the trailer carries
    orders = 'hzfuelorders',    -- delivery job: the tours board
    stock = 'hzfuelstock',      -- admin: station stocks
    sites = 'hzfuelsites',      -- admin: stations and delivery points
    place = 'hzfuelplace',      -- admin: move a delivery point to where you stand
},

-- called on the client with ox_lib's notify table { title, description, type, duration }
notify = function(data)
    exports['my_notify']:Alert(data.title or 'Fuel', data.description, data.type, 5000)
end,

Pagamento

Tipos de combustível e preços

fuelTypes = {
    regular = { label = 'Regular', price = 2.50, consumption = 1.0 },
    plus    = { label = 'Plus',    price = 3.00, consumption = 0.9 },
    premium = { label = 'Premium', price = 3.50, consumption = 0.8 },
    diesel  = { label = 'Diesel',  price = 2.80, consumption = 0.85 },
},
defaultFuelType = 'regular',
fuelAmounts = { 20, 40, 'full' },

Veículos

Consumo

consumption = {
    -- tick, replicateEvery, replicateDelta, damageLeak as above
    classes = { [18] = 0.0, [8] = 0.6 },
    models = { adder = 1.5 },
},

Os multiplicadores de classe e de modelo se aplicam além do globalFuelConsumptionRate e do consumption do tipo de combustível.

Bombas e mangueiras

Galão de gasolina

Outro inventário? Preencha as três funções do lado do servidor, usadas antes de qualquer outra coisa:

petrolCan = {
    has = function(source) return exports['my_inventory']:HasItem(source, 'weapon_petrolcan', 1) end,
    give = function(source) return exports['my_inventory']:AddItem(source, 'weapon_petrolcan', 1) end,
    canCarry = function(source) return exports['my_inventory']:CanCarryItem(source, 'weapon_petrolcan', 1) end,
},

Postos antigos e frentista

Recarga elétrica

Substituição direta

Postos

data/stations.lua lista os 27 postos: 17 modernos e 10 do interior com frentista.

{
    id = 'ls_ltd_grove',
    brand = 'ltd',
    label = 'LTD Grove Street',
    coords = vec3(-71.28, -1761.16, 29.48),
    radius = 60.0,
    pumps = {
        vec3(-63.61, -1767.93, 28.26),
        -- one line per pump
    },
},

Idioma

O HZ-Fuel segue o idioma do ox_lib. Defina-o no seu server.cfg:

setr ox:locale "fr"

19 idiomas estão incluídos em locales/: cs, de, en, es, et, fr, hr, hu, it, lt, nl, pl, pr, pt-br, ro, ru, tr, zh-cn e zh-tw. As linhas que faltarem usam o inglês. Para outro idioma, copie locales/en.json para um novo arquivo com o código dele e traduza-o.

As vozes dos NPCs são em inglês ou francês (voice.language). O texto das falas na caixa de diálogo segue o idioma de cada jogador, como legendas.