XenoLevels

levels.yml

Configure level formulas, requirements, and caps for each system.

levels.yml defines how players progress through a system. Use it to set starting values, max levels, EXP formulas, and optional requirements for individual milestones.

Key sections

PathDefaultDescription
levels.starting.level1Level assigned when a player joins the system for the first time.
levels.starting.exp0.0Starting EXP.
levels.min.level1Minimum level allowed.
levels.max.enabledtrueToggle the level cap.
levels.max.level200Highest level before prestiging or overflow.
levels.max.exp-overflow.enabledfalseAllow storing EXP beyond the cap.
levels.max.exp-overflow.maximum'5000 * {level}'Formula for the overflow limit.
levels.general.exp"100 * {level}"Baseline EXP requirement per level.
levels.general.placeholder"&7{level}"Default placeholder text for GUIs and lists.
levels.specific.<level>.expOverridesCustom EXP requirement for a level.
levels.specific.<level>.requirementsListOptional list of EXP expressions that must be met.
levels.specific.<level>.placeholderStringCustom placeholder text for a specific level.

Example overrides

levels:
  specific:
    25:
      exp: 5000
      requirements:
        - "KILL_MOB[50]:TYPE_CONTAINS=MONSTER"
        - "BREAK_BLOCK[10]:DIAMOND_ORE"
      placeholder: "&b{level}"
    100:
      exp: 40000
      requirements:
        - "KILL_MOB[500]:TYPE_CONTAINS=MONSTER"

Tip

Use the general formula for most levels and only override milestones that need unique requirements or placeholder colours.

Last updated on