Content generated with AI — it may contain mistakes.

ExyliaClans/GuidesguideUpdated in v1.4.0

Set up clan levels

EXP from kills, kill streaks and rival multipliers, the ten-level table, and the caps and perks each level grants.

Page 7 of 296 min read

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 levels module must be on (it is by default), see Turn clan systems on and off.
  • Level changes you make in config.yml apply 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 whose required-exp the 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.

CapBase (shipped)At level 10 (shipped)
Membersmax-members, 3030 + 50 = 80
Alliancesmax-alliances, 55 + 5 = 10
Rivalsmax-rivals, 1010 + 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#

EventShipped 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.

Losing EXP can lose a level

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:

LevelPerks
1-2None
3-4money +5%
5-6money +5%, xp +5%
7-8money +10%, xp +5%
9-10money +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.

Servers that predate perks start without them

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's required-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
yaml
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