? XP-Vault: The Professional XP Ledger
XP-Vault (v1.21.11) 是一款高性能、集成于生存模式的实用工具,旨在平衡风险与回报。通过为经验等级提供一套均衡的“银行”系统,它在你的生存世界中增加了策略层面,同时保护你的时间投入免受意外死亡的损失。
✨ 主要功能
- ? 持久化存储: 存储的经验等级通过计分板与玩家绑定,这意味着即使死亡或书本丢失/被毁,数据依然保留。
- ? 精确增减: 支持通过按钮对经验等级进行 1、3、10 或 30 级的精确操作。
- ⚡ 批量操作: 使用 [STORE ALL](全部存入)和 [TAKE ALL](全部取出)按钮,快速清空经验条或提取全部银行经验。
- ? 动态反馈: 包含高保真原版音效和颜色编码的聊天消息,以确认每一笔交易。
- ?️ 通用访问权限: 基于
/trigger 系统设计,允许没有 OP/作弊权限的生存玩家无缝使用该界面。

? 生存合成与初始化
我们信奉“Vanilla+”的平衡理念。配方成本足够高昂,需获得认可,需要消耗 8 瓶附魔之瓶。
配方模式:
- 外圈: 8x 经验之瓶
- 中心: 1x 普通书
- 产出: 1x 知识之书(手持时自动转换为 XP-Vault)

? 技术文档(面向服务器管理员)
XP-Vault 专为稳定性和零 TPS 影响而构建。它避免了“每刻”执行的重型 NBT 扫描,转而采用轻量级的触发器架构。
? 计分板管理
数据包使用以下内部目标:
exp_stored:主目标。存储玩家的银行经验等级数量。
exp_current:用于经验条数据的临时计算缓冲区。
exp_takeX / exp_storeX:独立的触发器目标。
?️ 管理员实用命令
- 查看玩家的银行余额:
/scoreboard players get <playername> exp_stored
- 手动设置余额:
/scoreboard players set <playername> exp_stored 50
- 添加/奖励等级:
/scoreboard players add <playername> exp_stored 10
- 生成 Vault 书籍:
/function exp_book:give_book
? 测试流程
安装后验证数据包是否正常工作:
- 运行
/reload 并查找 “[Book of Experience] Datapack loaded” 消息。
- 给自己 30 级经验:
/experience add @s 30 levels。
- 合成或获取书籍并点击 [STORE ALL]。
- 运行
/scoreboard players get @s exp_stored。如果返回 30,则系统完全正常运行。
? 更新日志 v1.0.0 (v1.21.11)
- 1.21.x 组件迁移: 完全更新至新的
written_book_content 和 item_component 语法(1.20.5+)。
- 递归优化: 重写了
take_all_loop,以处理大量经验等级(1000+)而不会导致服务器卡顿。
- 语法加固: 将已弃用的
clickEvent 键替换为现代的 click_event 格式,以兼容 1.21.11。
- 自动转换: 改进了知识之书检测逻辑,使其响应更灵敏。
⚖️ 许可与权限
许可证: MIT License
- ✅ 你可以: 在整合包中使用、在服务器上展示,并为个人用途修改代码。
- ❌ 你不可以: 上传至其他平台(如 9Minecraft 等)或声称这是你自己的作品。
- ? 署名: 提及 “Sentrax” 或链接到本 Modrinth 页面是受欢迎的,但仅在重新分发修改版本时才强制要求。
? 安装方法
- 下载
XP-Vault.zip。
- 打开 Minecraft 世界文件夹 ->
datapacks。
- 将
.zip 文件放入其中。
- 加入世界并输入
/reload。
作者: Sentrax
兼容性: 1.20.5, 1.20.6, 1.21, 1.21.11
Checkout my other datapacks from OPSIBA007
? 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:
- Run
/reload and look for the "[Book of Experience] Datapack loaded" message.
- Grant yourself 30 levels:
/experience add @s 30 levels.
- Craft or give yourself the book and click [STORE ALL].
- 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
- Download the
XP-Vault.zip.
- Open your Minecraft world folder ->
datapacks.
- Drop the
.zip inside.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