XP and levelling

LevelSystem ext

LevelSystem provides configurable XP/levelling with persistence.

from bridge.extensions import LevelSystem

Constructor

LevelSystem(multiplier=100, exponent=1.5, persist=True)

• multiplier (float) — Base XP for level 1.
• exponent (float) — XP curve exponent. XP for level N = multiplier * N^exponent.
• persist (bool) — Save XP to plugins/PyJavaBridge/levels.json.

Usage

levels = LevelSystem(multiplier=100, exponent=1.5)

# Index notation
levels[player]  # current level (int)

Methods

xp(player) → float

Return the raw XP value tracked for player.

level(player) → int

Return the computed level for player.

add_xp(player, amount)

Add amount XP to player.

set_xp(player, amount)

Set player's XP to an exact amount.

set_level(player, level)

Set player to a specific level, adjusting XP accordingly.

xp_to_next(player) → float

XP needed for next level.

progress(player) → float

0.0 – 1.0 progress through current level.

Decorators

@levels.on_level_up

@levels.on_level_up
def leveled(player, old_level, new_level, system):
    player.send_message(f"§aLevel up! {{old_level}} → {{new_level}}")

Player Integration

Set Player._default_level_system = levels to enable player.xp and player.player_level.