$ USD
Guia completo do arquivo server.cfg do FiveM – Configuração completa
O servidor.cfg O arquivo é o coração de cada servidor FiveM. Ele define como seu servidor funciona: slots, rede, criação de jogos, OneSync, registro e visibilidade na lista de servidores. Este guia é para proprietários e desenvolvedores de servidores que desejam padrões seguros, reforço de produção e melhores práticas de desempenho. Sempre mantenha backups e use o controle de versão. Se você é novo, comece com nosso Como criar um servidor FiveM. Para otimizações mais profundas, consulte nosso Centro de desempenho.
Nesta página
TL;DR: Linha de base pronta para produção (anotada)
Uma limpeza servidor.cfg é a base da estabilidade. Abaixo estão dois exemplos: um mínimo configuração de desenvolvimento e um configuração de produção reforçada.
Configuração mínima de desenvolvimento
# server.cfg (desenvolvimento) # Configuração básica para testes locais # Rede endpoint_add_tcp "0.0.0.0:30120" # Vinculação de porta TCP endpoint_add_udp "0.0.0.0:30120" # Vinculação de porta UDP # Informações do servidor sv_hostname "Meu servidor de desenvolvimento" sv_maxclients 8 # OneSync definir onesync em # Recursos (exemplo básico) garantir mapmanager garantir chat garantir spawnmanager garantir sessionmanager garantir hardcap garantir baseevents # Permissões (ACL padrão) exec permissions.cfg
Configuração de produção reforçada
# server.cfg (produção) # Rede endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" # Segurança sv_endpointPrivacy true # Ocultar IP na lista de servidores sv_scriptHook 0 # Desabilitar mods de cliente rcon_password "StrongRconPassword123" # Desabilitar se não for necessário # Slots sv_maxclients 64 # Ajustar à capacidade do host # Build do jogo (use a versão mais recente recomendada) sv_enforceGameBuild 2944 # Ou alias: "mp2024_02" # Informações do projeto sv_hostname "FIVEMX Roleplay | Serious RP" sets sv_projectName "Servidor FIVEMX RP" define sv_projectDesc "RP realista com QBCore e scripts personalizados" define tags "roleplay, seriousrp, qbcore" define locale "en-US" load_server_icon mylogo.png define banner_detail "https://cdn.example.com/banner.png" define banner_connecting "https://cdn.example.com/loading.png" # OneSync define onesync em # Recursos (usar lista de recursos) exec resources.cfg # Registro e ACL define sv_logLevel 2 exec permissions.cfg # Integração txAdmin define mysql_connection_string "mysql://user:pass@localhost/fivemdb"
Dica: Sempre valide sua configuração após edições com verificações de integridade do txAdmin e logs do console. Veja registros do txAdmin.
Informações e listagem do servidor
As seguintes convars controlam como seu servidor aparece no navegador do servidor e API:
| Convar | Propósito | Exemplo | Quando mudar | Advertências |
|---|---|---|---|---|
sv_nome_do_host | Nome público na lista de servidores | sv_hostname "Meu Servidor RP [EN]" | Sempre definido | Evite caracteres especiais, mantenha-se afastado |
define sv_projectName | Nome de exibição do projeto interno | define sv_projectName "MyCommunityRP" | Configuração de marca e multi-servidor | Visível somente na lista da IU |
define sv_projectDesc | Descrição mostrada na lista | define sv_projectDesc "Servidor QBCore RP" | Adicionar regras, idioma, recursos | Mantenha < 100 caracteres |
define tags | Tags da lista de servidores | define as tags "roleplay, carros, qbcore" | Melhore a capacidade de descoberta | Use apenas tags oficiais |
define localidade | Idioma padrão | define a localidade "en-US" | Idioma do servidor de correspondência | Localidade errada pode ocultar o servidor |
sv_endpointPrivacidade | Ocultar IP público no navegador | sv_endpointPrivacy verdadeiro | Recomendado para produção | Os jogadores se conectam via relé Cfx |
ícone_do_servidor_de_carga | Ícone PNG 96×96 | load_server_icon mylogo.png | Para branding | Deve ser quadrado, <96×96 pixels |
define banner_detail | Banner grande na lista de servidores | define banner_detail "url" | Opcional, mas recomendado | Deve ser URL HTTPS |
define banner_connecting | Banner exibido na conexão | define banner_connecting "url" | Bom para branding/carregamento | Use CDN para evitar atrasos |
Veja a [lista oficial de convars][1] para referência completa.
Redes e slots
Os servidores FiveM usam Pontos finais TCP/UDP. Por padrão, a porta 30120 é usado.
endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64
- Execute vários servidores em uma máquina com deslocamentos de porta: por exemplo
30121,30122. - Combine regras de firewall para abrir portas TCP/UDP.
sv_maxclientsafeta diretamente o uso da CPU e da RAM — não defina um valor maior do que seu hardware pode suportar. Veja provedores de hospedagem de servidores
Aviso: Não exponha portas MySQL ou RCON à internet.
Construção e artefatos do jogo
Cada construção de servidor (artefato) corresponde a uma construção do jogo GTA V. Sempre fixar uma construção específica para evitar mudanças inesperadas.
# Exemplo forçando a compilação 2944 (atualização do Los Santos Drug Wars) sv_enforceGameBuild 2944 # ou use o alias enforce_game_build mp2024_02
- [Documento oficial do convars][1] lista números de compilação válidos.
- Definir construção em
servidor.cfgou em txAdmin → Configurações → FXServer → Argumentos adicionais:
+definir sv_enforceGameBuild 2944
- Baixe a última versão artefatos de [runtime.fivem.net][4] (Windows) ou da página de compilação do Linux.
- Nunca misture compilações de cliente e servidor.
Configuração OneSync
O OneSync permite sincronização de entidade do lado do servidor: mais jogadores, estados precisos, melhor streaming. Use sempre OneSync ativado para estruturas modernas (QBCore, ESX).
| Contexto | Efeito | Valor típico | Impacto na CPU/memória | Documentos |
sincronização única | Habilita o OneSync | sobre | Maior uso da CPU | [Documentação OneSync][3] |
população_onesync | Controla NPCs/tráfego local | sobre (opcional) | Adiciona carga de CPU | [Documentação OneSync][3] |
onesync_distanceCullVehicles | Transmita veículos com eficiência | verdadeiro | Melhor desempenho, economiza largura de banda | [Documentação OneSync][3] |
Dica: Escala
sv_maxclientscom hardware. Usar Guia Resmon para medir o impacto dos recursos.
Ordem de início dos recursos e dependências
Os recursos são carregados na ordem definida por garantir. Sempre inicie as dependências primeiro.
# resources.cfg (arquivo dividido) garantir oxmysql garantir qb-core garantir qb-adminmenu garantir qb-inventory garantir qb-policejob garantir my-custom-scripts
Em servidor.cfg:
recursos exec.cfg
- Mantenha as estruturas e os conectores de banco de dados em primeiro lugar.
- Recursos relacionados ao grupo.
- Evitar
garantir *na produção; causa ordem não determinística.
Reforço da segurança e do abuso
Um seguro servidor.cfg evita vazamentos e abusos.
Lista de verificação:
sv_endpointPrivacy verdadeirosv_scriptHook 0(bloquear mods do cliente)- Forte ou incapacitado
rcon_senha - Usar
adicionar_principaleadicionar_acepara ACLs - Ocultar chaves de API em
.env, não emservidor.cfg - Atualize artefatos regularmente
- Monitor registros do txAdmin
- Usar Guia Resmon para pegar scripts pesados
Exemplo de ACL:
comando add_ace group.admin permite identificador add_principal.steam:110000112345678 group.admin
CDN e streaming de ativos (quando usar)
Para grandes MLOs, carros personalizados e texturas, use um CDN para reduzir tempos de junção.
- Hospedar arquivos em um CDN como Cloudflare R2 (definir [cabeçalhos CORS][6]).
- Para alto desempenho, BunnyCDN suporta [solicitações de intervalo][7] (necessário para
.rpftransmissão). - Adicione URLs versionadas para evitar conflitos de cache.
Veja nosso Otimize os tempos de carregamento guia.
Mitos e sinalizadores obsoletos
Muitas configurações on-line ainda mostram cvars do mecanismo de origem como:
sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60
Não utilizar. Eles não são suportados no FiveM e não têm efeito. Veja [convars oficiais][1].
Convars obsoletos/legados:
sv_mestre1→ não é mais necessário.sv_useDirectListing→ substituído porsv_endpointPrivacidade.
Validação e solução de problemas
Verificações de chave após a edição servidor.cfg:
| Sintoma | Causa provável | Consertar | Tempo |
| Servidor não inicia | Erro de sintaxe na configuração | Verifique o console e remova as linhas inválidas | 5m |
| Não está na lista de servidores | Ausente sv_nome_do_host/etiquetas | Adicione nome de host/tags, verifique o firewall, sv_mestre1 | 10m |
| Os jogadores não conseguem se conectar | Portas fechadas / IP errado | Abra 30120 TCP+UDP, verifique endpoint_add_* | 15m |
| Alto uso da CPU | Muitos slots / scripts ruins | Mais baixo sv_maxclients, usar Ajuste de desempenho | 20m |
| Longos tempos de carregamento | Grandes ativos não otimizados | Usar Otimize os tempos de carregamento + CDN | 20m |
| Travamentos após atualização | Incompatibilidade de construção | Alfinete sv_enforceGameBuild, atualizar [artefatos][4] | 15m |
Recursos internos e próximos passos
Perguntas frequentes
1. O que é servidor.cfg no FiveM?
É o arquivo de configuração principal que define o nome do servidor, slots, recursos, rede, segurança e visibilidade.
2. Onde devo colocar servidor.cfg?
Dentro da pasta raiz do seu servidor (ao lado de servidor.exe ou Servidor FX ponto de entrada). O txAdmin o carrega automaticamente.
3. Qual é a diferença entre definir, conjuntos, e conjunto?
definir: variável somente do servidor.conjuntos: aparece na lista de servidores (informações públicas).conjunto: sincronizado com clientes.
4. Meu servidor não aparece na lista. Por quê?
Verificar sv_nome_do_host, define tags, define localidade, e sv_endpointPrivacidade. Certifique-se também de que suas portas estejam abertas.
5. Como posso aumentar os slots de jogadores?
Mudar sv_maxclients. Escale gradualmente e monitore com Guia Resmon. Certifique-se de que seu hardware e rede podem suportar isso.
6. O que é sv_enforceGameBuild?
Uma convar que força os clientes a usar uma versão específica do jogo GTA V. Evita travamentos causados por versões incompatíveis. Consulte [documentação Convars][1].
7. Devo usar números de compilação ou aliases?
Qualquer um funciona. Numérico (2944) é explícito; alias (mp2024_02) é mais fácil de rastrear. Ambos são suportados.
8. Onde eu coloco sv_enforceGameBuild no txAdmin?
Em txAdmin → Configurações → FXServer → Argumentos adicionais. Exemplo: +definir sv_enforceGameBuild 2944.
9. O que é OneSync?
Um sistema que permite mais jogadores, streaming preciso de entidades e autoridade de servidor. Necessário para frameworks modernos. Consulte [documentação do OneSync][3].
10. Infinity ou OneSync antigo?
Legado = até 64 slots. Infinito = suporta mais de 128, sincronização avançada de entidades. Sempre use onesync ativado (Infinito por padrão).
11. Como organizo os recursos?
Usar recursos exec.cfg. Inicie os conectores do banco de dados primeiro, depois os frameworks e, por fim, os jobs/scripts. Evite garantir *.
12. Meus banners não aparecem na lista de servidores.
Certifique-se de que as URLs sejam HTTPS, públicas e apontem para os tamanhos de imagem corretos. Use uma CDN para maior confiabilidade.
13. Para que servem os logs do txAdmin?
Eles mostram erros, travamentos, problemas de recursos. Veja registros do txAdmin.
14. Como posso verificar problemas de desempenho?
Usar resposta 1 no console. Veja nosso Guia Resmon para mais detalhes.
15. Os sinalizadores de taxa do mecanismo de origem são necessários?
Não. sv_maxrate, sv_minrate, sv_maxupdaterate não faça nada no FiveM. Use [Convars doc][1] em vez disso.
Créditos:
