Instalação

Dependências

DependênciaObrigatóriaPor quê
ox_libSim3.22.0 ou mais recente. Menus, text UI e arquivos de idioma
hz_libNão, recomendadoGrátis. Encontra para você o seu framework, o seu inventário e as suas notificações, e traz a caixa de diálogo, os objetivos na tela e o tablet de despacho
HZ-TextUiNãoPrompts 3D nas bombas. Sem ele, o text UI do ox_lib mostra os prompts
Framework (ESX / QBCore / Qbox / ox_core)NãoDetectado automaticamente. Standalone também funciona, veja Pagamento
Um inventárioNãoSó para os galões. Veja Galão de gasolina
Banco de dadosNãoNenhum. Os estoques dos postos e os níveis dos galões são salvos pelo servidor, sem SQL

Passos

  1. Coloque a pasta hz_fuel no seu diretório resources.
  2. Remova o script de combustível que você usava (LegacyFuel, ox_fuel, qb-fuel, cdn-fuel, ps-fuel…). Seus outros scripts continuam funcionando: o HZ-Fuel responde no lugar dele.
  3. Adicione o HZ-Fuel ao seu server.cfg, depois do ox_lib, do seu framework, do seu inventário e do hz_lib:
ensure ox_lib
# your framework and inventory here
ensure hz_lib
ensure hz_textui   # optional
ensure hz_fuel
  1. Defina os seus preços no config.lua (fuelTypes) e reinicie o servidor.
Um script de combustível por vez. Dois sistemas de combustível esvaziam e enchem os mesmos veículos. Se outro script de combustível ainda estiver rodando, o console do servidor avisa em vermelho na inicialização.

O que você deve ver

  • Na inicialização, o console do servidor mostra o framework, o inventário e o modo de pagamento que o HZ-Fuel encontrou.
  • Os blips dos postos no mapa.
  • Estacione em uma bomba moderna e desça do veículo: o prompt Pegar o bico aparece, e a tela da bomba mostra os preços.
  • Nos postos do interior (Sandy Shores, Grapeseed, Harmony, Route 68, Paleto Boulevard…), o frentista espera perto das bombas.
  • Os carregadores elétricos mostram a tela de boas-vindas.

Atualizar

Depois de uma atualização, reinicie o servidor inteiro, não só restart hz_fuel. Quando o HZ-Fuel é reiniciado sozinho, os jogadores já conectados veem os nomes que ele substitui (LegacyFuel, ox_fuel…) como parados até reconectarem. É um limite do FiveM, e os scripts que verificam esses nomes, como o piloto automático ou alguns HUDs, perdem o nível de combustível enquanto isso.

config.lua, data/ e locales/ são seus: guarde uma cópia antes de substituir a pasta.


O emprego de entrega

Só os membros do emprego fueldelivery podem pegar um turno de entrega. O HZ-Fuel adiciona o emprego ao seu framework quando ele não existe:

FrameworkO que acontece
QBCore / QboxAdicionado na memória a cada início. Nada é escrito nos seus arquivos, e um emprego fueldelivery no seu shared/jobs.lua tem prioridade
ESX (com ESX.CreateJob)Escrito uma vez nas tabelas jobs e job_grades
ESX mais antigoRode o SQL abaixo uma vez
ox_coreCrie o grupo você mesmo
INSERT INTO jobs (name, label) VALUES ('fueldelivery', 'Fuel Delivery');
INSERT INTO job_grades (job_name, grade, name, label, salary, skin_male, skin_female) VALUES
  ('fueldelivery', 0, 'trainee', 'Trainee', 20, '{}', '{}'),
  ('fueldelivery', 1, 'driver', 'Driver', 35, '{}', '{}'),
  ('fueldelivery', 2, 'senior', 'Senior Driver', 50, '{}', '{}'),
  ('fueldelivery', 3, 'supervisor', 'Supervisor', 65, '{}', '{}');

Os jogadores recebem o emprego como qualquer outro: adicione fueldelivery à lista de empregos da sua prefeitura (qbx_cityhall config/shared.lua > employment.jobs, qb-cityhall Config.AvailableJobs), use um menu de chefe ou /setjob. Para deixar todo mundo trabalhar, defina delivery.jobs = false. O emprego completo está em Emprego de entrega de combustível.


Mapas que substituem as bombas

O HZ-Fuel funciona com os modelos de bomba do jogo. Alguns mapas pagos os trocam pelo próprio modelo: esse posto fica então sem tela, sem bico e sem prompt. A pasta [compatibility] incluída no recurso explica como devolver as bombas do jogo a um mapa desses.

MapaStatus
Gabz ESB LTD (Grove Street LTD, Davis)Substitui as 6 bombas: siga [compatibility]/[gabz-esbltd]/readme.txt (6 linhas a mudar em um arquivo do mapa)
Gabz Harmony, Gabz Fire DepartmentCompatível, nada a fazer
Outro mapa? Abra os arquivos do mapa perto do posto no CodeWalker, veja o modelo de cada bomba e coloque de volta o modelo do jogo: prop_gas_pump_1a / 1b / 1c / 1d, prop_gas_pump_old2 / old3 ou prop_vintage_pump. Adicionar o modelo do mapa a pumpModels não basta: a mangueira, a tela e a fenda do cartão são ajustadas a cada modelo. Fale com a gente no Discord e nós adicionamos o mapa à pasta.