Ligar à plataforma

Para aparecer no ranking do FiveMobile, o servidor manda um sinal de vida para a API a cada ~30 segundos com o número de jogadores. Quem faz isso é o recurso fivemobile_plataforma.

1. Pegue a chave do servidor

Cada servidor aprovado recebe uma chave secreta no formato fm_srv_.... Na beta fechada, a equipe gera a chave quando aprova o seu servidor. Depois, isso vai ficar no painel do dono, no site.

A chave é a identidade do seu servidor. Não compartilhe, não coloque em repositório público e não envie para o cliente. Se vazar, peça uma nova.

2. Instale o recurso

Coloque a pasta fivemobile_plataforma em resources/ e salve a chave num arquivo chave.txt dentro dela:

resources/fivemobile_plataforma/
├── meta.xml
├── sinal.lua
└── chave.txt      ← só a chave, uma linha

O chave.txt não é listado no meta.xml, então nunca é enviado para os jogadores.

3. Permissão de rede

O recurso precisa chamar a internet (fetchRemote). No acl.xml, adicione-o a um grupo que tenha essa permissão:

<group name="RPC">
    <acl name="RPC" />
    <object name="resource.fivemobile_plataforma" />
</group>

4. Ligue no início

<resource src="fivemobile_plataforma" startup="1" />

Conferir

No log do servidor aparece [fivemobile_plataforma] enviando sinal de vida…. Em até 30 segundos o servidor fica online no ranking. Se a API recusar, o motivo vai para o log:

Mensagem	O que significa
chave_invalida	chave errada ou com espaço sobrando
servidor_pendente	o servidor ainda não foi aprovado na beta
servidor_suspenso	o servidor foi removido do ranking