Como ativar OneSync e aumentar o limite de jogadores FiveM acima de 32

Você definiu sv_maxclients 64 e o servidor ainda limita a 32, ou ignora o valor, ou você recebe um aviso quando tenta. O limite de 32 pertence ao modo de rede antigo. Para ir mais alto você precisa de OneSync, e aqui está como ativá-lo e verificar.

#O que OneSync faz

FiveM tem dois modos de sincronização de jogadores. O antigo, frequentemente chamado legacy, manipula até 32 jogadores. OneSync move o manuseio de entidades para o servidor, que é o que permite mais jogadores, e também o que torna funções de entidade do lado do servidor e state bags funcionarem.

Muitos recursos modernos também esperam OneSync. Por exemplo, recursos de voz como pma-voice dependem dela, e alguns scripts leem entidades do servidor. Se um de seus recursos disser que precisa de OneSync, esta é a configuração.

#Ative OneSync em server.cfg

Adicione esta linha a seu server.cfg:

set onesync on

Depois defina o número de slots:

sv_maxclients 48

Reinicie o servidor inteiro. Estas são convars de inicialização, então restart em um recurso ou uma atualização de configuração não as aplica.

Se você inicia o servidor a partir da linha de comando ou um atalho, você pode passar como argumento em vez disso:

+set onesync on

Dica: coloque set onesync on perto do topo de server.cfg, antes das linhas ensure, para que já esteja ligado quando os recursos começarem.

#Ative OneSync no txAdmin

Versões antigas do txAdmin têm um dropdown OneSync na página de configurações, na seção FXServer. Se você tiver, escolha on e salve. Versões mais novas o deixam de fora e esperam a linha em server.cfg. Se você não conseguir encontrar a opção, use a linha cfg acima, que funciona com ambos.

Tenha cuidado para não defini-la em dois lugares com valores diferentes. Se a configuração do txAdmin e server.cfg discordam, o valor final é difícil de prever. Escolha um lugar.

#Defina sv_maxclients

sv_maxclients é a contagem de slots:

sv_maxclients 48

Notas:

• Deve ser um número inteiro.
• Sem OneSync, qualquer coisa acima de 32 não é aceita.
• O limite superior com OneSync depende da sua chave de licença. Cfx.re vincula o número de slots a níveis de Element Club no proprietário da chave. Se você pedir mais do que sua chave permite, o servidor não lhe dará esses slots. Leia os limites atuais em Cfx.re antes de planejar um servidor grande.
• Mais slots significa mais CPU e largura de banda. Teste com jogadores reais, não apenas o número.

#Verifique que OneSync está ativo

A verificação mais simples é um script de servidor minúsculo. Em um recurso, adicione:

-- server.lua
print('onesync: ' .. GetConvar('onesync', 'off'))

Quando o recurso começar, o console deve imprimir onesync: on.

Se imprimir off, a linha está no arquivo errado, está comentada, ou algo depois a define de volta. Procure por ela:

grep -rn "onesync" server.cfg

No PowerShell do Windows:

Select-String -Path server.cfg -Pattern "onesync"

Lembre-se de que server.cfg pode carregar outros arquivos com exec, então procure neles também.

#Bloqueio de entidade

Com OneSync ligado, você pode controlar se os clientes podem criar entidades (veículos, peds, objetos) por conta própria. O convar é sv_entityLockdown:

set sv_entityLockdown "strict"

No modo strict, apenas o servidor (e recursos executados no servidor) podem criar entidades. Clientes que tentam gerar veículos ou objetos com um cheat ou um script mal escrito não podem. É uma boa defesa, mas também quebra qualquer script do lado do cliente que cria entidades e espera que elas sincronizem.

Use-a apenas se você sabe que seus recursos geram no lado do servidor. Se você ativar e suas lojas, veículos ou props pararem de aparecer para outros jogadores, defina de volta e procure por scripts que geram no cliente. Os valores relaxed e inactive também existem. Não ative o modo strict em um servidor ao vivo sem testar primeiro.

#Problemas comuns

• A linha é ignorada: você editou um server.cfg que o servidor não carrega. Verifique o caminho no console do txAdmin.
• Recursos quebram após habilitá-la: alguns scripts muito antigos usam comportamento legado apenas. Verifique o console para o primeiro erro.
• Carga alta com muitos jogadores: mais slots aumentam o trabalho do servidor. Procure quais recursos custam mais, veja resmon high ms and how to optimize.
• Voz para de funcionar após a mudança: verifique a ordem de recursos de voz e suas configurações, veja pma-voice not working.

#Lista de verificação