Alugar e configurar um servidor FiveM – Guia de roleplay

Um servidor FiveM precisa de mais do que apenas uma instância de GTA V em execução: precisas de uma chave de licença Cfx.re, uma decisão clara de framework, uma server.cfg limpa e recursos controlados. Na game-serverhosting, configuras o servidor como alojamento multi-game pago, com controlo técnico, suporte e processos operacionais transparentes.

Requisitos

Para teres o teu próprio servidor de roleplay FiveM, precisas de uma instalação válida de GTA V para o cliente, um cliente FiveM, um servidor na game-serverhosting e uma chave de licença de keymaster.fivem.net. O Keymaster é o local oficial da Cfx.re para gerir chaves de servidor; usa a conta com a qual pretendes operar o servidor mais tarde.

Antes de encomendares, planeia que tipo de servidor queres criar. Um pequeno servidor de teste com poucos recursos tem requisitos diferentes de um projeto de roleplay com jobs, base de dados, inventário, housing, veículos e muitos jogadores simultâneos. Usa 4 GB de RAM para pequenos testes e 8 GB para RP com scripts apenas como valores iniciais; decide com base na carga medida. Deves entender estes valores como orientação prática, não como garantia para todas as combinações de recursos.

Se também estás a comparar outros projetos de survival ou RP, o guia para alugar e configurar um servidor Rust e o guia completo para alugar um servidor Minecraft também te ajudam, porque ali são explicadas decisões semelhantes sobre slots, mods, backups e administração.

Encomendar o servidor e definir os dados básicos

Vai a game-serverhosting, escolhe o teu servidor FiveM e decide-te por uma configuração que combine com o teu projeto. Para uma operação apenas de teste, podes começar pequeno. Para um servidor RP público, deves prever reservas para base de dados, voz, framework, recursos adicionais e picos de utilização.

Depois da disponibilização, insere a tua chave de licença FiveM no dashboard, caso o painel ofereça um campo próprio para isso. Em alternativa, a chave é definida na server.cfg. Trata a chave como um documento de acesso: não a publiques, não a mostres em capturas de ecrã e não a guardes em repositórios livremente acessíveis.

Escolher o framework

A escolha do framework marca o teu servidor mais do que quase qualquer recurso individual posterior. Não mudes de framework sem cuidado se já tiveres criado jobs, tabelas de base de dados e progresso dos jogadores.

Para um servidor clássico de GTA RP, ESX e QBCore são as opções mais óbvias. O ESX está bem documentado devido à sua ampla utilização e costuma ser mais acessível para muitos iniciantes. O QBCore é muitas vezes interessante se quiseres trabalhar de forma mais estruturada e manter conscientemente uma configuração mais moderna. O VORP não pertence ao contexto de GTA V FiveM, mas sim ao RedM para roleplay de Red Dead; por isso, não o leves por engano para um projeto FiveM.

Configurar a server.cfg

A server.cfg é a configuração central de arranque. Mantém-na legível, versiona as tuas próprias alterações de forma limpa e não adiciones recursos ao acaso. Cada recurso adicional pode aumentar o tempo de carregamento, a carga da base de dados ou as fontes de erro.

sv_hostname "O meu servidor RP FiveM"
sv_maxclients 32
sv_licenseKey "a-tua-chave-de-licenca"

# txAdmin
exec @txAdmin/config.cfg

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

Adapta sv_hostname ao nome do teu servidor e define sv_maxclients de acordo com o teu plano e o estado do teu projeto. O valor sv_licenseKey tem de conter a tua chave FiveM real. As linhas ensure iniciam recursos pela ordem indicada. Em frameworks e dependências, esta ordem é importante: adaptadores de base de dados e bibliotecas partilhadas têm de iniciar antes dos recursos que acedem a eles.

Usar o txAdmin

txAdmin é o painel de gestão do servidor para a operação contínua. Usas-o para administração do servidor, gestão de jogadores como kick, ban e warn, gestão de recursos e monitorização de performance. Especialmente em projetos de roleplay, o txAdmin é prático porque não precisas de tratar todas as tarefas administrativas diretamente através de ficheiros ou da consola.

Define cedo quem recebe acesso de admin. Atribui permissões com moderação e documenta alterações em recursos críticos. Assim continua a ser possível perceber se um problema surgiu por causa de uma atualização, um novo recurso, uma alteração de configuração ou ações de jogadores.

Instalar recursos

