> For the complete documentation index, see [llms.txt](https://ultimaterewards.athelion.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ultimaterewards.athelion.eu/configuration/rewards/reward-types/per-vote-reward.md).

# Per Vote Reward

Rewards per vote

Unlike the other vote reward types, a per-vote reward is granted for **every single vote** the server receives, immediately when the vote arrives. It is not configured in the `rewards` folder — all settings regarding voting live in **votes.yml**.

{% hint style="info" %}
Votes are received through [Votifier](https://www.spigotmc.org/resources/nuvotifier.13449/), so it has to be installed and configured on the server.
{% endhint %}

## Configuration

{% code fullWidth="true" %}

```yaml
# Enable vote handling and the vote command
enabled: true

# Determines whether incoming votes should be
# logged in the console for monitoring purposes.
log-incoming-votes: true

# Specifies whether votes should only be counted
# when the player is online.
count-only-when-online: false
# If it is set to false, it will proceed
# the vote even for unregistered players.
count-before-first-join: true

# Enables a per-vote reward system, allowing for
# customized rewards.
enable-per-vote-rewards: true

# Broadcast a message whenever a vote is received
announce-received-vote: true
received-vote-announcement:
  - "&b&lULTIMATEREWARDS&8 ► &7Player %player% has voted for our server on %service%"

per-vote-rewards:
  example:
    permission: ultimaterewards.votes.example
    required-slots: 1
    actions:
      - "[console] give %player% emerald 1"
  anotherExample:
    permission: ultimaterewards.votes.anotherExample
    actions:
      - "[message] Thanks for voting for us!"
      - "[console] give %player% diamond 1"
```

{% endcode %}

## Options

| Key                          | Description                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------- |
| `enabled`                    | Turns the whole vote handling (and the `/vote` command) on or off                  |
| `log-incoming-votes`         | Logs every received vote into the console                                          |
| `count-only-when-online`     | `true` counts only the votes of players who are currently online                   |
| `count-before-first-join`    | `true` also counts votes of players who have never joined the server               |
| `enable-per-vote-rewards`    | Turns the `per-vote-rewards` section on or off                                     |
| `announce-received-vote`     | Broadcasts `received-vote-announcement` on every received vote                     |
| `received-vote-announcement` | The broadcast text; `%player%` and `%service%` (name of the vote site) can be used |

### Per-vote reward entries

Each entry under `per-vote-rewards` is a separate reward:

| Key              | Description                                                                         |
| ---------------- | ----------------------------------------------------------------------------------- |
| `permission`     | Only players with this permission receive the entry — use it for rank-based bonuses |
| `required-slots` | How many free inventory slots the player needs                                      |
| `actions`        | The [actions](/configuration/rewards/reward-actions.md) executed for every vote     |

{% hint style="info" %}
A player receives **every** entry they have permission for, so entries stack. Give each rank its own permission if you want them to be exclusive.
{% endhint %}

## Related commands

| Syntax                   | Description                                              |
| ------------------------ | -------------------------------------------------------- |
| `/vote proceed <player>` | Processes a vote manually — the easiest way to test this |
| `/vote reset <player>`   | Resets the player's vote counter                         |

See [Commands](/usage/commands.md) for the full list.