Wiki Release: 2026.09.5 · UltimateClans: 9.1.4 · Documentation branch: 9 · Rewards

Rewards practical usage guide#

Rewards adds persistent clan reward tracking/claiming tied to supported clan progression/events, with GUI and storage. This guide focuses on the actual administrator and player workflow: what to set up first, how to test it in-game, and what to check before enabling it for everyone.

How the feature works#

In normal use, the feature follows this flow: Configure reward definitions and eligibility rules. Trigger the associated clan progression/event on a test clan. Open reward GUI/command, claim the reward and verify it cannot be claimed again when designed as one-time.

Recommended in-game workflow#

1. Configure reward definitions and eligibility rules.
2. Trigger the associated clan progression/event on a test clan.
3. Open reward GUI/command, claim the reward and verify it cannot be claimed again when designed as one-time.

Administrator setup checklist#

• Test overflow/inventory/economy command actions separately.

Configuration areas#

• Config — date_format_short, Rewards, Permissions
• Storage — type, mysql, user, pass, databases, datasource

Changing settings safely#

1. Back up the component configuration and persistent data before changing a live server.
2. Change one feature area at a time.
3. Reload only if the component documents reload as safe; otherwise restart the server.
4. Test with a non-OP account that has exactly the intended clan role/permission.
5. Watch the console from the first relevant warning/error, not only the final stack trace.
6. On multiserver networks, repeat the check on every node and confirm shared storage/sync settings match.