Este guia orienta-o na configuração do seu servidor FiveM (multijogador de GTA V) alojado na Legion Hosting — desde a obtenção da sua chave de licença CFX e configuração do TXAdmin, até à edição do server.cfg e ligaçã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 a sua chave de licença)
• Acesso ao GPanel
• Cliente FiveM instalado no seu PC (fivem.net)

Passo 1: Obter a Sua Chave de Licença CFX

Cada servidor FiveM requer uma chave de licença única da Cfx.re (os programadores do FiveM). Esta chave é gratuita e está associada à sua conta Cfx.re.

1. Aceda a https://keymaster.fivem.net/ e inicie sessão com a sua conta do fórum Cfx.re.
2. Clique em New Server (ou Register a new server).
3. Preencha os dados:
   • Label: Um nome amigável para o seu servidor (por exemplo, "My Legion FiveM Server")
   • Server IP Address: Introduza o endereço IP do seu servidor a partir do GPanel (consulte Como Encontrar o IP e a Porta do Seu Servidor)
   • Server Type: Selecione o tipo apropriado (normalmente "Other / Apache / nginx")
4. Clique em Generate.
5. Copie a chave de licença gerada — vai precisar dela nos próximos passos.

Passo 2: Primeiro Arranque do Servidor e Configuração do TXAdmin

Os servidores FiveM alojados na Legion Hosting incluem o TXAdmin — um painel de gestão baseado na web que funciona em conjunto com o seu servidor FiveM. No primeiro arranque, o TXAdmin irá guiá-lo através da configuração inicial.

Iniciar o Servidor

1. Inicie sessão no GPanel e selecione o seu servidor FiveM.
2. Vá ao separador Startup e localize a variável FIVEM_LICENSE (ou com nome semelhante). Cole a sua chave de licença CFX aqui e guarde.
3. Vá ao separador Console e clique em Start.
4. Observe a saída da consola. No primeiro arranque, o servidor irá descarregar os artefactos FiveM necessários — isto pode demorar alguns minutos.
5. Quando o TXAdmin estiver pronto, verá uma mensagem na consola contendo o URL do TXAdmin e um código PIN.

Completar a Configuração do TXAdmin

1. Abra o URL do TXAdmin no seu navegador.
2. Introduza o PIN apresentado na saída da consola do GPanel.
3. Crie a sua conta de administrador do TXAdmin (nome de utilizador e palavra-passe).
4. O TXAdmin irá guiá-lo através de um assistente de configuração:
   • Server Name: Escolha o nome apresentado no browser de servidores do FiveM.
   • Deployment Type: Selecione um modelo (por exemplo, "Popular Recipes" para uma base pré-configurada, ou "Remote URL / Template" se tiver uma configuração personalizada).
   • Server Data Folder: Deixe no valor predefinido, a menos que tenha uma razão específica para o alterar.
   • CFX Key: Se for solicitado novamente, cole a sua chave de licença.
5. Complete o assistente e deixe o TXAdmin terminar a implementação dos ficheiros do servidor. Isto pode demorar alguns minutos.

Passo 3: Configurar o server.cfg

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

Aceder ao server.cfg

1. No GPanel, clique no separador Files.
2. Navegue até à pasta de dados do servidor (normalmente o diretório raiz ou uma pasta criada pelo modelo do TXAdmin).
3. Clique em server.cfg para o abrir no editor integrado.

Definiçõ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: Conectar-se ao Seu Servidor FiveM

Quando o seu servidor estiver configurado e em funcionamento, os jogadores podem conectar-se utilizando o browser de servidores do FiveM ou uma ligação direta.

Ligação Direta

1. Abra o cliente FiveM.
2. Prima F8 para abrir a consola do FiveM, ou clique no botão Direct Connect no ecrã inicial.
3. Introduza o IP e a porta de jogo do seu servidor no formato IP:PORT.
4. Clique em Connect.

Browser de Servidores

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

Gerir o Seu Servidor com o TXAdmin

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

Obter Ajuda

Se seguiu este guia e continua a ter problemas:

1. Copie quaisquer mensagens de erro da consola do GPanel ou do registo do TXAdmin.
2. Anote em que passo está bloqueado e o que já tentou.
3. Abra um ticket de suporte em https://legionhosting.net/submitticket.php com esta informação. A nossa equipa irá assisti-lo o mais rapidamente possível.

Artigos Relacionados

• Recursos, Scripts e Configuração de Base de Dados do FiveM
• Resolução de Problemas do FiveM
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Ficheiros via SFTP
• Guia de Arranque do Servidor