Encontras recursos, entre outros locais, no fórum Cfx.re, por exemplo na área Development Releases. Antes da instalação, verifica se um recurso ainda é mantido ativamente, se combina com o teu framework e se precisa de dependências adicionais.

1. Transfere recursos de cfx.re.
2. Extrai-os para a pasta resources/.
3. Adiciona ensure nome-do-recurso à server.cfg.
4. Reinicia o servidor.

Recursos populares para RP são es_extended como framework ESX, esx_policejob para jobs de polícia, esx_ambulancejob para serviços de emergência, esx_mechanicjob para mecânicos, gcphone como telemóvel ingame e dpemotes para emotes e animações. Instala estes blocos passo a passo. Se ativares dez recursos ao mesmo tempo, a procura de erros torna-se desnecessariamente difícil.

Verificar o resultado

Depois da configuração, verifica primeiro a consola do servidor. Não devem aparecer erros óbvios sobre ficheiros em falta, ligações à base de dados, recursos duplicados ou valores de configuração inválidos. Depois abre o txAdmin e confirma se o servidor está acessível, se os recursos foram carregados e se não aparecem avisos permanentes.

Em seguida, liga-te com o cliente FiveM. Verifica o spawn, o chat, interações básicas e, em frameworks de RP, pelo menos login, criação de personagem, inventário e um fluxo simples de job. Se estás a planear servidores de outros jogos em paralelo, encontras passos de verificação semelhantes no guia para alugar e configurar um servidor Palworld e no guia cooperativo para alugar e configurar um servidor Valheim.

Troubleshooting

Se o servidor não arrancar, verifica primeiro a chave de licença, a server.cfg e o último recurso instalado. Uma chave inserida incorretamente, um erro de digitação em ensure nome-do-recurso ou uma pasta em falta é suficiente para impedir o arranque ou para não carregar recursos.

Se os jogadores não conseguirem ligar-se, verifica o estado do servidor, os slots, as liberações de firewall ou rede no painel e a consola do FiveM. Se apenas faltarem determinadas funções, o problema normalmente não está no próprio servidor, mas sim nos recursos, nas dependências do framework ou nas tabelas da base de dados.

Em caso de problemas de performance, remove temporariamente os recursos instalados mais recentemente, observa o txAdmin e verifica se ocorrem erros em loops. Muitos pequenos erros de script podem ter mais impacto do que um único recurso grande. Por isso, trabalha com backups, notas de alteração e pequenos passos de instalação.

Verificação, limites e caminho seguro de retorno

O guia “Alugar e configurar um servidor FiveM – Guia de roleplay” aplica-se ao tipo de servidor descrito no artigo e ao estado de versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem variar depois de atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.

Antes de alterações ao mundo, ao estado do jogo, à configuração ou a extensões, cria um backup dos ficheiros afetados. Depois altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que pretendes jogar mais tarde.

Um teste individual bem-sucedido não é garantia de desempenho nem de disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, caminho de rede e carga simultânea podem alterar o resultado. Documenta versão, alteração e resultado do teste para conseguires perceber desvios posteriores.

FAQ

Preciso obrigatoriamente de uma chave de licença FiveM?

Sim. Para um servidor FiveM, precisas de uma chave de servidor do Keymaster oficial da Cfx.re em keymaster.fivem.net. Sem uma chave corretamente inserida, uma operação regular não é viável de forma sensata.

ESX ou QBCore é melhor para o meu servidor RP?

ESX é muitas vezes uma boa entrada, porque é muito usado e existem muitos recursos para ele. QBCore encaixa melhor se quiseres trabalhar conscientemente com um framework de estrutura mais moderna. O ponto decisivo é que todos os recursos importantes combinem com a tua escolha.

Quantos recursos devo instalar no início?

Começa com o framework, as dependências obrigatórias e poucas funções centrais. Depois instala recurso a recurso e testa de cada vez. Assim encontras erros mais rapidamente e evitas dependências confusas.

O que faço se o servidor já não arrancar depois de um novo recurso?

Desativa a última linha ensure adicionada, reinicia o servidor e verifica a consola. Se o servidor voltar a funcionar, verifica o nome da pasta, as dependências, a compatibilidade com o framework e as instruções de instalação desse recurso.

Posso partilhar a chave de licença publicamente?

Não. Trata a chave de licença como confidencial. Não a publiques em capturas de ecrã, posts de fóruns ou repositórios públicos, porque ela está associada à operação do teu servidor.