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: 3f8a1c94e6b27d05ab1f9c4e8d7a2b61Copy 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.
