DualExp: Split XP Roles – Level vs Currency

Minecraft 版本： 1.21.1 1.21.2

平台： neoforge

标签： adventure game-mechanics library

DualExp: Split XP roles: level vs currency

DualExp is a Minecraft mod that separates the traditional XP system into two distinct roles: Level, used for gating access to features like enchanting, and Currency, used for spending experience on actions.
This decoupling allows more precise control over progression mechanics and paves the way for modpacks or datapacks to define their own experience usage models.

By default, XP orbs contribute to both roles simultaneously, but mod developers and pack creators can fully customize how experience is earned, stored, and consumed. DualExp provides a lightweight yet extensible API for accessing, syncing, and manipulating both XP roles independently.

Ideal for RPG systems, custom economies, or any mod that wants to treat XP as more than just a single pool.

Features

Core Mechanics

This mod intercepts vanilla XP behavior using Mixin:

• XP gain/consumption is fully rerouted to rune gain/loss.
• XP level increases remain vanilla; level reductions are translated to rune loss.
• Experience orbs grant both XP and rune.
• /xp affects only XP; a new /rune command (renameable) manages rune.

Secondary Mechanics

• A constant (or in future: a mapping table) determines how XP translates to rune values.
• A simple client-side HUD displays rune information.
  • Customizable via config options.
• Rune and XP behavior on death respects the keepInventory rule.