Vote rewards, set up in five minutes

When a player votes for your server here, we tell your server over Votifier, the same way every big server list does, and your rewards plugin pays them in game. If you're already on other lists, you have everything you need.

What we send, in one table

Service name	`9minecraftserver.com` What your rewards plugin matches on. Spelling matters; capital letters don't.
How	Votifier with your public key (every Votifier, NuVotifier and VotifierPlus accepts it), or a NuVotifier token if you prefer (your server then confirms each vote).
Port	Whatever your Votifier listens on: 8192 unless you or your host changed it.
Voting day	One vote per player per day. The day resets at midnight UTC. Up to three players on one internet connection can vote for the same server each day.
Monthly reset	Vote counts start again on the 1st of each month (UTC). All-time totals are kept.
Usernames	Sent exactly as the player typed them. Bedrock players on Geyser keep their prefix (usually a dot: `.Steve`).
Voter address	Always `0.0.0.0`. We don't pass players' IP addresses on to anyone.
If your server is down	We try again after 1, 5 and 15 minutes, then every hour for about a day. A vote that reached your server is never sent twice.

The five steps

Have a Votifier running. Most servers use NuVotifier: put the jar in plugins and restart. It creates plugins/Votifier with your public key and a token. On a Velocity or BungeeCord network, run it on the proxy only. Full NuVotifier guide.
Add or claim your server here. List it if it isn't here yet, or press Claim on its page and put the one-time code in your MOTD.
Paste your Votifier details. On your server's edit page, under Vote rewards: the address of the machine Votifier runs on, its port, and the whole of plugins/Votifier/rsa/public.key. Line breaks and BEGIN/END lines are fine. Save.
Send a test vote with your own in-game name. Use a name that has joined your server: rewards plugins ignore names they've never seen. Your console should say Got a protocol v1 vote record from ... 9minecraftserver.com. With a token, the edit page tells you straight away whether your server accepted it.
Add the reward. Votifier only delivers the vote; your rewards plugin decides what the player gets (below).

VotingPlugin

The easiest way: send the test vote first. VotingPlugin adds us to VoteSites.yml by itself, and you only fill in the reward. Or paste this into plugins/VotingPlugin/VoteSites.yml (if you already list other sites, put our entry under the same VoteSites: line), put your server's page name in place of your-server, change the reward, and run /av reload. Your edit page shows this with your own link already filled in.

VoteSites:
  NineMinecraftServer:
    Enabled: true
    Name: '9MinecraftServer'
    ServiceSite: '9minecraftserver.com'
    VoteURL: 'https://9minecraftserver.com/server/your-server/vote'
    VoteDelay: 24h
    # Optional, for exact /vote next times: our day resets at 00:00 UTC.
    # VoteDelayDaily: true
    # VoteDelayDailyHour: 0   # the hour 00:00 UTC is on your server's clock
    Rewards:
      Commands:
      - 'give %player% diamond 1'
      Messages:
        Player: 'Thanks for voting for us on 9MinecraftServer!'

Keep WaitUntilVoteDelay off (the default). Our day resets at midnight UTC, so a player can vote at 11:50 pm and again at 12:10 am UTC; with that setting on, the second reward would be lost.

Other rewards plugins

SuperbVote's default reward already covers every list. Anything else: use 9minecraftserver.com wherever it asks for the service or site name.

Your vote link

For your /vote command, vote menu and website: https://9minecraftserver.com/server/your-server/vote, with your server's page name. Add ?username= and the player's name to fill it in for them.

Votes not arriving?

The test vote says it couldn't connect

NuVotifier isn't running or its port is closed. Check your console for "Votifier enabled" at startup, then make sure the port in plugins/Votifier/config.yml is open for TCP. Hosting panels usually need it added as an extra port, and it can't be the same as your game port.

The test vote was sent, but nothing shows in the console

With the public key, Votifier never replies, so a wrong key fails silently. Your console will say "Could not decrypt data": copy plugins/Votifier/rsa/public.key again, the whole line. On a network, use the key and port of the proxy that runs NuVotifier.

The console shows the vote, but no reward arrives

Your rewards plugin doesn't know us yet, or the name has never joined. In VotingPlugin, the ServiceSite must be spelled 9minecraftserver.com (capital letters don't matter), and it ignores names that have never played on your server, so test with your own name.

Bedrock players don't get rewards

Geyser players have a prefix on Java, usually a dot (.Steve). They must vote with the full name, prefix included. Tell them the exact name to use on your vote menu.

Rewards arrive twice on a network

Only one Votifier should receive votes: the one on your proxy. Remove it from the backend servers, or set NuVotifier on the proxy to forward votes instead of rewarding on both.

Quick questions

Public key or token?

Either works. The public key is what every server list uses, so it's the one you already have. A NuVotifier token lets your server reply to each vote, so a test vote can tell you it arrived.

Do test votes count for my ranking?

No. They only go to your server, never into your vote count.

Do votes count if I don't set up rewards?

Yes. Every vote counts for your ranking this month. Rewards just give players a reason to come back and vote every day.

Can I check votes from my own plugin or website?

Yes, with our free server owner API: it answers "did this player vote today?".