Instale o plugin do RookHelm

Este guia mostra como conectar um servidor de jogo Source 1 ao RookHelm. O caminho mais rápido é o pacote de plugins do seu painel: um download, solte no lugar, reinicie e adote o servidor com um clique. Nada de editar configuração.

Jogos suportados

O RookHelm distribui um único pacote de plugins para todos os jogos Source 1 que rodam SourceMod. O suporte vem do SourceMod, não de uma lista de jogos permitidos: se o seu jogo roda SourceMod 1.12, o plugin carrega e funciona do mesmo jeito.

Jogo	Engine	Status
Team Fortress 2	Source	Suportado
Counter-Strike: Source	Source	Suportado
Day of Defeat: Source	Source	Suportado
Left 4 Dead 2	Source	Suportado
Half-Life 2: Deathmatch	Source	Suportado
Qualquer outro jogo rodando SourceMod	Source	Suportado
Garry’s Mod	Source	Ainda não suportado
Counter-Strike 2	Source 2	Ainda não suportado

O Garry’s Mod não roda o SourceMod padrão, então precisa de suporte dedicado - está planejado, mas ainda não disponível.

Quer suporte para um jogo que não está na lista? Escreva para [email protected] - os pedidos definem o que ganha suporte em seguida.

Antes de começar

Você vai precisar de:

• SourceMod 1.12 (stable) instalado em addons/sourcemod/.
• Acesso aos arquivos do seu servidor de jogo (FTP, SSH ou o gerenciador de arquivos do seu host).
• Um assento de admin em uma comunidade RookHelm - o pacote de plugins fica na página Servers do seu painel. (Ainda sem comunidade? Solicite acesso.)

SourceMod 1.13 is not yet supported

O RookHelm atualmente distribui uma única extensão compilada para o SourceMod 1.12. O SourceMod 1.13 (as builds master/dev) introduziu uma ABI de extensões nova e incompatível, então a extensão atual do RookHelm não carrega nele - você verá Extension version is too old to load no log do servidor. Rode a branch estável 1.12 do SourceMod (e do Metamod:Source) até uma build para 1.13 ser publicada. Se isso acontecer com você, veja Solução de problemas.

Você não precisa instalar o REST in Pawn nem nenhuma outra extensão separadamente - a extensão do RookHelm já vem no pacote. Você também não copia nenhuma credencial por servidor à mão; o servidor recebe a própria chave automaticamente quando você o adota.

Passo 1 - Baixe o pacote de plugins

Na página Servers, clique em Download plugin bundle (baixar pacote de plugins). Você recebe o rookhelm-sourcemod-<community>.zip, que contém:

• A extensão RookHelm para SourceMod e seu plugin companheiro.
• cfg/sourcemod/rookhelm.cfg, já preenchido com as duas configurações da sua comunidade (rookhelm_api_url e rookhelm_enrollment_token).
• README.txt e os textos de licença.

O token de registro é o mesmo para todos os servidores da sua comunidade, então o mesmo pacote funciona na frota inteira. Baixar de novo é seguro - isso não rotaciona seu token.

Nota

O pacote embute o token de registro da sua comunidade. Ter o token só permite que um servidor se anuncie na sua lista de pendentes - ele não dá acesso a banimentos, mutes nem a nenhum dado da comunidade até você adotar o servidor explicitamente. Ainda assim, trate o zip como qualquer configuração com credenciais: não o publique em lugar nenhum.

Passo 2 - Solte no lugar e reinicie

Extraia o zip no diretório do mod do seu jogo, de modo que as pastas addons/ e cfg/ se mesclem com a instalação existente:

unzip rookhelm-sourcemod-*.zip -d /path/to/srcds/

Depois reinicie o servidor. Na inicialização, o plugin carrega automaticamente o cfg/sourcemod/rookhelm.cfg que vem no pacote, lê as duas configurações, abre uma conexão com o RookHelm e se anuncia.

Nota

Não há nada para editar. O pacote pré-preenche as duas configurações em cfg/sourcemod/rookhelm.cfg, e o plugin carrega esse arquivo na inicialização, então você nunca adiciona uma linha ao server.cfg nem copia uma credencial à mão.

Passo 3 - Adote o servidor

De volta à página Servers, o servidor aparece em Pending servers (servidores pendentes) em cerca de um minuto, mostrando o nome e o endereço que ele mesmo reporta. Clique em Adopt. Adotar gera a chave de assinatura do servidor e a entrega automaticamente - não há nada para copiar.

Todo servidor, incluindo o primeiro de uma comunidade recém-criada, espera por um clique explícito de adoção. Isso é proposital: um servidor não tem poder nenhum até você confirmar que ele é seu.

Como saber que deu certo

Depois de adotado, o status do servidor muda para Online assim que o primeiro heartbeat chega, geralmente em poucos segundos. A partir daí, banimentos, mutes e contagens de jogadores começam a fluir para o seu painel.

Se você iniciou o download pelo painel, o cartão de instalação na página Servers avança sozinho - dos passos de instalação para “Server detected” (servidor detectado) quando a linha de pendente aparece, e para “Heartbeat received. Plugin installed” quando o servidor adotado se reporta.

Verifique o download (opcional)

Toda versão inclui um arquivo SHA256SUMS. Para confirmar que o pacote chegou intacto:

sha256sum -c SHA256SUMS
# Expected: "rookhelm-sourcemod-v<version>.zip: OK"

Os binários publicados são produzidos pela pipeline de release do RookHelm. A extensão combina código GPL-3.0 e proprietário; o NOTICE.txt dentro do pacote explica como solicitar o código-fonte da parte GPL-3.0.

Configure manualmente (avançado)

Se você gerencia os configs por conta própria em vez de usar o pacote, só precisa de duas configurações. Copie ambas da página Servers e adicione-as a um config que o servidor execute na inicialização, como cfg/server.cfg:

rookhelm_api_url           "https://api.rookhelm.com"
rookhelm_enrollment_token  "your-community-enrollment-token"

Reinicie o servidor (ou troque o mapa) para o plugin ler os valores, depois adote o servidor como no Passo 3. Valores definidos assim são seguros: o plugin só carrega o cfg/sourcemod/rookhelm.cfg automaticamente se esse arquivo estiver presente (ele só vem no pacote do painel), então uma configuração manual no server.cfg nunca é sobrescrita.

ConVar	Descrição
rookhelm_api_url	URL base do endpoint de conexão do RookHelm. O pacote do painel já preenche este valor.
rookhelm_enrollment_token	O token de registro da sua comunidade - um valor, o mesmo em todos os servidores, colado uma única vez. O pacote do painel já preenche este valor.

As duas ConVars são FCVAR_PROTECTED, então os valores ficam ocultos do cvarlist e não podem ser lidos pelo chat. A chave de assinatura por servidor nunca é uma ConVar - o próprio servidor a recebe e armazena quando você o adota.

Rotação de credenciais

• Token de registro: rotacione pelo painel se ele vazar. Servidores já adotados continuam funcionando - a chave de cada servidor é independente do token de registro. Servidores ainda não adotados vão precisar de um pacote novo.
• Chave de assinatura de um servidor: se a chave de um servidor for perdida ou comprometida, use Reissue keys (reemitir chaves) na página do servidor. A nova chave é entregue ao servidor na próxima reconexão; você nunca a copia à mão.

---

Precisa de mais ajuda?

Se um servidor não aparece como pendente depois de reiniciar, ou não fica online depois de adotado, veja Solução de problemas.

Solicite acesso