Configuração do txAdmin e receitas: implemente um servidor FiveM passo a passo

Você baixou os artefatos do servidor FiveM, iniciou-os, e agora txAdmin está pedindo um PIN, uma conta e um modelo. Este guia o orienta através do primeiro início, vinculando sua conta Cfx.re, escolhendo uma receita e o que acontece durante a implantação.

#Primeiro início e o PIN

No Windows, execute FXServer.exe. No Linux, inicie o run.sh dos artefatos. O primeiro início imprime uma URL de txAdmin e um PIN único no console. Abra a URL no seu navegador e insira o PIN. Apenas a pessoa que pode ler o console do servidor pode fazer isso, que é o ponto.

O PIN funciona apenas uma vez. Se o perder, pare o servidor e inicie novamente para obter um novo, desde que você não tenha concluído a configuração da conta. Se já fez e esqueceu seu login, veja txAdmin esqueceu a senha.

#Vincule sua conta Cfx.re

txAdmin pede que você crie uma conta master. Você a vincula à sua conta Cfx.re, que é a mesma conta que você usa no fórum FiveM e no Cfx.re Portal. Faça login com Cfx.re quando solicitado, depois escolha uma senha de backup para a conta para que você ainda possa fazer login se o login Cfx.re estiver inativo.

Mantenha aquela senha em algum lugar seguro. Você adicionará outros admins posteriormente na página de admin do txAdmin, cada um com suas próprias permissões.

#Nome do servidor e tipo de deploy

O assistente de configuração pede um nome de servidor, depois o tipo de deploy. O texto muda entre versões do txAdmin, mas você verá opções ao longo destas linhas:

• Receitas populares: modelos prontos para usar, incluindo ESX Legacy, QBCore e QBox.
• Modelo de URL remota: uma receita que você cola de um link, por exemplo, um do repositório do próprio framework.
• Modelo local ou receita personalizada: seu próprio arquivo de receita.
• Dados de servidor existentes: você já tem uma pasta de dados do servidor com um server.cfg e quer que txAdmin a execute.

Se este é um novo servidor, escolha uma receita popular. Os frameworks atualizam suas receitas, então você obtém uma configuração atual sem procurar por links de download.

#Escolhendo um modelo

Não tem certeza? Leia instalar ESX Legacy, instalar QBCore e instalar QBox antes de escolher, porque mover frameworks depois significa converter seus dados.

#Pasta e parâmetros da receita

Depois que você escolhe uma receita, txAdmin mostra a pasta de dados do servidor. É onde o deploy coloca server.cfg e a pasta resources. Mantenha-a fora da pasta de artefatos, para que você possa atualizar os artefatos sem tocar nos dados (veja atualizar artefatos do servidor FiveM).

Depois vem um formulário com os parâmetros da receita. Campos típicos:

• Chave de licença Cfx.re: a chave que seu servidor precisa para iniciar. Gere-a no Cfx.re Portal. Se receber um erro sobre isso, leia o erro de chave de licença do servidor.
• Configurações de banco de dados: host, usuário, senha e nome do banco de dados.
• Máximo de jogadores, nome do servidor e outras opções que a receita oferece.

Atenção: a chave de licença é privada. Não poste server.cfg em capturas de tela ou mensagens do Discord sem ocultá-la.

#Credenciais de banco de dados durante o deploy

Frameworks mantêm jogadores, dinheiro, veículos e mais em um banco de dados MySQL ou MariaDB. A receita precisa fazer login para criar suas tabelas. Você tem dois setups usuais:

1. Um servidor de banco de dados que você já executa (um MariaDB local, XAMPP, ou um do seu host). Insira seu host, usuário e senha. O usuário precisa de permissão para criar um banco de dados.
2. Os valores padrão do formulário txAdmin, que se adequam a uma configuração local onde o banco de dados funciona na mesma máquina.

O deploy constrói a string de conexão para você, portanto você não precisa escrevê-la à mão. Em server.cfg você a encontrará como:

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

Se o servidor depois disser que não consegue conectar, a correção está em erro de conexão oxmysql.

#O que a receita realmente faz

Uma receita é uma lista de tarefas que txAdmin executa em ordem. Em termos simples:

1. Baixa recursos: o framework, seus recursos, oxmysql e outras dependências, geralmente como arquivos ZIP do GitHub.
2. Desempacota e move para a pasta resources.
3. Cria o banco de dados e importa o arquivo SQL do framework, usando as credenciais que você inseriu.
4. Escreve server.cfg: seu nome de servidor, chave de licença, string de conexão, linhas ensure e permissões.

Quando o deploy terminar, txAdmin mostra o server.cfg gerado para você revisar. Este é o momento certo para lê-lo linha por linha: veja server.cfg explicado. Você pode editá-lo, depois salvar e iniciar o servidor.

#Depois do deploy

Inicie o servidor no painel de txAdmin e observe o console. Um início saudável termina com os recursos listados como iniciados e nenhum erro em vermelho. Depois conecte-se com FiveM e verifique que você alcança a tela de personagem ou spawn.

Se um recurso falhar, não foi possível iniciar o recurso e lendo um erro de script cobrem o que as mensagens significam. Para seus direitos de admin no jogo, veja permissões ACE.

Dica: faça uma cópia da pasta de dados do servidor e uma exportação do banco de dados logo após um deploy limpo. Se você quebrar algo enquanto experimenta, você pode retornar a um estado conhecidamente bom. O guia de backup mostra como.

#Lista de verificação