Solução de problemas

Nota

Mais itens serão adicionados conforme o feedback do alfa chegar. Se o seu erro não estiver listado, escreva para [email protected] com as linhas relevantes do log do servidor.

O plugin não carrega

Linha do log: [SM] Unable to load plugin "rookhelm.smx"

Verifique se:

• O SourceMod 1.12 (stable) está instalado em addons/sourcemod/. Versões mais antigas não são suportadas, e o SourceMod 1.13 ainda não é suportado - veja A extensão não carrega por erro de versão abaixo.
• Você extraiu o pacote inteiro, de modo que a pasta addons/ dele se mesclou com a instalação do SourceMod - a extensão (addons/sourcemod/extensions/rookhelm.ext.so) e o plugin companheiro (addons/sourcemod/plugins/rookhelm.smx) precisam estar presentes.
• Os arquivos não estão corrompidos. Baixe o pacote de novo pelo painel e verifique-o contra o SHA256SUMS.

A extensão não carrega por erro de versão

Linha do log: <FAILED> file "rookhelm.ext.so": Extension version is too old to load (8, max is 9) (ou ... too new to load).

Isso significa que a sua build do SourceMod e a extensão do RookHelm foram compiladas contra versões incompatíveis da ABI de extensões. O SourceMod só carrega uma extensão cuja versão reportada cai dentro da faixa que a build em execução aceita, e o SourceMod 1.13 mudou essa ABI - uma extensão compilada para o 1.12 reporta uma versão mais antiga do que o 1.13 aceita (too old), e vice-versa (too new). O Metamod:Source não tem participação nisso; é puramente o carregador de extensões do SourceMod.

O RookHelm atualmente distribui uma extensão, compilada para o SourceMod 1.12 (stable). Para corrigir:

• Rode a branch 1.12 estável do SourceMod (e do Metamod:Source). As builds dev/master são 1.13 e vão rejeitar a extensão atual.
• Se você está testando no 1.13 de propósito, ainda não há alternativa - um único binário de extensão não consegue atender 1.12 e 1.13 ao mesmo tempo, então uma build para 1.13 precisa ser publicada separadamente. Está no roadmap.

Quando a extensão não carrega, o plugin companheiro (rookhelm.smx) também não consegue carregar - ele depende da extensão - então o servidor nunca conecta e permanece como Never connected (nunca conectado) no seu painel. Corrigir a versão do SourceMod resolve os dois.

O servidor não aparece como pendente depois de reiniciar

Depois de soltar o pacote e reiniciar, o servidor deve aparecer em Pending servers (servidores pendentes) no seu painel em cerca de um minuto. Se não aparecer:

1. Confirme que as duas configurações estão presentes. Se você usou o pacote do painel, elas já vêm preenchidas em cfg/sourcemod/rookhelm.cfg, que o plugin carrega automaticamente; se configurou manualmente, verifique se rookhelm_api_url e rookhelm_enrollment_token estão definidos e não vazios no server.cfg.
2. Confirme que os valores batem com a sua página Servers. Baixar o pacote de novo é o jeito mais simples de obter um config correto e pré-preenchido.
3. Confirme que o servidor consegue alcançar o RookHelm. O servidor abre um WebSocket seguro de saída para o rookhelm_api_url; um firewall que bloqueie a porta 443 de saída impede o registro. A maioria dos hosts permite isso por padrão.
4. Procure no log do servidor, perto da inicialização, uma linha do RookHelm descrevendo por que a conexão foi recusada (por exemplo, um token de registro desconhecido).

Se o token foi rotacionado pelo painel, o token de um pacote antigo não funciona mais - baixe um pacote novo.

O servidor está pendente mas não fica online

Um servidor pendente se anunciou, mas ainda não é confiável. Abra a página Servers e clique em Adopt no cartão dele. Só admins e donos podem adotar. Adotar entrega a chave de assinatura do servidor automaticamente - não há nada para copiar.

O nome e o endereço em um cartão pendente são reportados pelo próprio servidor e não são verificados até a adoção, então confirme que o endereço corresponde ao servidor que você espera antes de adotar.

Um servidor adotado aparece offline

O que você vê: o servidor estava online e agora o status é offline (sem heartbeat por mais de dois minutos).

O servidor reconecta sozinho e comprova a chave de novo depois de um reinício, troca de mapa ou oscilação de rede, então uma queda breve costuma se resolver sozinha. Se ele continuar offline:

• Confirme que o processo do servidor de jogo está rodando e acessível.
• Confirme que a porta 443 de saída continua aberta (veja acima).
• Se a chave de assinatura do servidor foi perdida ou a máquina foi refeita, abra a página do servidor e use Reissue keys (reemitir chaves). A nova chave chega ao servidor na próxima reconexão - você nunca a copia à mão.