CommunityVault
多人服务器全球共享储物箱
CommunityVault 是一款面向合作生存模式的服务器级存储系统。玩家可使用实体存取箱、分类整理以及搜索功能,来维护一个整洁且沉浸式的共享储物空间。

? 特性
-
? 全局保险箱:通过 /cvault 实现共享存储(任意位置只读)。
-
? 存取物品箱:使用 /buydc 和 /buywc 购买(费用可配置,允许设为 0)。
-
? 自动分类与归类:按材质整理物品;分类可在游戏内编辑。
-
? 保险箱搜索:/searchvault <关键词>(别名 /sv);面对取款箱时执行取款操作。
-
? 分页界面:简洁的页面,带有导航按钮和工具提示。
-
?️ 手动压缩:/cvaultcompact 将物品堆叠;不可堆叠的物品(如潜影盒)会安全保留。
-
? 状态命令:/cvaultstatus 显示堆叠/物品数量、备份、存档及容量状态。
-
? 重载命令:/cvaultreload 在不重启的情况下重新加载配置和分类。
-
? 自动化:漏斗/发射器/合成台可以向存储箱中存入物品(尊重容量限制)。
-
? 漏斗取物输出:为每个取出箱设置单一输出,让漏斗从中提取。
-
⛔ 容量限制:可选的最大容量上限,并在容量满时显示明确提示。
-
? 备份:在启动/关闭时自动备份,保留14天。
-
✅ 安全性:提取物品时会检查背包空间,若已满则回滚操作。
? 工作原理
- 购买存款箱(
/buydc)或取款箱(/buywc)。
- 存款箱:放入物品;它们会自动分类存入全局金库。
- 取款箱:打开并取出物品,或在注视它时使用
/sv <term> 进行搜索。
可选操作:从取款箱界面设置漏斗输出(每个箱子仅限单一输出)。
- 在任何位置通过
/cvault 查看金库内容(支持按类别、数量显示及分页浏览)。

? 箱子规则
- 存储箱仅能与存储箱配对。
- 提取箱仅能与提取箱配对。
- 普通箱子不能与特殊箱子(存储/提取)连接。
- 漏斗会从提取箱中提取选定的输出物品(暂存于中央槽位)。
? 分类管理
- 从保险库(书本图标)打开“管理分类”。
- 玩家可以重命名分类、更改图标,并默认编辑物品。
- 创建/删除分类需要权限。
- 物品可以属于多个分类。

⚙️ 配置亮点
diamondCostDepositChest / diamondCostWithdrawalChest
maxVaultCapacityEnabled
maxVaultCapacity
allowHopperWithdrawal
allowHopperDeposit
allowDropperDeposit
allowCrafterDeposit
? 权限
communityvault.compact (或 op): /cvaultcompact
communityvault.status (或 op): /cvaultstatus
communityvault.reload (或 op): /cvaultreload
communityvault.categories.view
communityvault.categories.create
communityvault.categories.rename
communityvault.categories.icon
communityvault.categories.additem
communityvault.categories.removeitem
communityvault.categories.delete
默认设置:
view、rename、icon、additem、removeitem 默认为开启。
create 和 delete 默认为 op。
核心功能(查看、通过提取箱进行存取)默认无需权限。服务器管理员可以通过其权限插件(如 LuckPerms 等)修改所有权限。
?️ 存储与数据
- 保险库和分类数据存储在
plugins/CommunityVault/ 目录下(YAML 格式)。
- 备份文件带有时间戳;旧备份在 14 天后自动清理。
- 不可堆叠物品(例如潜影盒)在压缩过程中永远不会合并。
?️ 路线图
- ? 更多权限节点和细粒度访问控制。
- ? 经济/保险库插件定价选项。
- ? 存取审计/历史记录。
- ?️ 管理员从备份恢复命令。
- ?️ 可选数据库后端,支持多服务器共享保险库。
- ? 主保险库菜单中的分页分类列表(适用于大量分类的情况)。
? 最后说明
CommunityVault 让共享存储保持生存友好:物理箱子、组织化的 GUI、快速搜索以及管理员安全工具。由 Niels 打造。旨在快速、友好且充满乐趣。需要帮助或有建议?在 Modrinth 上评论或在 GitHub 上提交问题。
统计
CommunityVault
A Global Shared Vault for Multiplayer Servers
CommunityVault is a server-wide storage system for collaborative survival. Players use physical deposit
and withdrawal chests, organized categories, and search to keep a clean, immersive shared vault.

