Como instalar ESX Legacy em um servidor FiveM: receita e manual

Você quer um servidor FiveM executando ESX Legacy, e quer saber qual maneira instalar. Existem duas: uma receita txAdmin, que faz tudo, e uma instalação manual, onde você coloca cada peça você mesmo. Este guia cobre ambas, depois o que verificar em seu primeiro login e os erros que você é mais provável de ver.

#Opção 1: a receita txAdmin

Esta é a rota recomendada. Na configuração do txAdmin, escolha o template ESX Legacy das receitas populares. Siga os passos em Configuração txAdmin e receitas: insira sua chave de licença e credenciais de banco de dados, então revise o server.cfg gerado e inicie o servidor.

A receita faz download de es_extended e dos recursos principais, oxmysql e ox_lib, cria o banco de dados e importa o arquivo SQL do ESX. Quando terminar, você tem uma base funcionando. Pule para "Verificações de primeiro login".

#Opção 2: instalação manual

Faça isso quando adicionar ESX a um servidor que você construiu você mesmo. Você precisa de um FXServer em execução, um banco de dados MySQL ou MariaDB e uma chave de licença.

#1. Faça download dos recursos

Das versões ESX Legacy, obtenha o pacote principal (es_extended e os recursos principais que usa, como os recursos de identidade, menu e notificação). Coloque-os em sua pasta resources, por exemplo em resources/[esx]. Você também precisa de:

• oxmysql, a camada de banco de dados.
• ox_lib, uma dependência comum para recursos ESX modernos.
• Um inventário. Muitos servidores ESX Legacy usam ox_inventory. Siga a documentação da versão que você faz download, porque a configuração padrão pode mudar entre versões.

#2. Crie o banco de dados e importe o SQL

Crie um banco de dados vazio, por exemplo esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Então importe o arquivo SQL que vem com es_extended (procure por um arquivo .sql em sua pasta, nomeado legacy.sql no momento da escrita). Use HeidiSQL, phpMyAdmin ou a linha de comando mysql. Sem ele, você encontrará erros de tabela não existe.

#3. Edite server.cfg

Defina a string de conexão e inicie os recursos em uma boa ordem:

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

A ordem é explicada em ordem de garantir server.cfg. Se você usar os recursos de identidade ESX ou multitamanho, certifique-se de que apenas um recurso de seleção de personagem seja executado.

#Verificações de primeiro login

Inicie o servidor e leia o console de cima para baixo antes de se juntar. Então verifique:

1. oxmysql se conecta. Há uma linha sobre a conexão do banco de dados e nenhum erro vermelho logo após.
2. es_extended inicia sem erros.
3. Você pode se juntar e chegar à criação de personagem ou desova.
4. Sua linha de jogador existe. Após se juntar, você deve ver uma linha para você mesmo na tabela users.
5. Dinheiro e trabalho carregam. Abra seu inventário ou execute um comando que imprime sua conta e trabalho.

Para direitos de admin, defina seu group para admin em sua linha users, então reconecte. Para txAdmin e comandos ACE, veja Permissões ACE.

#Erros comuns de primeira

ESX é nulo em um script. Um recurso que ainda usa uma forma antiga de obter ESX mostra:

attempt to index a nil value (global 'ESX')

A forma moderna é ESX = exports['es_extended']:getSharedObject(). Veja ESX é nulo: corrigindo esx:getSharedObject e sem tal export getSharedObject em es_extended.

Não pode se conectar ao banco de dados. A string de conexão está errada, o banco de dados não está em execução, ou o usuário não tem direitos. Veja erro de conexão oxmysql.

Um recurso não inicia. Frequentemente uma dependência ausente ou um nome de pasta errado. Veja não foi possível encontrar dependência e não foi possível iniciar recurso.

Jogadores presos na tela de carregamento. Procure no console o recurso que erra durante a junção. Veja jogadores presos na tela de carregamento.

Dica: quando você adiciona um script, adicione um de cada vez e reinicie. Se um erro aparecer, você sabe qual script o causou.

#Adicionando trabalhos e itens

Uma vez que a base funciona, as próximas tarefas são trabalhos e itens. Adicione um trabalho no ESX mostra as linhas de banco de dados que você precisa. Para itens, a forma depende de seu inventário: veja ox_inventory adicione itens.

#Checklist