Skip to main content

NuVotifier

Vote listener that receives votes from server list sites and triggers reward events on your server.

by IchbinjoeAdmin

Dependencies

No dependencies required.

What is NuVotifier?

NuVotifier is the receiving half of a server-voting setup. Server-list websites (where players vote for your server) send an encrypted notification to your server when someone votes; NuVotifier listens on a port, verifies that notification against a public/private key pair, and fires a vote event. It does not give rewards itself — a separate reward plugin such as VotingPlugin listens for that event and grants the prize. NuVotifier also supports forwarding, so a vote received by a proxy can be relayed to the correct backend server.

Who it's for: Any public server that lists on voting sites to climb rankings and wants to reward voters. The standard, secure vote listener that reward plugins are built to work with. It is built and maintained by Ichbinjoe and sits in the admin category.

Key features of NuVotifier

  • Vote receiving
  • Multiple vote site support
  • Event-based rewards
  • Protocol v1 and v2
  • Forwarding support
  • Debug tools

How to install NuVotifier

NuVotifier runs on Bukkit, Spigot, Paper or Velocity servers. Maintained for current Spigot/Paper versions and Velocity; a recent build runs across a broad range because it is network and crypto rather than gameplay.

  1. 1Stop your server, or have it ready to restart. Always back up your world and plugins folder before adding a new plugin.
  2. 2Download NuVotifier.jar (a build matching your server version) and place it in your server's /plugins folder.
  3. 3NuVotifier has no required dependencies, so it runs on its own once the jar is in place.
  4. 4Start the server fully. NuVotifier generates its configuration files on first launch — stop the server, edit them to taste, then start again.
  5. 5Confirm it loaded by checking the console for NuVotifier on startup, or by running one of its commands in-game.

Note: Drop NuVotifier into /plugins and restart to generate a config and an RSA key pair. Open the configured port on your firewall/host and paste the generated public key into each voting site's settings — votes only arrive once the port is reachable and the key is registered. Pair it with a reward plugin to actually grant prizes.

NuVotifier commands and permissions

Main commands

/nuvotifier reload
Reloads NuVotifier's configuration without restarting the server.
/nuvotifier testvote
Fires a simulated vote so you can confirm the listener and your reward plugin react correctly.

Permission nodes

nuvotifier.admin
Grants the NuVotifier administration commands.
nuvotifier.reload
Allows reloading the configuration.

NuVotifier FAQ

Does NuVotifier give vote rewards?

No. NuVotifier only receives and verifies vote notifications and fires a vote event. To reward voters you install a separate plugin such as VotingPlugin that listens for that event. NuVotifier is the secure listener; the reward plugin is the prize-giver.

Votes are not being received. What do I check?

Confirm the NuVotifier port is open and reachable from outside your server, that the public key you pasted into the voting site matches the one NuVotifier generated, and that the site has your correct IP and port. Use /nuvotifier testvote to verify the local side works independently of the site.

What is the public key used for?

NuVotifier uses RSA encryption so votes cannot be forged. The voting site encrypts the vote with your public key; NuVotifier decrypts and verifies it with the matching private key. You paste the public key into each site; the private key stays on your server.

Can NuVotifier work behind a proxy?

Yes. NuVotifier supports vote forwarding, so the proxy can receive the vote and relay it to the appropriate backend server where the reward plugin runs. This is the recommended setup for networks so votes are not lost when a player is on a different backend.

Which reward plugins work with NuVotifier?

Any reward plugin that listens for the Votifier vote event, which is the de facto standard — VotingPlugin is the most common pairing. Because NuVotifier is protocol-compatible with the original Votifier, plugins written for either work with it.

Features

  • Vote receiving
  • Multiple vote site support
  • Event-based rewards
  • Protocol v1 and v2
  • Forwarding support
  • Debug tools

Commands

/nuvotifier reload/nuvotifier testvote

Permissions

nuvotifier.adminnuvotifier.reload

Tags

votingrewardsserver listvote sites