Docs / Votes and rewards

Rewards without Votifier

1 min read

No open port and no Votifier? The easiest answer is the CraftRank plugin, which picks up votes by itself. If you write your own plugin or website instead, you can ask the API whether a player has voted.

Check if a player voted

This call is public and needs no key:

GET https://craftrank.org/api/v1/servers/{id}/voted?username=PlayerName

The answer says whether that username voted for your server in the last 24 hours, when, and when they can vote again:

{ "server_id": 12, "username": "Steve", "voted": true,
  "last_vote": "2026-10-12T19:59:54+00:00", "next_vote": "2026-10-13T19:59:54+00:00", … }

A simple setup: when a player runs a command such as /claim, call this, and give the reward if voted is true. Because the answer stays true for 24 hours, save last_vote with the player and only reward each vote once.

Read your vote list

To process every vote, even for players who are not online, read your full vote list with your server's private API key. See Vote endpoints.

Your server ID and API key are on your server's Plugin & API page in the dashboard.