txAdmin e jogadores falsos: guia de integração completo

O txAdmin é a plataforma de gestão de servidores FiveM mais utilizada. O teu pessoal e moderadores usam-no para monitorizar sessões de jogadores, verificar contagens de jogadores e gerir ligações em tempo real. Sem integração com o txAdmin, o teu pessoal veria uma discrepância entre a contagem de jogadores apresentada no browser público de servidores e as sessões visíveis no painel txAdmin. Essa discrepância é um indício óbvio. Conectar um serviço de fake players para FiveM a esse painel mantém os bots visíveis como parte da população do seu servidor onde quer que sua equipe olhe.

Com o FiveFake, os jogadores falsos aparecem dentro do painel web do txAdmin e na lista de jogadores do jogo, de forma idêntica a como os jogadores reais aparecem. Este é o propósito completo da integração com o txAdmin. O teu pessoal vê uma lista de jogadores consistente e nada se destaca.

A configuração é simples. Vai ao painel de controlo do FiveFake, navega até à página do teu servidor e transfere o artefacto que corresponde à versão do teu build do servidor FiveM. Coloca os ficheiros resultantes na pasta de recursos do teu servidor. Depois ativa a opção de integração com o txAdmin. A partir desse momento, os jogadores falsos são visíveis no teu painel txAdmin exatamente como os jogadores reais.

O que precisas antes de começar

1. Um servidor FiveM em funcionamento com o txAdmin instalado e acessível através do seu painel web
2. O endereço IP público do teu servidor e a porta do servidor (a predefinição é 30120 a menos que a tenhas alterado)
3. A porta do teu painel txAdmin (a predefinição é 40120)
4. Uma conta FiveFake com uma subscrição ativa de pelo menos 15 jogadores
5. Uma versão de artefacto FiveM compatível: consulta o guia de compatibilidade de artefactos para os intervalos de versão suportados

Não precisas de modificar o teu server.cfg para além do que já é necessário para executar o txAdmin. Os ficheiros do artefacto vão para a tua pasta de recursos e o resto da integração é gerido do lado do painel de controlo do FiveFake.

Ativar a integração com o txAdmin no painel de controlo

No painel de controlo do FiveFake, navega até à configuração do teu servidor. Vais introduzir três peças de informação: o IP do teu servidor, a porta do teu servidor e uma etiqueta de visualização opcional para distinguires este servidor dos outros na tua conta se gerires vários servidores. Depois ativa a opção de integração com o txAdmin. Não é necessário vinculação de conta, troca de tokens nem fluxo OAuth. O interruptor é tudo o que é preciso.

Após introduzires o IP e a porta, usa a ferramenta de teste de ligação no painel de controlo antes de guardar. A ferramenta de teste envia um pedido de sondagem ao endpoint de ligação do teu servidor e verifica se recebe uma resposta válida. Se o teste falhar, as razões mais comuns são:

• A firewall do teu servidor está a bloquear ligações de entrada na porta 30120 a partir de IPs externos
• O teu servidor não está em funcionamento no momento do teste
• Introduziste o IP da rede local em vez do IP público
• O teu host usa uma porta não padrão diferente de 30120
• O txAdmin está em execução mas o processo do servidor FiveM que gere falhou ou ainda não iniciou

Como as ligações de jogadores falsos aparecem no txAdmin

Assim que as ligações estiverem ativas, abre o teu painel txAdmin e navega até à lista de jogadores. Verás as sessões de jogadores falsos listadas a par de quaisquer sessões de jogadores reais. Cada ligação mostra um nome de jogador, um identificador de servidor e um contador de tempo de atividade. O contador de tempo de atividade dos jogadores falsos incrementa normalmente porque as sessões são mantidas continuamente.

Nomes de jogadores na lista de sessões

Os nomes que aparecem no txAdmin são os nomes que configuraste no painel de controlo do FiveFake. Se estás a usar um dos nossos pacotes de nomes regionais, os nomes refletirão esse pacote. Se editaste diretamente os campos de nome de jogadores falsos individuais, esses nomes aparecem. Se ainda não configuraste nomes, as ligações usam os nomes predefinidos do nosso pacote base, que são nomes genéricos em inglês.

Recomendamos configurar nomes antes da tua primeira ativação. Ver 30 ligações com os nomes Player_1 a Player_30 no teu painel txAdmin é um sinal visual de alerta para qualquer administrador que consulte a lista de sessões sem conhecer o contexto.

Atribuição de identificadores de servidor

O teu servidor FiveM atribui identificadores de servidor sequencialmente à medida que as ligações se juntam. Os jogadores falsos recebem identificadores de servidor no mesmo conjunto que os jogadores reais. Se já tens 5 jogadores reais ligados quando 20 jogadores falsos se juntam, os identificadores de servidor para os jogadores falsos serão do 6 ao 25 ou onde cair o próximo identificador disponível. Este é o comportamento normal.

