# 🧱 CommunityVault 🧱
## 一个全球共享保险箱插件，适用于多人服务器
CommunityVault是一个服务器范围内的物品存储系统，专为协作生存游戏而设计。它拥有实体的存款/取款箱，组织有序的类别和强大的搜索功能，创造了干净且沉浸式的共享存储体验——同时保持了友好的生存游戏氛围。
### 🌟 特色
🔓 全球保险箱：一个服务器范围内的共享存储系统，可通过 **/cvault** 访问
📦 存款和取款箱：
玩家可以通过 **/buydc** 和 **/buywc** 各自花费5个钻石购买存款/取款箱
箱子允许物理物品的存取 — 没有物品的即时传送！
🧠 自动排序：
物品根据它们的材质类型进行排序
例如：附魔剑，普通剑，或损坏的剑都将进入剑的类别
🗃️ 自定义类别：
可通过 categories.json 文件轻松配置
定义您自己的组，例如“矿石”、“工具”、“木材”等。
🔍 保险箱搜索系统：
使用 **/searchvault ** 查找特定物品
当查看取款箱时，**/searchvault ** 也可以用来取出物品
🧭 只读保险箱视图：
玩家可以使用 **/cvault** 随时随地浏览保险箱
按类别排序，包含物品数量和分页
📑 分页：
干净的 GUI，带有分页的类别内容视图
⚙️ 完全持久化：
保险箱和类别数据保存为JSON，并在重启后依然存在
🧵 异步文件写入：
数据保存经过优化，以避免在进行大量物品存入时的卡顿
❌ 不需要权限（目前）：
任何人都可以使用该系统 — 权限支持即将推出
### 🧱 工作原理
玩家购买一个存款箱 (**/buydc**) 或取款箱 (**/buywc**)，花费5个钻石。
存款箱接受物品并自动将其分类到全球保险箱中。
取款箱允许玩家使用 **/searchvault ** 提取特定物品。
玩家可以使用 **/cvault** 随时查看保险箱，按类别排序并带有分页。
如果箱子被破坏，它就会消失 — 玩家必须购买一个新的。
### 🛠️ 存储系统
保险箱和类别数据存储在 vault.json 和 categories.json 中
使用材质类型来对物品进行分类和分组 (附魔/耐久度不会影响排序)
自定义类别很容易编辑和重新加载
### 🛣️ 发展路线图：
🔐 添加权限节点以进行高级访问控制
🛒 配置购买箱子的费用
📚 保险箱历史/日志（谁何时存取了什么）
⛔ 保险箱容量限制和每个类别的配额
🛠️ 管理员覆盖工具
🌍 世界守卫区域保护集成
### 💬 最终说明
CommunityVault 适用于希望共享存储，但又不失沉浸感的生存或半角色扮演服务器。 它将玩家互动、基于 GUI 的浏览和基于命令的搜索融为一体，形成一个连贯的系统。
由 Niels 构建 — 设计为快速、友好和有趣。
需要帮助或有建议？在 Modrinth 上发表评论或在 GitHub 上打开问题！
### 统计
