XenoLevels

Progression Overview

Understand how systems, levels, and prestiges fit together.

XenoLevels treats progression as a collection of systems. Each system lives in plugins/XenoLevels/systems/<system>/ and can target a different playstyle—survival progression, mining, combat, or prestige ladders.

Systems at a glance

  • Register systems inside systems/systems.yml.
  • Each system folder includes system.yml, levels.yml, exp-events.yml, and optional files for rewards, boosters, GUI, and anti-abuse rules—use the Event Catalog when planning those EXP triggers.
  • You can run multiple systems in parallel and assign a default via default-system.

Level curve

  • Define starting level and EXP requirements in levels.yml.
  • Use the general.exp formula for the baseline and override specific milestones under levels.specific.
  • Requirements can reference Experience Event filters so milestone levels demand extra achievements.

Prestiges

  • Enable prestiges when you want long-term resets with new perks.
  • Configure the ladder in prestiges.yml by listing required levels and optional reset behaviour.
  • Combine prestige unlocks with reward patterns or booster requirements to make each tier meaningful.

Data storage

  • Choose your backend in config.yml. XenoLevels supports SQLite, MySQL/MariaDB, PostgreSQL, and MongoDB.
  • Auto-save keeps player data safe at the interval defined under config.auto-save.

Cloning a system

Duplicate the generated systems/main folder, rename it, then register the new key in systems/systems.yml. Adjust the configuration files inside the new folder to shape unique progression paths.

Last updated on