O server.cfg é um dos arquivos mais importantes do servidor FiveM. Ele define endpoints, nome da cidade, slots, tags, resources iniciados, OneSync, permissões, arquivos auxiliares e chave de licença. Um erro pequeno nesse arquivo pode impedir o servidor de aparecer na lista, travar scripts, quebrar framework ou deixar a cidade sem permissões administrativas. Por isso, configurar o server.cfg com organização é uma das primeiras habilidades que todo dono de cidade precisa aprender.
Onde fica o server.cfg
Em uma instalação comum em VPS, o server.cfg fica na pasta principal dos dados do servidor, muitas vezes chamada de server-data. Ele não precisa ficar misturado com artifacts. Uma estrutura limpa separa o executável do FXServer, os resources, os arquivos de configuração e os backups. Isso facilita atualização e reduz risco de apagar arquivos ao trocar versão do servidor.
Estrutura recomendada
Um arquivo bem organizado deve ter blocos. Comece por rede, depois informações públicas, recursos essenciais, framework, scripts extras, permissões e configurações finais. Evite jogar tudo sem ordem. Quando a cidade crescer, você terá dezenas ou centenas de resources, e a falta de organização vira um problema real.
endpoint_add_tcp 0.0.0.0:30120
endpoint_add_udp 0.0.0.0:30120
sv_hostname "Minha Cidade Roleplay"
sv_maxclients 64
sets locale "pt-BR"
sets tags "brasil, roleplay, fivem, rp"
set onesync on
ensure mapmanager
ensure chat
ensure spawnmanager
exec permissions.cfgEndpoints e portas
Os endpoints informam em qual IP e porta o servidor escuta conexões. O mais comum é usar 0.0.0.0:30120, que aceita conexões externas na porta padrão. Essa porta deve estar liberada no firewall da VPS em TCP e UDP. Se o servidor abre localmente mas ninguém de fora consegue conectar, o problema geralmente está no firewall, regra de rede, porta bloqueada ou endpoint incorreto.
Nome, tags e descrição
O nome do servidor deve ser claro, sem excesso de símbolos, spam ou promessas falsas. Tags ajudam os jogadores a encontrar a cidade por idioma e estilo. Use termos como brasil, roleplay, whitelist, economia, polícia, facção ou casual apenas se fizer sentido. Informações enganosas podem atrair o público errado e aumentar denúncias.
Ordem dos resources
A ordem dos ensure importa. Dependências precisam iniciar antes dos scripts que dependem delas. Por exemplo, biblioteca, banco, framework e inventário geralmente vêm antes de scripts de emprego, loja, garagem e hud. Se um script depende de outro e inicia antes, o console pode mostrar erro de export ausente, evento não registrado ou tabela inexistente.
Separando arquivos com exec
Use exec para separar configurações. Um arquivo permissions.cfg pode guardar ACE. Um voice.cfg pode guardar configurações de voz. Um resources.cfg pode guardar lista extensa de resources. Isso torna o arquivo principal menor e reduz conflitos entre equipe técnica e administração.
Chave de licença
A chave de licença do FiveM deve ser criada nos canais oficiais da Cfx.re e vinculada corretamente ao IP ou ambiente do servidor. Não compartilhe essa chave em prints públicos, repositórios ou grupos. Se ela vazar, troque imediatamente. Em projetos com equipe, limite quem pode ver arquivos sensíveis.
Erros comuns
- Usar aspas erradas copiadas de editores ricos.
- Colocar resource com nome diferente da pasta.
- Iniciar scripts antes das dependências.
- Esquecer de liberar TCP e UDP no firewall.
- Deixar chave de licença exposta.
- Misturar arquivos de teste e produção.
- Copiar configuração de outra cidade sem revisar.
Como testar alterações
Depois de editar o server.cfg, reinicie o servidor em horário seguro ou teste em uma VPS de homologação. Leia o console do início ao fim. Avisos amarelos podem indicar problema futuro, e erros vermelhos precisam de atenção imediata. Se a cidade não iniciar, comente temporariamente os últimos resources adicionados e volte ativando um por um até localizar o responsável.
Conclusão
Um bom server.cfg não é apenas um arquivo que faz o servidor ligar. Ele é a base operacional da cidade. Com organização, separação por arquivos, ordem correta de resources, firewall configurado e segurança com chaves, sua VPS fica mais confiável e pronta para crescer. Sempre documente mudanças e mantenha backup antes de editar configurações críticas.
