Setting up votes

This document outlines how to configure NuVotifier for a variety of different configurations. It should be used by server administrators looking to set up NuVotifier on their network.

Key vs Token

This document uses the terms token and key. These are two separate terms, and it is important to understand the differences.

Key

Keys in terms of NuVotifier refer to the old Votifier style RSA keys. They are typically distributed as a pair of files - a public and private key. When dealing with RSA keys, you can share your public key with server lists, but make sure to keep your private key safe with you. You can find these keys auto-generated under plugins/(Nu)Votifier/rsa/, where your public key is named public.key, while your private key is labeled private.key. Make sure not to separate the two, as they only work together as a pair.

Token

Tokens in terms of NuVotifier refer to a new short string of characters. This string of characters is secret, and should never be exposed to anyone but you or server lists which support NuVotifier voting (check with the server list first). Tokens are most commonly used internally within a network for use when using the proxy vote forwarding method.

Single server configuration

These instructions apply to users setting up a single server to accept votes from a server list. In most cases, these are the steps you want to follow.

Configuring the plugin

By default, NuVotifier generates a configuration that is already suitable for a single-server configuration. However, you may need to change the port NuVotifier listens on, if you use a shared host or run multiple servers on the same machine.

You can then add your server to server lists using the port you configured while also supplying your public key. At this point, you should be able to send a test vote to your server!

Once you've verified NuVotifier can accept votes from your server lists, you'll need to set up a vote listener. See the next section for more details.

A Note on Changing the Port

The port must be between 1 and 65535 and not in use by any other service, including the port of the server NuVotifier will be running on. For example, if Minecraft is running on the default port (25565), you cannot set port also to 25565.

Depending on your host and if you have a dedicated IP, you might have to change the ip value. Usually, the default of 0.0.0.0 works.

Simulating a vote

For Bukkit and Sponge, you may simulate a vote through the /testvote command. For Bungee and Velocity, the command is /ptestvote.

This tutorial comes from the original NuVotifier wiki, you can check that one out as well for additional information.