> ## Documentation Index
> Fetch the complete documentation index at: https://docs.berrybyte.net/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Install and Configure Votifier on Your Minecraft Server

> Guide to using NuVotifier to add voting and rewards to your Minecraft server.

[NuVotifier](https://www.spigotmc.org/resources/nuvotifier.13449/) adds voting functionality to your server and lets you appear on voting sites. It works on Bukkit servers and proxies (BungeeCord, Velocity, etc.) and supports Minecraft 1.7.2+.

Use voting to boost your server's ranking and give players rewards for voting.

## Installation

1. Download NuVotifier from [SpigotMC](https://www.spigotmc.org/resources/nuvotifier.13449/) or [Github](https://github.com/parallelblock/NuVotifier/releases)
2. Place the JAR in the `plugins` folder
3. Restart your server

<Tip>The same JAR works for Bukkit servers and proxies (BungeeCord/Velocity).</Tip>

## Bukkit Server Setup

1. **Create a port:**
   * Go to **Network** tab and click **Create Allocation**
   * Default port is `8192`, but you can use any available port
   * Label it in Notes (don't make it Primary)

2. **Configure the plugin:**
   * Open `/plugins/Votifier/config.yml`
   * Set `port` to the port you created
   * `host` should be `0.0.0.0` (listens on all interfaces)

```yml theme={null}
host: 0.0.0.0
port: 25566  # Change to your port
```

3. **Configure rewards (optional):**
   * See [Configure Rewards](#configure-rewards) section below

## BungeeCord / Velocity Setup

<Warning>We recommend Velocity over BungeeCord to prevent vote spam by restricting backend server access.</Warning>

1. **Install on all servers:**
   * Install NuVotifier on the proxy and all backend servers
   * Place JAR in `plugins` folder and restart

2. **Install vote listener:**
   * NuVotifier doesn't include listener functionality
   * Install a vote listener plugin on each server (see [Configure Rewards](#configure-rewards) for options)

3. **Configure vote forwarding:**

**Backend Servers:**

* Open `/plugins/Votifier/config.yml`
* Set `port: -1` (disables port listening)
* Set `forwarding.method: pluginMessaging`

**Proxy Server:**

* Create a port in **Network** tab
* Open `/plugins/Votifier/config.toml`
* Set `port` to the port you created
* Set `forwarding.method: pluginMessaging`

See [NuVotifier's guide](https://github.com/NuVotifier/NuVotifier/wiki/Setup-Guide) for advanced configuration.

## Adding Your Server to a Voting Site

1. Register at [minecraftservers.org](https://minecraftservers.org)
2. Click **add a server** and fill in:
   * Server name, IP, port (default `25565`)
   * Description, tags, banner, etc.
3. **Enable Votifier** and enter:
   * IP address (numbers before colon)
   * Port you created for Votifier
   * Public key from `/plugins/Votifier/rsa/public.key`

<Warning>Keep your private key safe! If exposed, bad actors can spam votes.</Warning>

4. Click **Send Test Vote** to test. Check server console for confirmation.

<Tip>Use `/testvote` (Bukkit) or `/ptestvote` (Velocity/BungeeCord) to test.</Tip>

## Configure Rewards

1. **Install a vote listener plugin:**
   * [SuperbVote](https://www.spigotmc.org/resources/superbvote.11626/)
   * [VotingPlugin](https://www.spigotmc.org/resources/votingplugin.15358/) (Advanced)
   * [UltimateVotes](https://www.spigotmc.org/resources/ultimatevotes-1-8-8-1-15-2-spigot-bungeecord-uuid.516/) (Paid)
   * [Enjin](https://www.spigotmc.org/resources/enjin-cms-donationcraft-plugin.17209/) (Requires Enjin)

2. **Configure rewards:**
   * Open `/plugins/SuperbVote/config.yml` (or your chosen plugin)
   * Find the `rewards` section
   * Configure commands to execute on vote

Example:

```yml theme={null}
rewards:
  - if:
      default: true
    commands:
    - eco give %player% 1000
    - give %player% diamond 1
```

**Placeholders:**

* `%player%` - Player username
* `%player_uuid%` - Player UUID
* `%service%` - Voting service name
* `%votes%` - Total votes
* [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) placeholders

<Tip>Enable `/vote` command by setting `vote-command: true`.</Tip>

Need help? Ask in our [Discord](https://berrybyte.net/discord) or [contact support](https://berrybyte.net/ticket).