Levels Matter Add-On

Levels Matter turns your XP bar into a character progression system. Every time you reach a new personal-best XP level, you earn a point you can spend on 8 upgradeable attributes or save up to unlock one of 8 powerful skills. Your playstyle changes, but Minecraft still feels the same.

Version 1.0.5 Release Date 19 May 2026 Last Update 19 May 2026 Minecoin Cost 490 Join the Community

View on Minecraft Marketplace

Video blocked

This video requires cookies from YouTube. Manage cookies

✦ AI Generated This wiki page was generated with AI assistance. If you spot an inaccuracy, log in to suggest an edit, or let us know on Discord.

Getting Started

How It Works

Levels Matter layers an RPG attribute system on top of standard Minecraft survival. You don’t need to craft anything or find a special location. Play normally and earn XP. Every time your XP level reaches a new personal-best, you receive one attribute point.

Only new high scores count. Losing levels to death and regaining them does not award duplicate points. You have to push further than you’ve ever been.

Note

Interface Spawn Egg: You automatically receive one on every respawn and every level-up (if you don’t already have one). Use it to place your attribute interface screen anywhere in the world.

Quick-start Steps

1. Join a survival world with the add-on active.
2. Earn XP through any normal activity: mining, combat, smelting, fishing, etc.
3. Each time you hit a new highest XP level, you earn 1 attribute point.
4. Use the Interface Spawn Egg (given automatically) to place the interface screen.
5. Interact with the screen to open the attribute management UI.
6. Press + to allocate points to any attribute, then hit Save to apply them.
7. Switch to the Skills page with the next/prev buttons to unlock skills with your points.
8. Keep grinding XP to unlock more points and push all attributes to 100.

The Interface

The interface is a 3D interactive book entity you place in your world. Interact with it to open the management screen. Press Jump or Sneak to close it at any time.

The book has two pages, Attributes and Skills. Flip between them with the prev/next buttons. The Info and Settings buttons work on whichever page you’re on.

Caution

The interface requires sufficient clear space around you to open. If it won’t open, make sure you’re standing in an open area.

Tip

On touch and mobile devices, the interface scales up for legibility and zooms in toward the page edges when you look off-centre.

Control	Description
+ / -	Allocate or remove attribute points (not yet saved).
Skill button	Click a locked skill on the Skills page to spend points and unlock it.
Save	Confirm all pending changes. Points are applied immediately.
Refund	Return all spent points and re-lock every skill. Costs 10 Emeralds. Requires a double-click to confirm.
Settings	Host-only toggle for Prevent XP Loss on Death and other options.
Info	In-game reference page describing each attribute or skill.

Attributes

There are 8 attributes, each scaling from level 0 to 100 along a balance curve. Spend points however you like. A fully offensive build is just as valid as a defensive one.

AOE Damage

AOEDamage

On hit, triggers chain lightning that arcs to nearby enemies. Scales chain chance (0-50%), reach (0-12 blocks), and max targets (0-12). Chains can't cascade. Has a 5-tick cooldown. Applies knockback to chained targets.

Sprint Speed

SprintSpeed

Increases movement speed while sprinting. Scales from 0% to +130% bonus speed, applied the moment you start sprinting.

Crit Chance

CritChance

Grants a chance to deal double damage on hit. Scales from 0% to 100% crit chance. Critical hits reduce the target's HP directly.

Health Regen

HealthRegen

Passive regeneration while out of combat. After a 5-second combat delay, heals 1 HP at an interval that shrinks from every 160 ticks down to every 4 ticks.

Increased XP

IncreasedXP

Spawns bonus XP orbs whenever you gain XP. Multiplier scales from 0% to +200% bonus XP. Capped at 500 orbs per tick. Suppressed during death XP restoration to prevent exploits.

Luck

Luck

Chance to receive bonus loot when mining ores (17 ore types supported) or killing entities. Scales from 0% to 25%. Uses the entity's own loot table for bonus drops. Does not trigger in Creative mode.

Less Hunger

LessHunger

Reduces exhaustion gain each tick. Scales from 0% to 95% reduction. Intercepts the exhaustion delta every tick to apply the reduction.

Knockback

Knockback

Amplifies knockback dealt to entities on hit. Scales from 0% to +1200% bonus knockback. Scales existing velocity and preserves direction. Requires a minimum horizontal velocity of 0.01 to activate.

Skills

Skills are 8 one-time unlocks that give you new abilities. Unlike attributes, skills don’t level up. You pay a fixed cost in attribute points to unlock one, and it stays unlocked.

Skills share the same point pool as attributes, so every unlock is a trade-off. Spend points on attributes for raw scaling, or save them up to unlock skills for new mechanics.

Note

