Troubleshooting

• Your endpoint must be reachable from the public internet over http or https.
• Addresses on localhost or a private network are blocked and always fail.
• We follow no redirects — give us the final URL.
• We give up after 10 seconds, so reply immediately and do your work afterwards.

• 401/403 usually means your signature check failed. Recompute it exactly as documented.
• The signed string is vote_id:server_id:username:timestamp using the timestamp from the request, not your own clock.
• Compare lowercase hex, and use a constant-time comparison.
• 500 means your own code threw — check your server log.

• Ignore callbacks where test is true — those are our test button.
• Store each vote_id and reward it once. Retries reuse the same ID on purpose.
• Send the player name into the vote link: https://runerank.com/vote/your-slug?username=PLAYER_NAME. Without it the player types the name themselves and may typo it.

Each player can vote for the same server once every 12 hours. The message shows exactly how long is left. Repeated attempts from the same network are also risk-scored, and suspicious activity is flagged for our staff rather than counted.

• The count is hidden if we have not received a report in the last 15 minutes.
• Report roughly once a minute; reports sent faster than every 20 seconds are rejected.
• Check the reporting key is the current one — regenerating it invalidates the old key.
• Use Test connection in the dashboard; it tells you exactly what we last received.
• A genuine reported 0 is shown as 0 online. Missing data shows nothing at all.

• You need either a working status check or a fresh player report.
• Press Check now in the dashboard to see the private result immediately.
• Many RSPS firewalls drop connections from unknown hosts — if so, use the Player Reporter instead.
• We never display your server as offline just because a check failed.

New listings are approved by hand. A clear name, banner, icon, description and working website link get approved fastest. Contact us if it has been more than 48 hours.

• DNS method: add the TXT record exactly as shown, then wait for it to propagate before retrying.
• File method: the file must be reachable at /.well-known/runerank-verify.txt over https and contain only the code.
• If neither works, request a manual review and our staff will verify you.