Roles and levels

roles.yml

yaml

roles:
  leader:
    name: Leader
    rank: 3
    permissions:
      - clan.disband
      - clan.invite
      - clan.war
      - clan.settings
      - clan.bank.withdraw
  officer:
    name: Officer
    rank: 2
    permissions:
      - clan.invite
      - clan.kick
  member:
    name: Member
    rank: 1
    permissions:
      - clan.bank.deposit
default-role: member

The key (leader) is the id used in /clan setrole. The name is what players see.
rank is an integer. Higher beats lower, and a member can never act on somebody of equal or higher rank.
The highest rank in the file is automatically given to whoever creates a clan.
default-role is what new members receive.

You can add intermediate roles freely. A five-tier hierarchy works as long as every rank is distinct.

Renaming leader to warden and giving it the theme's name is the intended use: nothing in the code depends on these ids.

levels.yml

yaml

levels:
  1:
    experience-required: 0
    perks:
      member-slots: 10
      bank-capacity-bonus: 0.0
      home-cooldown-reduction: 0
  2:
    experience-required: 1000
    perks:
      member-slots: 15
      bank-capacity-bonus: 250000.0
      home-cooldown-reduction: 5
max-level: 3
experience-sources:
  clan-create: 100
  member-join: 50
  war-kill: 25
  war-win: 500

Perks

Perk	Effect
`member-slots`	Maximum members. Invitations, joins and request approvals are rejected once reached
`bank-capacity-bonus`	Added to `max-balance` from `bank.yml`
`home-cooldown-reduction`	Seconds subtracted from the home teleport cooldown

Perks resolve cumulatively upwards: a level 3 clan gets the highest value defined at or below its level, so you only need to declare a perk on the level where it changes.

Experience sources

The four keys above are granted by the plugin itself. With the PulsePrison bridge active, clan-xp-sources.yml adds mining and prestige on top.