? Features
- ? Global Vault: Shared storage via
/cvault (read-only anywhere).
- ? Deposit & Withdrawal Chests: Buy with
/buydc and /buywc (configurable costs, 0 allowed).
- ? Automatic Sorting & Categories: Items organized by material; categories editable in-game.
- ? Vault Search:
/searchvault <term> (alias /sv); withdrawing works when looking at a withdrawal chest.
- ? Pagination UI: Clean pages with navigation buttons and tooltips.
- ?️ Manual Compaction:
/cvaultcompact stacks items; unstackables (e.g., shulkers) are left safe.
- ? Status Command:
/cvaultstatus shows stack/item counts, backups, saves, and capacity status.
- ? Reload Command:
/cvaultreload reloads config and categories without a restart.
- ? Automation: hoppers/droppers/crafters can deposit into deposit chests (capacity-respecting).
- ? Hopper Withdrawal Output: set a single output per withdrawal chest and let hoppers pull it.
- ⛔ Capacity Limits: optional max-cap with clear messaging when full.
- ? Backups: automatic backups on startup/shutdown with 14-day retention.
- ✅ Safety: withdrawals check inventory space and roll back if full.
? How It Works
- Buy a Deposit Chest (
/buydc) or Withdrawal Chest (/buywc).
- Deposit chest: drop items in; they auto-sort into the global vault.
- Withdrawal chest: open and pull items or search with
/sv <term> while looking at it.
Optional: set a hopper output from the withdrawal chest UI (single output per chest).
- View the vault anywhere with
/cvault (categories, counts, pagination).

? Chest Rules
- Deposit chests only pair with deposit chests.
- Withdrawal chests only pair with withdrawal chests.
- A normal chest cannot attach to a special chest (deposit/withdrawal).
- Withdrawal hoppers pull the selected output item (buffered in the center slot).
? Category Management
- Open
Manage Categories from the vault (book icon).
- Players can rename categories, change icons, and edit items by default.
- Creating/deleting categories requires permissions.
- Items can belong to multiple categories.

⚙️ Config Highlights
diamondCostDepositChest / diamondCostWithdrawalChest
maxVaultCapacityEnabled
maxVaultCapacity
allowHopperWithdrawal
allowHopperDeposit
allowDropperDeposit
allowCrafterDeposit
? Permissions
communityvault.compact (or op): /cvaultcompact
communityvault.status (or op): /cvaultstatus
communityvault.reload (or op): /cvaultreload
communityvault.categories.view
communityvault.categories.create
communityvault.categories.rename
communityvault.categories.icon
communityvault.categories.additem
communityvault.categories.removeitem
communityvault.categories.delete
Defaults:
view, rename, icon, additem, removeitem are default true.
create and delete are default op.
Core usage (view, deposit, withdrawal via withdrawal chest) is permission-free by default. Server admins
can change all permissions with their permission plugin (LuckPerms, etc.).
?️ Storage & Data
- Vault and categories stored under
plugins/CommunityVault/ (YAML).
- Backups saved with timestamps; old backups pruned after 14 days.
- Unstackables (e.g., shulkers) are never merged during compaction.
?️ Roadmap
- ? More permission nodes and fine-grained access.
- ? Economy/Vault plugin pricing options.
- ? Audit/history of deposits/withdrawals.
- ?️ Admin restore from backup command.
- ?️ Optional database backend for multi-server/shared vaults.
- ? Paginated category list in the main vault menu (for large category counts).
? Final Notes
CommunityVault keeps shared storage survival-friendly: physical chests, organized GUIs, fast search, and
admin safety tools. Built by Niels. Designed to be fast, friendly, and fun. Need help or have suggestions?
Comment on Modrinth or open an issue on GitHub.
Stats
评论 0
登录后参与评分
还没有评论,来抢沙发吧