Build Soul Project ESX Legacy essential base

[SoulBrotherDev]

Objetivo

Transformar o repositório vazio numa base ESX Legacy reproduzível pelo txAdmin e suficientemente completa para iniciar staging do Soul Project.

Fundação

• recipe txAdmin baseada no ESX Legacy atual;
• instalação de ESX Core, ESX Legacy Addons, oxmysql, pma-voice, bob74_ipl e recursos Cfx.re;
• configuração modular para core, segurança, voz, ESX, permissões, segredos e ordem de arranque;
• idioma PT-PT e identificador ESX steam;
• gate Steam-only;
• hierarquia ACE owner, admin, dev, mod e support;
• sp_bootstrap com sp_health, logging e state bag spReady.

Comunicação

Rádio

• novo sp_radio sobre pma-voice;
• item utilizável radio;
• comandos /radio, /radiooff e /radiovol;
• frequências reservadas para Polícia, Emergência Médica, Mecânicos e Táxis;
• validação server-side e channel checks no pma-voice;
• remoção automática de frequências sem autorização.

Telefone

• novo sp_phone com NUI black-gold;
• item utilizável phone e tecla F1;
• número persistente por personagem;
• contactos e SMS persistentes;
• histórico e chamadas reais pelo pma-voice;
• pedidos 112, 115, 116 e 117 com localização;
• validação server-side de item, remetente, destinatário e callbacks;
• tabelas SQL próprias para números, contactos, mensagens, chamadas e serviços.

Economia, jobs e veículos

A recipe instala o pack completo de addons ESX e importa os esquemas necessários para:

• addon accounts, addon inventories e datastores;
• societies e boss management;
• billing, licenses e banking;
• empregos civis do esx_jobs;
• Polícia, Emergência Médica, Mecânico e Táxi;
• concessionário, veículos próprios e garagem;
• restantes addons oficiais presentes no pack, incluindo propriedades, lojas, necessidades, HUD e customização.

A migração PT-PT ajusta os nomes principais de empregos e patentes.

Primeiro personagem

• novo sp_starterpack idempotente;
• entrega única de telemóvel, rádio, água e pão;
• registo persistente em sp_starter_claims.

Qualidade e segurança

• segredos reais excluídos do Git;
• convars de segurança e voz;
• detector de segredos;
• validação da recipe e de todas as migrações próprias;
• validação de manifests e ficheiros referenciados;
• parsing de todos os ficheiros Lua;
• verificação do JavaScript do telefone;
• git diff --check;
• documentação de instalação, arquitetura, comandos, frequências, serviços e checklist de staging.

Validação automática

O workflow GitHub Actions passou com sucesso em:

• estrutura e dependências;
• recipe e SQL;
• manifests;
• sintaxe Lua;
• sintaxe JavaScript;
• whitespace;
• deteção básica de segredos.

Validação runtime ainda necessária

• executar a recipe num perfil txAdmin de staging e numa base vazia;
• preencher config/secrets.cfg com a Steam Web API Key;
• confirmar ligação oxmysql e importação integral dos SQL oficiais;
• arrancar FXServer e executar sp_health;
• testar dois jogadores em rádio, SMS e chamadas;
• testar o kit inicial sem duplicação;
• testar os jobs, societies, billing, banking, vehicleshop e garage;
• ajustar economia, coordenadas, veículos, fardas e permissões antes de produção.

O PR permanece draft até passar esta validação runtime.