XenoLevels

Rewards and Boosters

Celebrate milestones and pace progression with multipliers.

Reward automation and boosters are the heart of XenoLevels engagement loop. Use them together to celebrate milestones and speed up progression when you want players to catch up.

Rewarding milestones

  • Define payout packages per level inside rewards.yml.
  • Mix console commands, chat messages, sounds, titles, and action bar text to make each reward memorable.
  • Use pattern-<id> blocks when multiple levels share the same definition or should only apply at certain prestiges.
  • Prevent duplicate payouts by enabling system.prevent-duplicate-rewards in system.yml.

Claim experience

  • Players open the rewards GUI with /xlv rewards <system> or click GUI buttons defined in gui.yml.
  • /xlv rewards claim <system> [level] lets them grab everything at once or focus on a single milestone.
  • Localise confirmation and error messages in lang.rewards.claim entries inside lang.yml.

Boost progression responsibly

  • Configure boosters in boosters.yml to grant timed multipliers.
  • Combine requires.permissions, requires.level, and date or time windows to limit who can activate a booster and when.
  • Decide how boosters stack—multiplicatively or additively—and whether negative EXP should be scaled.

Sync with other plugins

  • PlaceholderAPI exposes xlv_* placeholders so you can surface reward status or active boosters in scoreboards and chat.
  • Vault support allows rewards to pay money or deduct balances when paired with conditions.yml costs.

Design idea

Create weekend boosters that target casual players while prestige rewards unlock cosmetics or perks for long-term veterans.

Last updated on