v0.9.0 - Combat XP Modes & Item Requirements Patch Notes

New Combat XP Modes

• Damage-based combat XP - New combat XP mode where offensive weapon skills gain XP equal to damage dealt (1:1 ratio). A hit dealing 15 damage awards 15 XP. Simple and intuitive progression that scales naturally with weapon power
• Damage+Kill hybrid mode (new default) - Combines damage-based XP with mob kill bonuses. You earn 1 XP per damage dealt during combat, plus bonus XP when you land the killing blow (from mob-kill-xp.json with optional weapon scaling). This is now the default mode for new servers, providing more satisfying combat progression
• Four combat XP modes available - Choose from Damage (1:1), Damage+Kill (hybrid), Per-Hit (traditional weapon XP maps), or Kill-Only (XP only on kills) in the admin dashboard under General Settings

Item Level Requirements

• Skill-gated items - Weapons, tools, ores, and gems can now require specific skill levels to use. Players who don't meet the requirements see a red notification and cannot mine restricted blocks or deal damage with restricted weapons
• Tool requirements enforced when mining - When breaking a block, both the block AND the held tool are checked for level requirements. Using a high-tier pickaxe you don't meet the requirements for will prevent mining
• Multiple skill requirements - Items can require multiple skills with different levels (e.g., Mining 50 AND Smithing 30) plus an optional total level requirement
• Pattern-based matching - Requirements use the same longest-substring pattern matching as XP maps, so patterns like Ore_Mithril match all mithril ore variants
• Default ore progression - Ores are gated by Mining level out of the box: Copper (1), Iron (10), Silver (20), Gold (30), Cobalt (40), Mithril (50), Adamantite (60), Thorium (70), Onyxium (80). Gems require Mining 50-90
• Default tool/weapon progression - Tools and weapons are gated by their respective skills (10 tiers from level 1 to 80)
• Admin UI page - Configure item requirements from the admin dashboard via the new "Item Requirements" button. Browse by category (Tools, Weapons, Armor), view defaults vs overrides, add/edit/disable patterns
• Enable/disable toggle - The entire system is disabled by default. Enable it from the admin UI or config when ready
• Override-based config - Only your customizations are saved to mods/mmoskilltree/item-requirements.json. Defaults are preserved across updates

Tool & Weapon Requirements

• Tool-gated blocks - Blocks can now require specific tool types to break. Players who try to mine ores without a pickaxe, or chop logs without an axe, see a red notification and the action is cancelled
• Weapon-gated mobs - Mobs can require specific weapon types to damage. Server owners can configure special enemies that require specific weapons (e.g., ethereal enemies needing magic staves, armored enemies needing blunt weapons)
• Default block tool requirements - Out of the box, ores and rocks require pickaxes, logs require axes, and soil/dirt/sand blocks require shovels
• Pattern-based matching - Tool requirements use the same longest-substring pattern matching as other systems. Tool_Pickaxe_ matches all pickaxe variants regardless of material tier
• Separate from level requirements - Tool requirements check what TYPE of tool you need (pickaxe vs axe), while item level requirements check your SKILL LEVEL to use that tool. Both systems work together
• Admin UI page - Configure tool and weapon requirements from the admin dashboard via the new "Tool Requirements" button. Browse block tool requirements and mob weapon requirements in separate tabs, add/edit patterns with comma-separated tool lists
• Enable/disable toggle - The entire system is disabled by default. Enable it from the admin UI or config when ready
• Override-based config - Only your customizations are saved to mods/mmoskilltree/action-requirements.json. Defaults are preserved across updates

Admin UI

• Boost template batch controls - New "Disable All" and "Enable All" buttons on the Boost Templates page let you quickly disable or enable all templates for the selected target/category