Artefactos do FiveM e jogadores falsos: guia de compatibilidade

Os artefactos do FiveM são builds de servidor versionadas que incluem o runtime do servidor de jogo, o carregador de recursos e o código de gestão de ligações. De cada vez que a Rockstar lança uma atualização do GTA ou a equipa do FiveM implementa alterações de plataforma, o número de build do artefacto é incrementado. A compatibilidade dos jogadores falsos está ligada ao artefacto porque o comportamento do handshake de ligação que o teu servidor espera muda com cada geração de build. Manter seu build dentro de uma faixa testada é o que ajuda nosso serviço de fake players do FiveM — os bots que preenchem a população do seu servidor — a se conectar de forma confiável.

Este artigo explica o que são os artefactos, quais os intervalos de build estáveis para ligações de jogadores falsos, como verificar o teu build atual, como fixar o teu servidor a uma versão testada e o que fazer quando uma atualização do jogo altera o handshake. Para o contexto mais amplo, o guia completo de fake players do FiveM explica como todo o sistema se encaixa.

O que são os artefactos do FiveM e por que razão são importantes

Quando instalas um servidor FiveM, descarregas um artefacto de servidor: um binário compilado que inclui o executável do servidor FiveM (FXServer), o runtime de Lua, o sistema de recursos e a camada de rede que gere as ligações dos clientes. O número de versão do artefacto identifica qual build de todo este código estás a executar.

As builds de artefacto são lançadas numa base contínua. A equipa do FiveM mantém três canais de lançamento: recommended, optional e latest. As builds recommended são as mais estáveis. As builds optional incluem funcionalidades mais recentes que passaram nos testes internos mas não nos testes completos dos operadores. As builds latest são as mais recentes e incluem alterações que podem não ser estáveis.

A razão pela qual os artefactos são importantes para a compatibilidade de jogadores falsos é que o handshake de ligação está implementado dentro do artefacto. Quando o artefacto muda a forma como valida as ligações recebidas, a nossa camada de ligação de jogadores falsos tem de ser atualizada para corresponder. Se atualizares o teu artefacto antes de atualizarmos a nossa camada de ligação, os handshakes de jogadores falsos falham.

Como verificar o teu build de artefacto atual

Existem três formas de encontrar o número de build do teu artefacto atual.

1. Painel do txAdmin: O número de build aparece no canto inferior esquerdo da página de resumo do txAdmin, sob as informações do servidor.
2. Consola do servidor: Executa o comando convar_print sv_fxdk_build na consola do servidor. O resultado inclui o número de build do artefacto.
3. Executável FXServer: No Linux, executa ./FXServer --version a partir do diretório do teu servidor. O resultado inclui o número de build.

Assim que tiveres o teu número de build a partir do painel do txAdmin ou da consola do servidor, verifica-o na tabela de compatibilidade do teu painel FiveFake. A tabela mostra os números de build mínimo e máximo em cada intervalo testado, o estado (totalmente compatível, compatibilidade limitada ou incompatível) e a data em que cada intervalo foi testado pela última vez.

Intervalos de build estáveis para ligações de jogadores falsos

Mantemos uma tabela de compatibilidade em tempo real no painel porque os intervalos de build mudam à medida que novos artefactos são lançados e testados. O padrão geral entre gerações de build é:

• Builds dentro do canal recommended atual: totalmente testadas, a camada de ligação está calibrada para este intervalo.
• Builds de 100 a 200 versões atrás do recommended atual: tipicamente compatíveis porque os parâmetros de handshake mudam com pouca frequência dentro de uma versão principal do jogo.
• Builds com mais de 300 versões atrás do recommended atual: podem ter lacunas de compatibilidade dependendo do que mudou nas builds intermédias.
• Builds no canal latest com mais de 50 builds à frente do recommended: não testadas, o comportamento de ligação pode ter mudado antes de termos tido tempo para atualizar.

Como fixar a versão do teu artefacto

Fixar o teu artefacto a um número de build específico evita atualizações acidentais que quebrem a compatibilidade dos jogadores falsos. A abordagem difere consoante a forma como o teu servidor está alojado.

Fixação via txAdmin

O txAdmin tem uma funcionalidade de gestão de artefactos incorporada. Na secção de definições do servidor, podes definir a versão do artefacto para um número de build específico. O txAdmin não atualizará automaticamente o artefacto para além dessa build. Quando quiseres atualizar, altera manualmente a versão fixada e aplica a alteração.

Fixação via gestão direta de ficheiros

Se estiveres a gerir o teu servidor sem o txAdmin ou com uma configuração personalizada, a fixação é feita descarregando a build de artefacto específica diretamente da página de artefactos do FiveM e colocando-a no diretório do teu servidor. Não executes scripts de atualização automática que obtenham o artefacto mais recente no arranque.

A página de transferência de artefactos do FiveM em runtime.fivem.net/artifacts/fivem/ lista todas as builds disponíveis para Windows e Linux. Podes descarregar qualquer build histórica pelo seu número de build. Guarda o número de build da tua configuração estável atual para poderes regressar a ela se uma atualização causar problemas.

O que acontece quando uma atualização do jogo quebra a compatibilidade

Quando uma atualização principal do GTA é lançada, tipicamente muda a versão do jogo do lado do cliente que os clientes FiveM têm de corresponder para se ligarem aos servidores. Isto propaga-se para o artefacto do servidor como uma nova build que inclui validação de ligação atualizada para a nova versão do jogo. Se a nossa camada de ligação não tiver sido atualizada para a nova versão do jogo, os handshakes de jogadores falsos falham porque a versão do cliente que as nossas ligações reportam já não é aceite.

