Connecting to the platform

To show up in the FiveMobile ranking, your server sends a heartbeat to the API every ~30 seconds with its player count. The fivemobile_plataforma resource does this for you.

1. Get your server key

Every approved server gets a secret key shaped like fm_srv_.... During the closed beta the team generates it when your server is approved; later it will live in the owner dashboard on the website.

The key is your server's identity. Don't share it, don't commit it to a public repository and don't send it to the client. If it leaks, ask for a new one.

2. Install the resource

Put the fivemobile_plataforma folder in resources/ and save the key in a chave.txt file inside it:

resources/fivemobile_plataforma/
├── meta.xml
├── sinal.lua
└── chave.txt      ← just the key, one line

chave.txt isn't listed in meta.xml, so it is never sent to players.

3. Network permission

The resource needs to reach the internet (fetchRemote). In acl.xml, add it to a group that has that right:

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

4. Start it on boot

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

Check

The server log shows [fivemobile_plataforma] enviando sinal de vida…. Within 30 seconds your server is online in the ranking. If the API refuses, the reason goes to the log:

Message	Meaning
chave_invalida	wrong key, or extra whitespace
servidor_pendente	the server hasn't been approved for the beta yet
servidor_suspenso	the server was removed from the ranking