Reward every vote

Download our lightweight mclist.io plugin to sync fresh votes straight into your Minecraft server, broadcast them to the community, and run any reward command automatically. Unlike votifier, no extra ports required.

Download plugin (Spigot/PaperMC)

1. Connect your server

Drop the jar into plugins/, restart, and paste your mclist.io server ID into config.yml.

2. Let it run

The plugin checks mclist.io every few seconds and rewards for newly made votes.

Example config.yml

Change the server-id to match your listing, decide if offline voters should be rewarded instantly, and stack as many reward commands as you like.

server-id: 12345
reward-offline-players: false
reward-commands:
  - "say &a{player} voted on mclist.io"
  - "give {player} diamond 1"
messages:
  broadcast-enabled: true
  broadcast-text: "&a{player} just voted!"
skip-initial-replay: true

Build your own plugin

If our plugin dosen't meet your requirements, feel free to code your own. More info about API endpoint is listed below.

GET /api/recent_votes/<sid>

Replace <sid> with your numeric server ID (e.g., 12345).
Returns votes from the last 24 hours sorted from newest to oldest.
Each object contains the player nickname and ISO8601 timestamp under voted_at.

Sample response

{
  "server_id": 12345,
  "votes": [
    {
      "nickname": "PlayerOne",
      "voted_at": "2025-02-10T11:15:00Z"
    },
    {
      "nickname": "PlayerTwo",
      "voted_at": "2025-02-10T10:52:41Z"
    }
  ]
}