O ESX Legacy é um framework de roleplay de código aberto para FiveM. Para um servidor novo, use o modelo oficial ESX Legacy no txAdmin ou siga a documentação oficial completa de instalação. Instalar apenas a pasta es_extended não configura um servidor completo, pois o conjunto compatível inclui trabalho no banco de dados, recursos exigidos e uma configuração ordenada de inicialização.
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 repositório oficial do core do ESX é a fonte correta do código atual do core. Seu manifesto de es_extended declara oxmysql como dependência. Use a documentação oficial e o histórico de versões para identificar o que você tem; evite pacotes aleatórios anunciados apenas como o ZIP mais recente do 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.
- Prepare um ambiente FXServer atual e abra o fluxo de configuração do txAdmin.
- Crie uma nova implantação de receita usando o modelo oficial ESX Legacy.
- Forneça a chave do servidor e as configurações do banco de dados documentadas.
- Permita que a receita implante o banco de dados e os recursos necessários.
- Revise a configuração gerada, as permissões e a ordem dos recursos.
- 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 aborda os requisitos de oxmysql e spawnmanager, a importação de legacy.sql, o conjunto de recursos centrais e adicionais, as exclusões e a ordem exigida de inicialização. Siga essa página como um único procedimento atual. Não reduza o processo a mover es_extended, editar um arquivo de configuração e adicionar uma linha ensure.
| Área de instalação | Evidências a manter |
|---|---|
| Núcleo e complementos | Repositório, tag ou commit exatos para cada recurso ESX. |
| Banco de dados | Configuração de conexão, SQL importado e backup pré-alteração. |
| Dependências | oxmysql, spawnmanager e quaisquer bibliotecas específicas do recurso. |
| Ordem | Os comandos ensure documentados e quaisquer exclusões deliberadas. |
| Verificação | Logs de inicialização, persistência de personagem e verificações de permissão. |
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.
- Compare os esquemas e as migrações SQL antes de importá-los.
- Resolva alterações personalizadas no núcleo explicitamente, em vez de sobrescrevê-las silenciosamente.
- Verifique cada recurso integrado ao framework em busca de exports, eventos ou identificadores alterados.
- Teste trabalhos, grupos e comandos permitidos e negados.
- Revise os logs de cliente, servidor e banco de dados em ações representativas.
- 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.