Instalação
Dependências
| Dependência | Obrigatória | Por quê |
|---|---|---|
| ox_lib | Sim | 3.22.0 ou mais recente. Menus, text UI e arquivos de idioma |
| hz_lib | Não, recomendado | Grá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-TextUi | Não | Prompts 3D nas bombas. Sem ele, o text UI do ox_lib mostra os prompts |
| Framework (ESX / QBCore / Qbox / ox_core) | Não | Detectado automaticamente. Standalone também funciona, veja Pagamento |
| Um inventário | Não | Só para os galões. Veja Galão de gasolina |
| Banco de dados | Não | Nenhum. Os estoques dos postos e os níveis dos galões são salvos pelo servidor, sem SQL |
Passos
- Coloque a pasta
hz_fuelno seu diretórioresources. - 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.
- 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
- Defina os seus preços no
config.lua(fuelTypes) e reinicie o servidor.
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:
| Framework | O que acontece |
|---|---|
| QBCore / Qbox | Adicionado 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 antigo | Rode o SQL abaixo uma vez |
| ox_core | Crie 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.
| Mapa | Status |
|---|---|
| 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 Department | Compatível, nada a fazer |
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.