XP-Book

# 📗 XP-Vault: The Professional XP Ledger **XP-Vault** (v1.21.11) is a high-performance, survival-integrated utility designed to bridge the gap between risk and reward. By providing a balanced "Banking" system for your experience levels, it adds a layer of strategy to your survival world while protecting your time investment from accidental deaths. --- ## ✨ Primary Features * 🔒 **Persistent Storage:** Stored levels are linked to the player via scoreboards, meaning they persist through death and even if the book is lost or destroyed. * 📈 **Precision increments:** Full control with buttons for **1, 3, 10, or 30** levels. * ⚡ **Bulk Operations:** Rapidly clear your XP bar or withdraw your entire bank with **** and **** buttons. * 🔊 **Dynamic Feedback:** Includes high-fidelity vanilla sound effects and color-coded chat messages to confirm every transaction. * 🛠️ **Universal Access:** Designed with the `/trigger` system, allowing **Survival players without OP/Cheats** to use the interface seamlessly. > !(https://cdn.modrinth.com/data/cached_images/b014cb33c6df9d0d910baa43d40b3143c0c6db1f.jpeg) --- ## 🔨 Survival Crafting & Initialization We believe in "Vanilla+" balance. The recipe is expensive enough to feel earned, requiring 8 Bottles o' Enchanting. **The Recipe Pattern:** * **Outer Ring:** 8x Experience Bottles * **Center:** 1x Regular Book * **Output:** 1x Knowledge Book (Auto-converts to XP-Vault upon holding) > !(https://cdn.modrinth.com/data/cached_images/16d382ea6b2ba87720dc7501cd7a36bbc9d4e167.jpeg) --- ## 💻 Technical Documentation (For Server Admins) XP-Vault is built for stability and zero TPS impact. It avoids "Every-Tick" heavy NBT scanning, favoring a lightweight trigger-based architecture. ### 📊 Scoreboard Management The pack uses the following internal objectives: * `exp_stored`: The master objective. Stores the player's banked level count. * `exp_current`: A temporary calculation buffer for XP bar data. * `exp_takeX` / `exp_storeX`: Individual trigger objectives. ### 🛠️ Admin Utility Commands * **Check a Player's Bank:** `/scoreboard players get <playername> exp_stored` * **Manually Set a Balance:** `/scoreboard players set <playername> exp_stored 50` * **Add/Reward Levels:** `/scoreboard players add <playername> exp_stored 10` * **Spawn a Vault Book:** `/function exp_book:give_book` ### 🧪 Testing Procedures To verify the pack is working correctly after installation: 1. Run `/reload` and look for the " Datapack loaded" message. 2. Grant yourself 30 levels: `/experience add @s 30 levels`. 3. Craft or give yourself the book and click ****. 4. Run `/scoreboard players get @s exp_stored`. If it returns **30**, the system is 100% operational. --- ## 📝 Changelog v1.0.0 (v1.21.11) * **1.21.x Component Migration:** Fully updated to the new `written_book_content` and `item_component` syntax (1.20.5+). * **Recursion Optimization:** Rewrote the `take_all_loop` to handle massive level counts (1000+) without causing server hanging. * **Syntax Hardening:** Replaced deprecated `clickEvent` keys with modern `click_event` formatting for 1.21.11 compatibility. * **Auto-Conversion:** Improved the knowledge book detection logic to be more responsive. --- ## ⚖️ License & Permissions **License:** MIT License * ✅ **You may:** Use this in modpacks, featured on servers, and modify the code for personal use. * ❌ **You may not:** Re-upload this to other platforms (9Minecraft, etc.) or claim it as your own creation. * 💎 **Credit:** Mentioning "Sentrax" or linking to this Modrinth page is appreciated but only required if you redistribute modified versions. --- ## 📥 How to Install 1. Download the `XP-Vault.zip`. 2. Open your Minecraft world folder -> `datapacks`. 3. Drop the `.zip` inside. 4. Join the world and type `/reload`. --- **Author:** Sentrax **Compatibility:** 1.20.5, 1.20.6, 1.21, 1.21.11 **Checkout my other datapacks from (https://modrinth.com/user/OPSIBA007)**