Legacy Vault

无论身处哪个世界，你的物品始终为你保留。

Legacy Vault 为每位玩家提供一个独立于世界之外的个人物品栏。放置一个保险库方块并打开它，存入的物品就会一直属于你。切换到新世界或重新开始，你的保险库依然存在。保险库数据存储在服务器上，因此你可以在该服务器的任何世界中使用自己的物品。

保险库类型

质朴保险库

个人保险库，只有你能打开。合成时将箱子放在配方中央。

经典保险库

同样是个人保险库，但外观不同。合成时将木桶放在配方中央。

共享保险库

所有玩家（或白名单中的玩家）都可以访问的共享保险库。非常适合用作服务器商店、捐赠箱或阵营储物空间。这里也可以使用完整的扩容和搜索功能。

保险库扩容

新玩家初始拥有1 行，共 9 个格子。使用保险库升级物品解锁更多行，最多可扩展至10 行（90 个格子）。

• 手持保险库升级物品时，右键点击保险库即可解锁下一行。
• 升级物品使用后会被消耗（创造模式下除外）。
• 你的等级会继承到其他世界——在一个世界达到 5 级后，进入下一个世界时，扩容后的保险库也会在那里等你。
• 保险库升级物品有几率从冒险宝箱中掉落——包括地牢、废弃矿井、要塞、神庙、林地府邸、末地城、下界要塞、堡垒遗迹和远古城市。掉落几率和数量均可配置。

服务器管理员可以更改初始容量、最大容量，以及是否按世界重置等级进度。

保险库界面功能

• 滚动条——在同一屏幕中浏览所有物品栏行。
• 已锁定格子指示——尚未解锁的行会显示醒目的 X 覆盖标记，让你清楚看到后续可解锁的格子。
• 搜索栏——输入文字即可淡化不匹配的物品。物品仍留在原位，方便你查看它们的位置。
• 排序按钮（Az）——单击即可按字母顺序排列已解锁的行。已锁定的行不会受影响。
• 物品数量提示——将鼠标悬停在物品上，如果其他格子里还有相同物品，就会显示“保险库中 × N”。

管理员与服务器功能

所有命令都需要权限等级 2，并以 /legacyvault 为命令前缀：

物品白名单与黑名单

使用数据包物品标签控制哪些物品可以放入储物库：

• legacyvault:vault_items_whitelist — 仅允许这些物品
• legacyvault:vault_items_blacklist — 禁止放入这些物品

会优先检查标签列表。配置中的正则表达式仍可作为备用规则使用。

默认禁止（以防绕过槽位上限）：

• Iron Chests
• Sophisticated Backpacks、Sophisticated Storage
• Traveler’s Backpack
• Treasure2 的箱子和容器

储物库加密（可选）

在服务器配置中开启 encryptVaultData（或使用 /legacyvault encryption on），磁盘上的储物库文件就会被加密，除非拥有服务器密钥，否则无法读取。此功能可防止文件被盗和 UUID 伪造。可随时安全切换；现有文件无论加密功能是否开启，都能正常使用。

重要：请备份 config/legacyvault/legacyvault-secret.dat。如果丢失此文件，将无法读取已加密的储物库。

防崩溃保存

储物库文件会先写入临时文件，再替换原文件，因此保存期间即使发生崩溃或断电，也不会损坏数据。

配置要点

所有设置均位于 serverconfig/legacyvault-server.toml。

前置要求

• 必需的前置库： GottschCore

模组兼容性

Legacy Vault 旨在与热门模组共存。默认情况下，以下储物模组无法放置在金库内部（否则会绕过槽位上限）：

• 铁箱子
• 精妙背包 / Sophisticated Storage
• Traveler’s Backpack
• Treasure2

服务器管理员可以在配置文件中使用物品标签或正则表达式自定义此列表。