Wiki Release: 2026.09.5 · UltimateClans: 9.1.4 · Documentation branch: 9 · Levelup
Levelup practical usage guide#
Levelup adds clan level progression using points, requirements, patents/titles, configured costs and level actions. 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: Define level thresholds, requirements and actions in the level configuration. Earn/add clan points through supported gameplay/admin flows and verify the next level requirements. Trigger a level up and confirm actions/rewards/patent changes.
Recommended in-game workflow#
- Define level thresholds, requirements and actions in the level configuration.
- Earn/add clan points through supported gameplay/admin flows and verify the next level requirements.
- Trigger a level up and confirm actions/rewards/patent changes.
Administrator setup checklist#
- Keep thresholds ordered and test every transition around boundary values.
- Do not rename live level identifiers without checking stored clan level data.
Configuration areas#
Config—date_format_short,Levelup,PermissionsLevel—points,patent,actions,requeriments
Changing settings safely#
- Back up the component configuration and persistent data before changing a live server.
- Change one feature area at a time.
- Reload only if the component documents reload as safe; otherwise restart the server.
- Test with a non-OP account that has exactly the intended clan role/permission.
- Watch the console from the first relevant warning/error, not only the final stack trace.
- On multiserver networks, repeat the check on every node and confirm shared storage/sync settings match.