Pufferfish Skills Leveling

🚀 This major update introduces a revolutionary Custom Class Framework, a robust Experience Tome system, and advanced World Gating to deliver a premium MMORPG experience for modpack creators and server owners.

Note: This is optional if you don't use Rise of Heroes. This system simply won't work without it, but you can still benefit from some of the item restriction system functionality. Support for controlling class assignment directly via command (for use with NPCs) is coming soon.

🎭 Custom Class System (Rise of Heroes Bridge)

• Branching Class Evolution: No longer restricted to a flat list of 10 classes. The new DataPack framework allows for hierarchical branching paths. By defining parent_id relationships in your class configs, you can create "Progressive Classes" — in the advancement UI, players will only see the specific evolution paths available to their current class.
• Total Control: Selectively disable or override base classes (Warrior, Sorcerer, etc.) to fully tailor the class pool to your server's theme.
• Scriptable Advancement: The /skillleveling advanceclass command enables seamless class transitions via Custom NPCs, quest rewards, or automated scripts — giving you full narrative control over player evolution.
• Attribute Mastery: Classes feature fine-tuned attribute scaling that grows with the player's Pufferfish levels, ensuring a balanced but powerful late-game experience.

🖼️ Bespoke UI & Rendering

• Cinematic Entity Preview: The class selection and advancement menus have been overhauled to support Epic Fight Animations. Configured classes can now showcase their battle-ready stances directly in the UI.
• Smart Animation Fallbacks: Classes without a specific animation set will automatically use a polished default idle pose, ensuring every class looks professional in the preview screen.
• Dynamic Passive Parsing: The UI now automatically "reads" your Pufferfish skill categories. The top 4 unlocked/unlockable skills from your mapped category are dynamically displayed as "Class Passives" in the selection screen, giving players a clear preview of their future power.
• High-Fidelity Rendering: Full support for GeckoLib Armors and TACZ firearms. Preview icons and models accurately display attachments, custom skins, and NBT attributes exactly as they appear in-game.

📗 Experience Tomes & Progression

• Experience Tome Infrastructure: A new progression tier with items that grant Pufferfish category XP — fully configurable via DataPacks with bulk-consume support.

Skill Master Shop Overhaul

• Premium Inventory: Blank Tomes removed from the trade pool. The Skill Master now stocks a dynamic 15/10/75 mix of high-value Experience and Skill Tomes.
• Guaranteed Stock: Improved fallback logic keeps the shop always populated with relevant items, even for players who have mastered most categories.
• Mastery Economics: Global skill mastery now impacts the Skill Master's reputation — unlocking better prices and more frequent rare tome offers.

🏰 Advanced World Gating (Restrictions)

• Contextual Power Gating: Restrict item usage, block breaking, or entity interactions based on granular conditions like Dimension, Time of Day, or Environmental State (in_water).
• Resilient Data Loading: Completely rebuilt the restriction manager for reliable loading across diverse and complex DataPack hierarchies.
• [COMING SOON] Structure Gating: Proximity-based gating near structures (Dungeons, Spawn Protection, Event hubs) — currently in internal testing.

🛠️ Stability & Performance

• Verified Stability: Tested in environments with 160+ mods to ensure maximum compatibility and zero conflicts with major modded systems.
• Optimized via Spark: All core logic — including the dynamic trade provider and world restriction scanner — profiled and optimized for negligible TPS impact.
• Seamless XP Synchronization: New "Sync Depth" architecture eliminates double-notification spam and ensures XP deltas are perfectly mirrored between Pufferfish and Epic Classes.