Este guia orienta você na configuração do seu servidor FiveM (multiplayer de GTA V) hospedado na Legion Hosting — desde a obtenção da sua chave de licença CFX e configuração do TXAdmin, até a edição do server.cfg e conexão de jogadores.

Pré-requisitos

• Um servidor FiveM da Legion Hosting (ativo na sua conta)
• Uma conta no fórum Cfx.re (gratuita — necessária para gerar sua chave de licença)
• Acesso ao GPanel
• Cliente FiveM instalado no seu PC (fivem.net)

Passo 1: Obtenha Sua Chave de Licença CFX

Todo servidor FiveM requer uma chave de licença única da Cfx.re (os desenvolvedores do FiveM). Esta chave é gratuita e vinculada à sua conta Cfx.re.

1. Acesse https://keymaster.fivem.net/ e faça login com sua conta do fórum Cfx.re.
2. Clique em New Server (ou Register a new server).
3. Preencha os detalhes:
   • Label: Um nome amigável para seu servidor (ex: "My Legion FiveM Server")
   • Server IP Address: Insira o endereço IP do seu servidor do GPanel (veja Como Encontrar o IP e a Porta do Seu Servidor)
   • Server Type: Selecione o tipo apropriado (geralmente "Other / Apache / nginx")
4. Clique em Generate.
5. Copie a chave de licença gerada — você precisará dela nos próximos passos.

Passo 2: Primeira Inicialização do Servidor e Configuração do TXAdmin

Servidores FiveM hospedados na Legion Hosting incluem o TXAdmin — um painel de gerenciamento baseado em web que roda junto com seu servidor FiveM. Na primeira inicialização, o TXAdmin guiará você pela configuração inicial.

Iniciando o Servidor

1. Faça login no GPanel e selecione seu servidor FiveM.
2. Vá até a aba Startup e localize a variável FIVEM_LICENSE (ou similar). Cole sua chave de licença CFX aqui e salve.
3. Vá até a aba Console e clique em Start.
4. Observe a saída do console. Na primeira inicialização, o servidor baixará os artefatos necessários do FiveM — isso pode levar alguns minutos.
5. Quando o TXAdmin estiver pronto, você verá uma mensagem no console contendo a URL do TXAdmin e um código PIN.

Completando a Configuração do TXAdmin

1. Abra a URL do TXAdmin no seu navegador.
2. Insira o PIN exibido na saída do console do GPanel.
3. Crie sua conta de administrador do TXAdmin (usuário e senha).
4. O TXAdmin guiará você através de um assistente de configuração:
   • Server Name: Escolha o nome exibido no navegador de servidores do FiveM.
   • Deployment Type: Selecione um template (ex: "Popular Recipes" para uma base pré-configurada, ou "Remote URL / Template" se você tem uma configuração personalizada).
   • Server Data Folder: Deixe no padrão a menos que você tenha um motivo específico para alterá-lo.
   • CFX Key: Se solicitado novamente, cole sua chave de licença.
5. Complete o assistente e deixe o TXAdmin finalizar a implantação dos arquivos do servidor. Isso pode levar alguns minutos.

Passo 3: Configurar o server.cfg

O arquivo server.cfg é o principal arquivo de configuração do seu servidor FiveM. O TXAdmin gera um básico durante a configuração, mas você vai querer revisá-lo e personalizá-lo.

Acessando o server.cfg

1. No GPanel, clique na aba Files.
2. Navegue até a pasta de dados do servidor (geralmente o diretório raiz ou uma pasta criada pelo template do TXAdmin).
3. Clique em server.cfg para abri-lo no editor inline.

Configurações Essenciais

Um exemplo mínimo de server.cfg:

# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"

# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"

# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"

# Player Limit
sv_maxclients 48

# Privacy
sv_endpointprivacy true

# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

Passo 4: Conectando ao Seu Servidor FiveM

Uma vez que seu servidor esteja configurado e em execução, os jogadores podem se conectar usando o navegador de servidores do FiveM ou uma conexão direta.

Conexão Direta

1. Abra o cliente FiveM.
2. Pressione F8 para abrir o console do FiveM, ou clique no botão Direct Connect na tela inicial.
3. Insira o IP e a porta do jogo do seu servidor no formato IP:PORT.
4. Clique em Connect.

Navegador de Servidores

1. Abra o cliente FiveM e clique em Play.
2. No navegador de servidores, procure pelo nome do seu servidor (o valor de sv_hostname do server.cfg).
3. Clique no seu servidor e depois clique em Connect.

Gerenciando Seu Servidor com TXAdmin

Após a configuração inicial, o TXAdmin fornece um painel web para o gerenciamento diário do servidor. Acesse-o em http://YOUR_SERVER_IP:TXADMIN_PORT.

Obtendo Ajuda

Se você seguiu este guia e ainda está enfrentando problemas:

1. Copie quaisquer mensagens de erro do console do GPanel ou do log do TXAdmin.
2. Anote em qual passo você está travado e o que já tentou.
3. Abra um ticket de suporte em https://legionhosting.net/submitticket.php com essas informações. Nossa equipe ajudará você o mais rápido possível.

Artigos Relacionados

• Recursos, Scripts e Configuração de Banco de Dados do FiveM
• Solução de Problemas do FiveM
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Arquivos via SFTP
• Guia de Inicialização do Servidor