Documentación
COP Agent
Heartbeat autenticado: la única fuente de jugadores que el ranking trata como creíble.
1. Token
Panel → Servidores → Generar token heartbeat. Guárdalo: solo se muestra una vez.
2. Agent Python (recomendado)
Carpeta del repo: tools/cop-agent/
sudo mkdir -p /opt/cop-agent sudo cp tools/cop-agent/cop_agent.py tools/cop-agent/config.example.ini /opt/cop-agent/ sudo cp /opt/cop-agent/config.example.ini /opt/cop-agent/config.ini # Edita token + MySQL pip3 install PyMySQL sudo cp tools/cop-agent/cop-agent.service /etc/systemd/system/ sudo systemctl enable --now cop-agent
Modos: mysql (COUNT online), tcp (solo puerto), manual (pruebas).
3. Alternativa PHP + cron
tools/cop-heartbeat.php — configura token/DSN/SQL arriba del fichero:
* * * * * php /path/to/cop-heartbeat.php >/dev/null 2>&1
Endpoint
POST https://ragnarokportal.com/api/v1/heartbeat
Authorization: Bearer <token>
{"players_online": 42, "max_players": 1000}