Set up clan levels
EXP from kills, kill streaks and rival multipliers, the ten-level table, and the caps and perks each level grants.
Make clans grow: they earn EXP from kills, lose it from deaths and raids, and every level raises how many members, allies and rivals they can have.
Before you start#
- The
levelsmodule must be on (it is by default), see Turn clan systems on and off. - Level changes you make in
config.ymlapply to every clan after/clanadmin reload. A clan's level is not stored: it is worked out from its EXP every time, as the highest level whoserequired-expthe clan has reached.
Steps#
See what players see
Run /clan and click Level. The menu lists every level with the current one marked, a progress bar and what each level unlocks.
Open the table
Open plugins/ExyliaClans/config.yml and find levels.level-definitions. Each row is one level: required-exp is the total EXP needed (7 000 means 7 000 in total, not 7 000 since the last level), and the three *-bonus values add to the base caps.
Edit and reload
Change the numbers, then run /clanadmin reload.
Check that it works#
Run /clanadmin setlevel <clan> <level> on a test clan, then open /clan and Level as one of its members: the level is marked, and the caps for members, allies and rivals match the row you edited. Crossing a threshold tells every online member (level.level-up or level.level-down in the language file, see Messages).
What each level gives#
The bonuses are added to the base caps in settings and do not stack across levels: a level 10 clan gets exactly the level 10 row.
| Cap | Base (shipped) | At level 10 (shipped) |
|---|---|---|
| Members | max-members, 30 | 30 + 50 = 80 |
| Alliances | max-alliances, 5 | 5 + 5 = 10 |
| Rivals | max-rivals, 10 | 10 + 10 = 20 |
Extra member slots for one clan: /clanadmin setslots <clan> <SET|ADD|REMOVE> <amount>. They sit on top of the base and the level bonus.
A clan leader with the permission exyliaclans.members.<n>, exyliaclans.allies.<n> or exyliaclans.rivals.<n> replaces the matching base cap (highest wins), for example to sell bigger clans on a rank.
Earn and lose EXP#
| Event | Shipped effect |
|---|---|
| A member kills somebody | +10 EXP to their clan |
| A member dies | -5 EXP from their clan, and their kill streak resets |
| The clan goes raidable | -50 EXP, once |
EXP never drops below zero. Each of the three can be turned off or changed under levels.exp-actions.
The level is recomputed from the new total. A clan that drops below a threshold is told and its caps shrink, but members it now has too many of are not kicked: it just cannot recruit until it climbs back.
Going further#
Kill streaks#
A streak is counted per player and reset by dying or logging out. The bonus is the highest threshold at or below the streak, added to the kill EXP: at a streak of 7 a kill is worth 10 + 10 = 20. Shipped thresholds are 3 (+5), 5 (+10) and 10 (+25) under levels.kill-streak-bonuses; add as many as you like.
Rival kills#
If the victim's clan is one the killer's clan declared a rival, the whole kill EXP is multiplied by rivals.kill-exp-multiplier (shipped 2.0): (10 + 10) × 2.0 = 40. Set it to 1.0 for no bonus. See Allies and rivals.
Boost kill EXP with a permission#
Kill EXP goes through ExyliaLib's modifiers as type clan-exp, source clan-kills. A player with the permission exylia.modifier.clan-exp.clan-kills.1.5 makes their kills worth 1.5 times as much to the clan. Deaths, raids and /clanadmin setexp are never boosted.
Level perks#
A level row can carry modifiers that boost what every member earns while the clan is at that level, through ExyliaLib's modifiers. Each key is <type>:<source> and each value is a factor (1.05 is +5%). Types are money, xp, drops, or another plugin's own type; * as the source covers every source. The shipped table:
| Level | Perks |
|---|---|
| 1-2 | None |
| 3-4 | money +5% |
| 5-6 | money +5%, xp +5% |
| 7-8 | money +10%, xp +5% |
| 9-10 | money +10%, xp +10%, drops +10% |
clan-exp is refused here, so a level can never speed up its own climb. A perks row is the total at that level, not added to lower ones.
Only fresh installs get the shipped perks. On a server that already had a level table the update writes an empty modifiers: {} into each level, so no clan gains a boost it never had. Fill them in and run /clanadmin reload to turn perks on.
Add or remove levels#
Add a row with the next number and raise levels.max-level to match, or delete rows and lower it. A key that is not a number is skipped, and so is a level below 1 or above max-level.
Admin commands#
/clanadmin setexp <clan> <SET|ADD|REMOVE> <amount>/clanadmin setlevel <clan> <level>: sets the EXP to that level'srequired-exp; a level not in the table is refused.
EXP is clamped at the top level's threshold. With modules.levels: false nothing earns EXP, the Level menu does not open and every cap is the base value; the stored EXP comes back untouched when you switch it on again.
Technical details
levels:
max-level: 10
exp-actions:
kill: { enabled: true, exp: 10 }
death: { enabled: true, exp-loss: 5 }
raided: { enabled: true, exp-loss: 50 }
kill-streak-bonuses:
"3": 5
"5": 10
"10": 25
level-definitions:
"1": { required-exp: 0, max-members-bonus: 0, max-alliances-bonus: 0, max-rivals-bonus: 0 }
"2": { required-exp: 500, max-members-bonus: 5, max-alliances-bonus: 1, max-rivals-bonus: 1 }
"3": { required-exp: 1500, max-members-bonus: 10, max-alliances-bonus: 1, max-rivals-bonus: 2 }
"4": { required-exp: 3500, max-members-bonus: 15, max-alliances-bonus: 2, max-rivals-bonus: 2 }
"5": { required-exp: 7000, max-members-bonus: 20, max-alliances-bonus: 2, max-rivals-bonus: 3 }
"6": { required-exp: 12000, max-members-bonus: 25, max-alliances-bonus: 3, max-rivals-bonus: 4 }
"7": { required-exp: 20000, max-members-bonus: 30, max-alliances-bonus: 3, max-rivals-bonus: 5 }
"8": { required-exp: 32000, max-members-bonus: 35, max-alliances-bonus: 4, max-rivals-bonus: 6 }
"9": { required-exp: 50000, max-members-bonus: 40, max-alliances-bonus: 4, max-rivals-bonus: 7 }
"10": { required-exp: 75000, max-members-bonus: 50, max-alliances-bonus: 5, max-rivals-bonus: 10 }The rival check is one way: it is enough that the killer's clan declared the victim's. With the rivals module off, or the multiplier at 1.0, no lookup is done. A clan at max-level stops gaining EXP, so overflow is not banked. The perk lines in the level menu use level.perk-line, level.perk-types and level.perks-none in the language file.
Something missing on this page? Tell us on Discord