Ir para o conteúdo

Porque a tua consola mostra "Server list query returned an error"

Logo a seguir a arrancar (ou reiniciar) um servidor de FiveM, podes ver na consola uma linha parecida com esta:

[citizen-server-impl] Server list query returned an error: server request failed:
server request failed for endpoint https://<ip>:<porta>/dynamic.json
(Get "https://<ip>:<porta>/dynamic.json": EOF)

Não tem qualquer impacto. O teu servidor está em pé, os jogadores conseguem ligar-se ao endereço que aparece no painel, e o aviso desaparece sozinho em poucos minutos.

O que está mesmo a acontecer

O FiveM mantém uma lista pública de servidores num master server. Assim que o teu servidor arranca, envia um heartbeat para esse master, e o master, de tempos a tempos, pede o teu dynamic.json para confirmar que continua online e atualizar os dados (número de jogadores, nome do servidor, etc.).

O master indexa esses endpoints pela tua license key. Se essa mesma licença foi usada antes noutra máquina (mudaste de alojamento, recriaste o servidor ou migraste entre fornecedores), pode acontecer que o master continue a bater num endpoint desatualizado enquanto se sincroniza com o novo. Esses pedidos falham, o master devolve o erro ao teu servidor, e o FiveM despeja o aviso na tua consola.

O que a Zaroz Cloud já trata por ti

Sempre que o teu contentor arranca, nós alteramos o server.cfg para bater certo com o IP e a porta que estão realmente atribuídos. Em concreto, o nosso entrypoint:

  1. Remove quaisquer linhas existentes de endpoint_add_tcp, endpoint_add_udp e set sv_listingIpOverride.
  2. Coloca linhas novas, fixadas na tua porta real e no teu IP público.

Quer dizer, o teu servidor está a anunciar o endereço certo ao master. O erro temporário que vês é só do lado do master, não vem de uma má configuração tua.

Quanto tempo até passar

O master do FiveM atualiza a cache de endpoints depois de alguns heartbeats com sucesso. Na prática:

  • Na maioria dos casos: o aviso desaparece em 2 a 5 minutos.
  • No pior caso: até cerca de 15 minutos depois do primeiro arranque com uma nova atribuição de licença.

Não precisas de reiniciar, mexer no server.cfg, nem abrir um ticket nesse intervalo. Os jogadores que usem o endereço do painel não notam nada.

Quando nos contactar

Avisa-nos se:

  • O erro continuar a aparecer mais de 30 minutos depois de um arranque do zero.
  • Os jogadores não conseguirem entrar usando o endereço do painel.

Nesses casos, envia-nos a linha completa do log e o número da tua encomenda para verificarmos o encaminhamento do nosso lado.