server.cfg explicado: cada linha do FiveM server.cfg, uma por uma

Você abriu o server.cfg e viu uma parede de linhas que copiou de uma receita. Este guia passa por todas as linhas que você encontrará na maioria dos servidores, na ordem em que costumam aparecer, com uma breve explicação e um link para um guia mais detalhado.

#Endpoints

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Esses são o endereço e a porta onde o servidor ouve. 0.0.0.0 significa cada interface de rede, e 30120 é a porta padrão. Os jogadores se conectam via UDP e usam TCP para HTTP e o proxy do txAdmin, então você abre ambos no seu firewall. Com o txAdmin, a interface e a porta geralmente são gerenciadas para você, e as configurações do txAdmin podem reclamar se não coincidirem. Se os jogadores não conseguem entrar de fora, veja encaminhamento de porta.

#Nome e listagem

sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay, esx, english"
sets locale "en-US"
load_server_icon myLogo.png

• sv_hostname é o nome antigo do servidor.
• sv_projectName e sv_projectDesc são o nome e a descrição na lista de servidores. A forma sets os publica.
• tags são as palavras-chave pelas quais as pessoas filtram, e locale é o idioma.
• load_server_icon carrega um pequeno PNG da pasta do servidor.

Cores, banners e o tamanho do ícone são cobertos em ícone do servidor, banner e tags.

#Jogadores

sv_maxclients 48

O número de slots de jogadores. Ir acima de 48 requer OneSync e um nível de apoiante no lado do Cfx.re. Os detalhes estão em OneSync e o limite de jogadores.

#Chaves

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
set steam_webApiKey "none"

sv_licenseKey é a chave do Cfx.re Portal, e o servidor não iniciará sem uma chave válida. Veja erro de license key do servidor. steam_webApiKey só é necessário se você quiser identificadores Steam, e none é aceito quando você não quer. Ambas as linhas são segredos: não compartilhe seu server.cfg em capturas de tela.

#Banco de dados

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

A string de conexão que oxmysql lê. Valores errados geram os erros em erro de conexão oxmysql. Use set, não setr ou sets, para que a senha permaneça no servidor.

#OneSync e construção do jogo

set onesync on
sv_enforceGameBuild 3258

onesync on ativa o OneSync, que é o padrão para servidores modernos e necessário para muitos slots. sv_enforceGameBuild força os clientes a usar uma construção específica do jogo, e carros DLC, roupas e mapas precisam de uma recente. Os números de construção e o que eles desbloqueiam estão em sv_enforceGameBuild e DLC. Use um número de construção suportado por seus artefatos, não apenas o do exemplo.

#Recursos: ensure

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [standalone]

Cada ensure inicia um recurso ou uma pasta de colchetes inteira. A ordem importa: bancos de dados, bibliotecas e o framework primeiro. Veja ordem ensure do server.cfg. Se um falhar, não foi possível iniciar o recurso explica a mensagem.

#Permissões: add_ace e add_principal

add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

add_ace dá uma permissão a um grupo, aqui todo comando. add_principal coloca um jogador (por identificador) naquele grupo. Substitua o identificador pelo seu. A explicação completa, com a diferença entre ACE e os grupos do seu próprio framework, está em permissões ACE.

#Incluindo outros arquivos: exec

exec permissions.cfg
exec resources.cfg

exec executa outro arquivo cfg como se suas linhas estivessem aqui. Dividir permissões ou recursos em seus próprios arquivos mantém o server.cfg legível, e você pode manter os segredos em um arquivo que nunca compartilha.

#Um exemplo mínimo

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_licenseKey "cfxk_..."
sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay"
sets locale "en-US"
load_server_icon myLogo.png
sv_maxclients 48
set onesync on
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended

Atenção: um erro de digitação em uma linha nem sempre interrompe o servidor. Uma convar digitada incorretamente é criada silenciosamente e não faz nada. Quando uma configuração parece ser ignorada, verifique a ortografia primeiro.

#Lista de verificação