NuVotifier is the modern, maintained fork of Votifier. It's how toplists notify your server when someone votes, so you can reward them in-game. Every successful Minecraft server uses it. Here's the complete 2026 setup, end-to-end.

This guide covers Paper, Spigot, and Purpur (the setup is identical). For BungeeCord or Velocity, the plugin works on the proxy too — we'll cover that at the end.

What you'll have at the end

• NuVotifier installed and running on port 8192 (default)
• A public key registered with at least one toplist
• A reward plugin (we'll use SuperbVote) configured to give items/money/permissions for each vote
• A working test vote received and processed

Step 1: Download and install NuVotifier

NuVotifier is maintained at github.com/NuVotifier/NuVotifier. Don't download from random forks — many of them are years out of date.

1. Go to the GitHub releases page and download the latest NuVotifier-Bukkit.jar (or NuVotifier-Universal.jar if you want one JAR for proxy + backend)
2. Stop your server
3. Drop the JAR into your plugins/ folder
4. Start the server

On first boot, NuVotifier generates plugins/Votifier/config.yml and a keypair under plugins/Votifier/rsa/. Do not edit these files manually until you've seen them generated.

Step 2: Open port 8192 (or whatever you configured)

Toplists need to reach your server on the Votifier port. If you're running at home behind a router, you need a port forward. If you're on a VPS, you need to open the port in your firewall.

Hostinger / OVH / Vultr VPS:

sudo ufw allow 8192/tcp

Hosted (Aternos, Apex, etc.):

You usually don't need to do anything — they auto-forward Votifier ports. Check the panel for "Votifier" or "Extra ports" settings.

Test that the port is reachable from outside your network:

telnet your-server-ip 8192

You should see a banner like VOTIFIER 2.9.2 or similar. If you see "connection refused," the port isn't open. If telnet hangs, the port is firewalled but the server isn't responding — check that NuVotifier started cleanly in your console.

Step 3: Find your public key

NuVotifier supports two protocols:

• v1 (legacy): RSA key, simple, works with every toplist
• v2 (modern): token-based, more secure, requires the toplist to support it

For v1, your public key is in plugins/Votifier/rsa/public.key. Open it in a text editor — it's a single long string starting with letters and numbers. Copy the entire contents.

For v2 tokens, the config defines named tokens you assign per-service:

tokens:
  default: 'KEY_GENERATED_BY_PLUGIN_HERE'
  minecraftjavaservers: 'a-different-token-for-this-toplist'

Generate a v2 token with: /nvreload tokens add minecraftjavaservers in-game (op required). Copy the printed token.

Step 4: Register the key with a toplist

On your control panel, edit your server listing. There's a "Votifier" section:

• Votifier host: your server IP or domain
• Votifier port: 8192 (or whatever you set)
• Public key (v1): paste the contents of public.key
• Token (v2): paste the token you generated

Save. The toplist will now send a test vote packet to verify everything works.

Step 5: Test it with our free Votifier tester

The tool connects to your configured host:port and walks the same handshake a toplist would.

The two common failure modes:

• "Connection refused": port not open or wrong port. Re-check Step 2.
• "Bad signature" / "Invalid token": public key or token mismatch between toplist and server. Re-paste from your server's config, taking care not to include whitespace.

Step 6: Install a reward plugin

NuVotifier alone just receives votes and fires a VotifierEvent in-game. To do something with a vote (give the player money, items, a key, a temporary rank), you need a reward plugin.

The standard pick in 2026 is SuperbVote — actively maintained, supports MySQL, has built-in vote streaks and party rewards. Install it like any other plugin (drop JAR in plugins/, restart).

A minimal reward configuration in plugins/SuperbVote/config.yml:

rewards:
  - chance: 1.0
    commands:
      - 'eco give %player% 500'
      - 'crate give %player% vote 1'
    message:
      player:
        - '&aThanks for voting!'
        - '&7You got: &e$500 + 1 vote key'

This gives every vote $500 in-game money and 1 vote crate key, plus a thank-you message in chat. Adjust to taste.

Step 7: Tell your players to vote

This is the step most server owners skip. NuVotifier and SuperbVote are running fine, but no one votes because no one knows they should. Add to your setup:

• A /vote command that shows links to all the toplists you're listed on (SuperbVote has one built-in)
• A line in your MOTD: &eVote for rewards: &f/vote
• A pinned message in your Discord with the vote links
• An NPC at spawn with the same info

Proxy setup (BungeeCord / Velocity)

If you run multiple servers behind a proxy, install NuVotifier on the proxy itself (port 8192 there) and the backend server gets vote notifications forwarded automatically via the BungeeForwardingSecret or Velocity's plugin messaging.

Set method: bungee on backend servers' NuVotifier config and they'll listen for forwarded votes instead of trying to open their own port.

Common questions

Q: Do I have to use port 8192?
No. You can change it in config.yml. Just make sure the new port is open and that you update the toplist with the new port number.

Q: My server is on Aternos/Minehut — can I use Votifier?
Aternos and Minehut block inbound connections on extra ports by design. You generally cannot run Votifier on free hosts. Some paid plans expose extra ports — check with your provider.

Q: Votes are received but no rewards given.
This is almost always a SuperbVote config error. Run /sv testvote in-game and watch console. The error will tell you which command/permission is failing.

Q: How do I see vote logs?
NuVotifier logs every received vote to console. For persistent history, SuperbVote stores votes in data.yml (or your configured MySQL database) — see /sv top for leaderboards.

Once it works

You'll start to see organic vote volume within a few days of being listed and having Votifier set up. Drop our embeddable status widget on your server's website or Discord to passively remind visitors to vote — every install becomes a passive vote driver.

For the bigger picture on why this all matters, see our companion piece: Why your Minecraft server isn't getting players (and how to fix it).