Guia do Framework ESX: Instalação Oficial, Atualizações e Compatibilidade

O ESX Legacy é um framework de roleplay de código aberto para FiveM. Para um novo servidor, use o modelo oficial ESX Legacy no txAdmin ou siga a documentação de instalação oficial completa. Instalar apenas a es_extended pasta não é uma configuração completa de servidor, pois o stack suportado inclui trabalho de banco de dados, recursos necessários e uma configuração de inicialização ordenada.

Principais conclusões

• Use a receita oficial do ESX Legacy no txAdmin para uma nova instalação.
• es_extended é a base fundamental, não o servidor de roleplay completo.
• O caminho manual documentado inclui oxmysql, spawnmanager, SQL, exclusões e ordem dos recursos.
• Antes de uma atualização, identifique a versão exata do ESX ou o fork e faça backup do banco de dados e dos recursos.
• Verifique cada script de terceiros em relação ao framework atual, ao inventário, à biblioteca de banco de dados, aos eventos, aos exports e às dependências.

O que o ESX Legacy oferece

O ESX fornece uma base de framework para dados de jogador e personagem e para recursos que se integram com suas APIs e convenções. Trabalhos, inventário, moradia, bancos, telefones e outros sistemas de gameplay são recursos separados ou partes de uma receita selecionada. Sua presença e comportamento dependem do stack real, não apenas do fato de es_extended estar instalado.

O oficial Repositório principal do ESX é a fonte correta para o código principal atual. Seu es_extended manifest declara oxmysql como uma dependência. Use a documentação oficial e o histórico de lançamentos para identificar o que você tem; evite um pacote aleatório anunciado apenas como o último ZIP ESX.

Instale um novo servidor ESX com txAdmin

O tutorial oficial do servidor usa o implantador de receitas txAdmin incluído no FXServer. Selecione o modelo ESX Legacy e conclua a configuração guiada atual, em vez de copiar uma pasta do núcleo para um diretório resources vazio.

1. Prepare um ambiente FXServer atual e abra o fluxo de configuração do txAdmin.
2. Crie uma nova implantação de receita usando o modelo oficial ESX Legacy.
3. Forneça a chave do servidor e as configurações do banco de dados documentadas.
4. Permita que a receita implante o banco de dados e os recursos necessários.
5. Revise a configuração gerada, as permissões e a ordem dos recursos.
6. Inicie o servidor de teste e verifique a criação de personagens, a persistência, os trabalhos, as permissões e os logs.

Mantenha as credenciais fora de arquivos e capturas de tela compartilhados. Após a implantação, registre as versões exatas do repositório ou do lançamento para que as verificações de compatibilidade posteriores sejam baseadas em evidências, e não em um rótulo genérico ESX.

Use o caminho de instalação manual apenas quando necessário

A documentação oficial de instalação manual define o escopo completo. Ela cobre os requisitos de oxmysql e spawnmanager, a importação de legacy.sql, o conjunto de recursos principais e adicionais, as exclusões e a ordem de início necessária. Siga essa página como um procedimento único e atual. Não reduza isso a mover es_extended, editando um arquivo de configuração e adicionando um ensure linha.

Atualize um servidor ESX existente com segurança

Primeiro, identifique se o servidor executa o ESX Legacy atual, uma versão mais antiga ou um fork com alterações personalizadas no núcleo. Registre o esquema atual do banco de dados, as versões dos recursos e as modificações locais. Crie um backup restaurável do banco de dados e um snapshot de recursos/configuração antes de substituir qualquer coisa.

Leia as notas de migração e de lançamento entre a versão implantada e a versão alvo. Teste a atualização completa em ambiente de staging com dados de produção representativos. Uma atualização do núcleo pode afetar exports, eventos, dados do jogador, tabelas do banco de dados, integrações de inventário e scripts dependentes. Valide reconexões e reinicializações, bem como um novo personagem.

1. Compare os esquemas e as migrações SQL antes de importá-los.
2. Resolva alterações personalizadas no núcleo explicitamente, em vez de sobrescrevê-las silenciosamente.
3. Verifique cada recurso integrado ao framework em busca de exports, eventos ou identificadores alterados.
4. Teste trabalhos, grupos e comandos permitidos e negados.
5. Revise os logs de cliente, servidor e banco de dados em ações representativas.
6. Mantenha os arquivos anteriores e o backup do banco de dados correspondente até que a implantação seja aceita.

Escolha um script compatível com ESX

Leia as informações de entrega, licença, atualização e suporte específicas do produto. Instale em um servidor de teste correspondente e teste os caminhos de falha, incluindo papéis não autorizados e eventos repetidos. Uma restrição de UI visível não substitui a validação do lado do servidor.

ESX, QBCore ou Qbox

Não há um framework universalmente melhor estabelecido pelas fontes oficiais. O ESX é frequentemente a escolha de menor risco quando os dados de produção existentes, scripts e procedimentos da equipe já dependem do ESX e nenhum benefício de migração testado supera o custo de conversão. O QBCore é um ecossistema de API e recursos separado. O Qbox tem uma ponte QB documentada, mas isso não torna os recursos específicos do ESX automaticamente portáteis.

Use uma comparação de frameworks baseada em recursos necessários, conhecimento da equipe, migração de dados, documentação atual e capacidade de rollback. Ao considerar uma mudança, inventarie identidades, dinheiro, empregos, inventário, veículos, moradia, telefones, bancos, permissões e eventos personalizados antes de escolher um alvo.