Command Palette

Search for a command to run...

Retour aux blogs

Setting up votifier

Install NuVotifier, find your token or RSA public key, and finish the setup so everyone who votes for your server gets their rewards automatically.

Auteur: Tristan GfrererTemps de lecture: 1mDate de publication: 14 Nov 2026
#Vote Listings
What Votifier does

When a player votes for your server on Apect, we can tell your server about it so your reward plugin hands them something in game. That message is sent with Votifier, a small plugin that listens on your server for incoming votes.

Votifier is optional. Your listing collects votes and climbs the rankings either way — Votifier is only needed if you want rewards to be given out automatically.

Step 1: Install NuVotifier

Download NuVotifier and put the jar in your server's plugins folder, then restart the server. NuVotifier is the maintained version and it supports both protocols, so it is the one to use even if a guide somewhere tells you to install the original Votifier.

On Apect, you can install it from the Plugins tab of your server — search for "NuVotifier", click install, and restart.

After the first restart, NuVotifier creates its files at plugins/Votifier/.

Step 2: Open the Votifier port

Votifier listens on its own port, separate from the port players connect to. The default is 8192.

On Apect, go to your server's Network tab and add an extra port, then set that port in plugins/Votifier/config.yml under port: and restart. If you host elsewhere, make sure the port is open in your firewall and forwarded to the server.

If you are on a shared host that will not give you a second port, Votifier cannot work and you will have to reward voters manually. Everything else about your listing still works.

Step 3: Find your token or key

There are two protocols. Use NuVotifier v2 if you can — it is simpler and more secure.

NuVotifier v2 (token)
Open plugins/Votifier/config.yml. Near the bottom there is a tokens: section that looks roughly like this:

tokens:
  default: 3f8a1c94e6b27d05ab1f9c4e8d7a2b61

Copy the value after default:. That long string is your token. Treat it like a password: anyone who has it can send fake votes to your server and trigger rewards.

Classic Votifier v1 (RSA public key)
Open plugins/Votifier/rsa/public.key and copy the entire contents. It is usually one long line of letters and numbers with no header. If yours is wrapped in -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY-----, copy those lines too — both forms are accepted.

Never paste the contents of private.key. That file stays on your server.

Step 4: Enter it on your listing

Go to Vote Listings in your panel, open your listing, and pick the Votifier tab. Turn on "Reward players for voting", then fill in:

Protocol — NuVotifier v2 or classic Votifier v1, whichever matches what you found above.
Votifier host — leave empty to use your server's address. Only change it if Votifier runs somewhere else.
Votifier port — the port from step 2, usually 8192.
Token or RSA public key — what you copied in step 3.

Save the settings.

Step 5: Send a test vote

On the same tab, type your own Minecraft username into the test box and click Send test vote. This sends a real vote to your server, so your reward plugin should hand you the reward as though a player had voted.

If it works you will see "Delivered", and your server console will show a line from Votifier. If it does not, the error tells you what went wrong — see below.

Step 6: Give out rewards

Votifier only announces the vote. Something else has to act on it. Install a reward plugin such as VotingPlugin or SuperbVote, and configure the rewards there. Those plugins read the vote from Votifier automatically — there is nothing extra to connect.

The service name in the vote will be Apect, if your reward plugin lets you give different rewards per vote site.

If the test vote fails

"Connection refused" — nothing is listening on that host and port. Either NuVotifier is not running, or the port is wrong, or the port is not open. Check your server console for a NuVotifier startup line, and check the port matches config.yml.

"Timed out" — something is dropping the connection, usually a firewall between us and your server. The port needs to accept connections from outside, not only from localhost.

"Host not found" — the address does not resolve. Check for a typo, and remember the host field takes an address only, with no port on the end.

"The server rejected the token" — the token does not match. Copy it again from config.yml, making sure you did not pick up a trailing space or quote marks.

"That is not an RSA public key" — the key could not be read. Make sure you copied public.key whole, and that you copied the public key and not the private one.

"This server speaks classic Votifier v1" — you chose v2 but the plugin is the original Votifier. Either switch the protocol to v1 and paste the RSA key, or replace the plugin with NuVotifier.

"Not a Votifier greeting" — something answered, but it was not Votifier. You have probably used your Minecraft port by mistake. Votifier needs its own separate port.

Checking it later

The Votifier tab keeps a log of recent delivery attempts, with the username, whether it succeeded, and the error if it did not. If players report that rewards stopped arriving, look there first — a server that was offline when someone voted will show up as a failed delivery.

We retry a failed delivery twice before giving up, so a short restart will not usually cost anyone their reward.

A note on security

Your token and RSA key are encrypted on our side and are never sent back to your browser once saved — which is why those boxes look empty when you come back to them. That is expected. To change a credential, paste a new one over the top; leaving the box empty keeps the one already stored.