ESX Legacy é um framework de roleplay open-source 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_extendido pasta não é uma configuração completa de servidor, pois o stack suportado inclui trabalho no banco de dados, recursos necessários e uma configuração de inicialização ordenada.
Principais conclusões
- Use a receita oficial ESX Legacy do txAdmin para uma nova instalação.
es_extendidoé a base principal, não o servidor de roleplay completo.- O caminho manual documentado inclui oxmysql, spawnmanager, SQL, exclusões e ordem de recursos.
- Antes de uma atualização, identifique a versão exata ESX ou fork e faça backup tanto do banco de dados quanto dos recursos.
- Verifique cada script de terceiros contra o framework atual, inventário, biblioteca de banco de dados, eventos, exports e dependências.
O que o ESX Legacy fornece
ESX fornece uma base de framework para dados de jogadores e personagens 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_extendido estar instalado.
O oficial Repositório principal ESX é a fonte correta para o código principal atual. Seu es_extendido 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 deployer de receita do txAdmin embutido no FXServer. Selecione o modelo ESX Legacy e complete a configuração guiada atual em vez de copiar uma pasta principal para um diretório de recursos, caso contrário, vazio.
- Prepare um ambiente FXServer atual e abra o fluxo de configuração do txAdmin.
- Crie um novo deploy 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, permissões e ordem de recursos.
- Inicie o servidor de teste e verifique a criação de personagens, persistência, trabalhos, permissões e logs.
Mantenha as credenciais fora de arquivos e capturas de tela compartilhados. Após o deploy, registre as versões exatas do repositório ou lançamento para que verificações de compatibilidade posteriores sejam baseadas em evidências em vez de uma etiqueta genérica ESX.
Use o caminho de instalação manual apenas quando necessário
A documentação oficial de instalação manual define o limite completo. Ela cobre os requisitos de oxmysql e spawnmanager, importando legacy.sql, o conjunto de recursos principais e adicionais, exclusões e a ordem de inicialização necessária. Siga essa página como um único procedimento atual. Não reduza a mover es_extendido, editando um arquivo de configuração e adicionando um garantir linha.
| Área de instalação | Evidências para manter |
|---|---|
| Núcleo e adicionais | Repositório exato, tag ou commit para cada recurso ESX. |
| Banco de dados | Configuração de conexão, SQL importado e um backup pré-mudança. |
| Dependências | oxmysql, spawnmanager e quaisquer bibliotecas específicas do recurso. |
| Pedido | As garantias documentadas e quaisquer exclusões deliberadas. |
| Verificação | Logs de inicialização, persistência de personagens e verificações de permissão. |
Atualizar 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 de banco de dados atual, as versões dos recursos e as modificações locais. Crie um backup restaurável do banco de dados e um instantâneo dos recursos/configurações antes de substituir qualquer coisa.
Leia as notas de migração e lançamento entre a versão implantada e a versão alvo. Teste a atualização completa no ambiente de staging com dados de produção representativos. Uma atualização do núcleo pode afetar exportações, eventos, dados de jogadores, tabelas de banco de dados, integrações de inventário e scripts dependentes. Valide reconexões e reinicializações, bem como um personagem novo.
- Compare esquemas e migrações SQL antes de importá-los.
- Resolva alterações personalizadas no núcleo explicitamente em vez de sobrescrevê-las silenciosamente.
- Verifique cada recurso consciente do framework quanto a exportações, eventos ou identificadores alterados.
- Teste empregos, grupos e comandos permitidos e negados.
- Reveja logs de cliente, servidor e banco de dados sob ações representativas.
- Mantenha os arquivos anteriores e o backup do banco de dados correspondente até que o lançamento seja aceito.
Escolha um script compatível com ESX
Comece com o pagos FiveM and narrow to Scripts ESX. An ESX product label is a starting filter. Confirm the expected ESX version or fork, database library, inventory, target or menu system, SQL changes, events, exports and permissions. Check whether the resource replaces an existing system or integrates with it. Two resources that both own inventory or character initialization can conflict even when each is individually marked ESX-compatible.
Leia as informações específicas do produto sobre entrega, licença, atualização e suporte. Instale em um servidor de teste correspondente e teste caminhos de falha, incluindo papéis não autorizados e eventos repetidos. Uma restrição visível UI não é um substituto para validação no lado do servidor.
ESX, QBCore ou Qbox
Não há um framework universalmente melhor estabelecido pelas fontes oficiais. 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 da conversão. QBCore é um ecossistema de API e recursos separado. 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 retorno. 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 destino.
Próximos passos seguros
- Para uma nova construção, comece a partir da receita oficial atual ESX Legacy txAdmin.
- Para um servidor existente, documente a versão exata e o fork antes de planejar uma atualização.
- Para um novo recurso, verifique todas as fronteiras de integração e estagie-o com um banco de dados representativo.
- Mantenha a informação do framework e os requisitos do produto comercial separados, e verifique ambos antes da compra.
Compare ESX com os outros caminhos do framework
Reveja o mais amplo Comparação de frameworks do FiveM antes de migrar um banco de dados existente, e use o Guia QBCore apenas quando os scripts e o modelo de dados necessários justifiquem essa mudança.
