📗 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 [STORE ALL] and [TAKE ALL] 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.

---

🔨 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)

---

💻 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 "[Book of Experience] Datapack loaded" message.
2. Grant yourself 30 levels: /experience add @s 30 levels.
3. Craft or give yourself the book and click [STORE ALL].
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 OPSIBA007