Refunding (10 Emeralds) is a full progression reset. It returns all spent attribute points and re-locks every skill you’ve unlocked. The refunded skill costs go back into your unspent pool.

Necromancer

20 pts

When you kill a humanoid mob, there's a 50% chance to raise a friendly Skeleton from the corpse. Works on 15 mob types including Zombies, Drowned, Skeletons, Piglins, Vindicators, and Witches. Your skeletons follow you wolf-style and teleport to you if they fall more than 12 blocks behind. They're sun-immune for 5 minutes, then die naturally with a warning visual in the last 10 seconds.

Double Jump

15 pts

Press Jump while airborne to get one extra jump. Sprinting when you trigger it adds a forward burst. Fall damage in the brief window after a double jump is fully cancelled.

Life Steal

10 pts

Melee and projectile hits heal you for 15% of the damage you deal, capped at 25% of your max HP per hit. Particles stream from the target to you to show the drain.

Second Life

20 pts

A fatal hit is cancelled and you're restored to 20% HP. You also get Regeneration II for 15s, Absorption II for 8s, and Resistance II for 4s, plus a shockwave that damages and knocks back nearby hostiles. 5-minute cooldown, saved between sessions.

Explosive Arrows

10 pts

Bow and crossbow arrows explode on impact. Each explosion deals 5 damage and applies knockback within 3.5 blocks.

Tree Capitator

15 pts

Breaking a log with an axe chain-breaks the whole tree, up to 200 logs. Works on all vanilla wood types including Crimson and Warped stems.

Vein Miner

10 pts

Breaking an ore with a pickaxe chain-breaks the connected vein, up to 64 blocks.

Luminescence

5 pts

While active, you place invisible light blocks (light level 10) in a cross pattern around you as you walk. The lights vanish when you move away. No tool or fuel required.

Settings

Prevent XP Loss on Death

Host only.

When enabled, all players in the world keep their XP on death. They respawn with the same levels they had. Only the world host can toggle this setting from the interface’s Settings panel.

Note

When this setting is active, the Increased XP attribute is automatically suppressed during death XP restoration. This prevents players from exploiting the death-restore loop to gain bonus XP orbs.

Debug Commands

These commands can be entered in the Minecraft chat to test or verify add-on functionality. Cheats must be enabled.

Reset Player Data

Wipes all progression (levels, unspent points, and attribute allocations) for the player who runs it.

/scriptevent shapescape_lvm:reset_data

Set Attribute Level

Directly set any attribute to a specific level. Useful for testing effects without grinding XP.

/scriptevent shapescape_lvm:attribute set <AttributeId> <points>

Max out all attributes at once:

/scriptevent shapescape_lvm:attribute set AOEDamage 100
/scriptevent shapescape_lvm:attribute set SprintSpeed 100
/scriptevent shapescape_lvm:attribute set CritChance 100
/scriptevent shapescape_lvm:attribute set HealthRegen 100
/scriptevent shapescape_lvm:attribute set IncreasedXP 100
/scriptevent shapescape_lvm:attribute set Luck 100
/scriptevent shapescape_lvm:attribute set LessHunger 100
/scriptevent shapescape_lvm:attribute set Knockback 100

Spend / Refund Points

Spend or refund a specific number of points on an attribute programmatically.

/scriptevent shapescape_lvm:attribute spend <AttributeId> <points>
/scriptevent shapescape_lvm:attribute refund <AttributeId> <points>

Utility

Command	Effect
/function shapescape/lvm/addon_version	Prints the current add-on version to chat.
/function shapescape/lvm/starting_eq	Re-gives the Interface Spawn Egg.

Valid Attribute IDs: AOEDamage, SprintSpeed, CritChance, HealthRegen, IncreasedXP, Luck, LessHunger, Knockback

Tips

• Push new highs to earn points. Only levels you’ve never reached before award attribute points. Focus on steadily climbing.
• Save before closing. Points allocated with + / - are pending until you hit Save. Closing the interface without saving discards unsaved changes.
• Refunding costs emeralds and re-locks skills. A refund returns all attribute points and re-locks every skill you’ve unlocked. It costs 10 Emeralds and there’s no partial refund.
• Attributes vs skills. Attributes scale your stats, skills give you new abilities. Decide which you want before you spend, because unlocking a skill is one big lump cost.
• Multiplayer. Each player tracks their own progression independently. The host’s XP Loss setting applies to everyone, but attribute points, levels, and skills are per-player.
• Increased XP stacks with grind. Investing early in Increased XP creates a compounding effect. You level up faster, earn more points sooner, and can reinvest into other attributes or skills.
• AOE Damage chains don’t cascade. A single strike can chain to up to 12 targets, but those chained hits won’t trigger further chains. The 5-tick cooldown prevents chain reactions from spiralling.