O nosso processo de atualização após uma alteração de versão do jogo:

1. Detetamos a nova versão do jogo a partir dos canais de lançamento públicos do FiveM dentro de horas após o lançamento da atualização.
2. A nossa equipa valida quais as builds de artefacto afetadas e quais são as alterações nos parâmetros de handshake.
3. Atualizamos a nossa camada de ligação para gerir os novos parâmetros de versão.
4. Testamos contra servidores que executam a nova build de artefacto recommended.
5. Implementamos a camada de ligação atualizada nos nossos nós de produção.
6. Anunciamos a atualização no Discord e na página de estado do painel.

Este processo demora tipicamente 24 a 48 horas desde o lançamento da atualização do jogo até a nossa atualização da camada de ligação estar ativa. Durante esta janela, as ligações de jogadores falsos em servidores que atualizaram o seu artefacto para corresponder à nova versão do jogo podem falhar ou ter fiabilidade reduzida.

Gerir atualizações de artefacto sem interromper os teus jogadores falsos

A abordagem mais segura para as atualizações de artefacto quando estás a executar jogadores falsos é um processo de três passos:

1. Aguarda que a equipa do FiveM designe uma build como recommended após uma atualização do jogo.
2. Verifica a tabela de compatibilidade do painel FiveFake para confirmar que a build recommended está no nosso intervalo testado.
3. Só então atualiza o teu artefacto e reconfigura os teus jogadores falsos se necessário.

Se precisares de atualizar o teu artefacto imediatamente por outras razões (um erro crítico do servidor, um problema de compatibilidade de recursos), pausa o agendamento dos teus jogadores falsos antes de atualizar. Após a atualização, verifica se os teus jogadores falsos se reconectam antes de retomar o agendamento.

Interação entre anti-deteção e versão de artefacto

A compatibilidade da versão de artefacto está diretamente ligada à eficácia da anti-deteção. Os parâmetros de ligação que fazem com que os nossos jogadores falsos pareçam legítimos aos sistemas anticheat estão calibrados para builds de artefacto específicas. Executar a nossa camada de ligação contra uma versão de artefacto fora do nosso intervalo testado não arriscas apenas falhas de ligação. Também arriscas ligações que se comportam corretamente o suficiente para se ligar, mas incorretamente o suficiente para serem sinalizadas na validação do anticheat.

Este é o argumento mais forte para permanecer dentro do nosso intervalo de artefacto compatível documentado: não se trata apenas de saber se os teus jogadores se ligam, mas sim de saber se se ligam de uma forma que passa as verificações que o teu sistema anticheat executa.

Considerações sobre artefactos Windows versus Linux

Os artefactos do FiveM estão disponíveis tanto para Windows como para Linux. A maioria dos fornecedores de alojamento que oferecem planos de servidor FiveM executam Linux. Os números de build de artefacto são os mesmos em ambas as plataformas, mas ocasionalmente existem erros específicos da plataforma onde uma build se comporta de forma diferente no Windows versus Linux. Os nossos testes de compatibilidade cobrem ambas as plataformas, e a tabela de compatibilidade do painel assinala problemas específicos da plataforma quando existem.

As ligações de jogadores falsos do FiveFake são agnósticas da plataforma do nosso lado porque são ligações de rede ao endpoint do teu servidor, não integrações com o sistema operativo do teu servidor. O que importa é o número de build do artefacto e o comportamento do handshake, não se o teu servidor executa Windows ou Linux.

Como reportar um problema de compatibilidade

Se estiveres a executar uma versão de artefacto que o nosso painel mostra como compatível mas os teus jogadores falsos não se estão a ligar, as informações mais úteis que podes fornecer ao abrir um pedido de suporte são:

1. O teu número de build de artefacto (verifica o resumo do txAdmin ou a consola do servidor).
2. A mensagem de erro ou motivo de expulsão mostrado na tua consola do txAdmin para as ligações falhadas.
3. Se o problema começou após uma atualização específica de artefacto ou estava presente desde a tua primeira ativação.
4. Quais os sistemas anticheat que estão a correr no teu servidor e os seus números de versão, se disponíveis.
5. Se o problema afeta todos os jogadores falsos ou apenas alguns (as falhas de ligação parciais apontam para limites de vagas, as falhas completas apontam para problemas de handshake).

Os problemas de compatibilidade reportados com esta informação são tipicamente resolvidos dentro de 24 horas porque as informações de diagnóstico nos permitem reproduzir o problema imediatamente na nossa infraestrutura de testes. Quando o problema acaba por ser uma ativação lenta em vez de uma falha de compatibilidade, o guia de velocidade de ativação cobre as causas comuns.

Próximos passos

Se estiveres a configurar um novo servidor e quiseres certificar-te de que a tua configuração do txAdmin está correta antes de ativar jogadores falsos, o

cobre o processo completo de configuração de ligação, incluindo a seleção de artefacto e a configuração do painel do txAdmin.

Assim que souberes qual a versão de artefacto que o teu servidor está a executar e tiveres confirmado a compatibilidade, os ficheiros FiveFake de que necessitas estão na página do teu servidor dentro do painel FiveFake. Cada página de servidor tem um botão de transferência. Clica nele, seleciona a versão de artefacto que corresponde à build do teu servidor FiveM, e coloca os ficheiros resultantes na tua pasta de recursos.