> 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-settings.md).

# Reward Settings

Per-player settings regarding rewards

Every player can turn the following four settings on and off. Each one has its own permission — without it the setting cannot be toggled and the item in the settings menu is replaced by `setting-no-permission-item` from config.yml.

| Setting              | Permission                          | Default in config.yml          | What it does                                                                                                         |
| -------------------- | ----------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| `JOIN_NOTIFICATION`  | `ultimaterewards.notification`      | `join-notification-by-default` | [Notifies](/configuration/rewards/reward-features/notifications.md) the player about claimable rewards on join       |
| `LIVE_NOTIFICATIONS` | `ultimaterewards.livenotifications` | `live-notification-by-default` | [Notifies](/configuration/rewards/reward-features/notifications.md) the player the moment a reward becomes available |
| `JOIN_AUTO_CLAIM`    | `ultimaterewards.joinautoclaim`     | `join-auto-claim-by-default`   | [Claims](/configuration/rewards/reward-features/auto-claim.md) all available rewards on join                         |
| `LIVE_AUTO_CLAIM`    | `ultimaterewards.liveautoclaim`     | `live-auto-claim-by-default`   | [Claims](/configuration/rewards/reward-features/auto-claim.md) a reward the moment it becomes available              |

## Toggling a setting

Settings can be toggled in three ways:

* by the player from a menu, using the `[toggle_join_notification]`, `[toggle_live_notifications]`, `[toggle_join_auto_claim]` and `[toggle_live_auto_claim]` [click actions](/configuration/menus/setting-menu.md),
* with the command `/reward toggle <setting>`,
* for another player with `/reward toggle <setting> <player>` (requires `ultimaterewards.toggle.others`).

{% hint style="info" %}
The defaults in [config.yml](/usage/global-configuration.md) only apply to players who have not changed the setting yet. The current state can be read with `%ultimaterewards_setting_enabled_{setting}%`.
{% endhint %}

## Excluding a reward

Whether a specific reward takes part in notifications and auto-claiming is decided per reward in its .yml file:

```yaml
exclude-from-reminders: false  # true = never appears in join/live notifications
live-reminder-enabled: true    # notify the moment this reward becomes available
included-in-auto-claim: true   # allow auto-claim to claim this reward
```