Verificar que a ligação é estável

Após a ativação, aguarda 90 segundos e depois verifica três coisas para confirmar que a integração está saudável:

1. A contagem de jogadores no painel de controlo do FiveFake corresponde ao número que configuraste
2. A lista de jogadores do txAdmin mostra o número correto de sessões ativas
3. O browser de servidores CFX (servers.fivem.net) mostra a contagem de jogadores do teu servidor atualizada para incluir as novas ligações

A atualização do browser de servidores CFX pode demorar até 5 minutos porque consulta segundo o seu próprio horário. Não esperes que a contagem do browser atualize no momento em que ativas. O painel txAdmin atualiza em tempo real.

Se a contagem no painel de controlo do FiveFake mostra o número correto mas o txAdmin mostra menos, o teu servidor pode estar a aplicar um limite de taxa de ligação. Por predefinição, o txAdmin e o FiveM não impõem limites de taxa de ligação rigorosos para contagens pequenas, mas alguns frameworks de servidor ou scripts personalizados adicionam os seus próprios. Verifica a consola do teu servidor para ver se há mensagens de rejeição de ligação.

Erros comuns e o que significam

As ligações não aparecem no txAdmin

Se ativas jogadores falsos mas não vês nada no txAdmin após 2 minutos, a ligação está a falhar antes de atingir a fase de sessão de jogador. Verifica a consola do teu servidor para ver entradas de rejeição de ligação. A causa mais comum é um recurso no teu servidor que bloqueia ligações a partir de intervalos de IP que não reconhece. Alguns recursos anti-batota ou anti-exploit têm listas de permissão de IP. A nossa infraestrutura de ligação usa um intervalo de IP definido que podes adicionar à lista de permissão nesses recursos.

As ligações aparecem e depois caem

Se as ligações aparecem no txAdmin durante alguns segundos e depois desaparecem, um recurso no teu servidor está a expulsar as ligações após a entrada inicial. Os culpados mais comuns são scripts de validação de sessão que verificam uma licença de jogo válida, scripts que verificam versões do software do cliente, ou gestores de validação de ligação personalizados. Identifica que recurso está a acionar o evento de expulsão verificando o registo de expulsões do txAdmin para o identificador de jogador e a razão da expulsão.

A contagem de jogadores aparece no painel de controlo mas não no browser

Isto é quase sempre um problema de temporização. O browser de servidores CFX não atualiza em tempo real. Aguarda 5 a 10 minutos após a ativação antes de verificares a contagem do browser. Se a contagem ainda não atualizar após 15 minutos, verifica se o teu servidor está listado no browser pesquisando-o diretamente. Alguns servidores não estão listados por escolha ou má configuração, caso em que os jogadores falsos não aparecerão nos resultados públicos do browser mesmo que estejam ligados.

Versões de artefactos e compatibilidade

Os artefactos FiveM são as versões construídas do binário do servidor FiveM. A compatibilidade entre os serviços de jogadores falsos e os artefactos FiveM não está garantida em todos os números de versão. Quando o FiveM atualiza o seu protocolo de handshake de ligação, os serviços de jogadores falsos que não atualizaram a sua lógica de ligação falharão ao estabelecer sessões.

Testamos contra novos lançamentos de artefactos antes de se tornarem estáveis no seletor de artefactos do txAdmin. Quando uma nova versão quebra a compatibilidade, publicamos uma correção em 24 horas. Se estás numa versão que não está no nosso intervalo testado, o painel de controlo mostrará um aviso de compatibilidade antes de tentares ativar. Não ignores esse aviso sem ler os detalhes.

Gerir vários servidores numa conta

Se operas mais de um servidor FiveM, podes gerir todos a partir de uma única conta FiveFake. Cada servidor obtém a sua própria entrada de configuração com contagens de jogadores, horários e pacotes de nomes independentes. A faturação é por jogador em todos os servidores ativos, pelo que o teu custo diário total é a soma de todas as contagens de jogadores configuradas.

O painel de controlo mostra o estado ativo de cada servidor, a contagem atual de jogadores e o estado de saúde da ligação de forma independente. Se um servidor tem um problema de configuração, isso não afeta os outros. Podes pausar os jogadores falsos de um servidor mantendo outro ativo.

Próximos passos

Assim que as tuas ligações estiverem estáveis no txAdmin, o passo seguinte é configurar um horário que reflita o comportamento real dos jogadores para a tua região. Uma contagem fixa de jogadores de 24 horas é o erro mais comum após a configuração inicial.