宠物仓库

• 每位玩家最多存储 10 只驯服的伙伴（可配置）：狼、猫、鹦鹉、马、驴、骡、羊驼、悦灵以及任何其他玩家拥有的生物。
• 右键点击 你驯服的伙伴以将其 注册 到储物库中。
• 右键点击 已召唤的伙伴以将其从储物库中永久 注销（该动物仍会留在世界中）。
• 打开 径向菜单 查看所有已存储的伙伴，包括它们的名称、生命值和状态。
• 伙伴和升级内容绑定于 你，而非吊坠——丢失或更换吊坠永远不会影响你存储的伙伴。
• 使用生命水晶解锁 被动治疗——已存储的宠物会缓慢恢复生命值。
• 使用灵魂水晶解锁 宠物复活——如果已召唤的宠物死亡，它会在 5 分钟后以满生命值恢复。
• 治疗和复活计时器会在你离线期间继续推进。
• Curios / Trinkets 集成——在支持的平台上可将吊坠装备在专用装备槽中（见下方模组兼容性）。
• 开箱即用，兼容任何基于原版 TamableAnimal/OwnableEntity 的模组宠物或坐骑——无需额外设置。

• 以下之一：NeoForge、Forge 或搭配 Fabric API 的 Fabric

可选的装备槽模组——没有它们时吊坠也可从你的物品栏中生效，但专用槽位可以腾出空间：

• ✅ 已支持——已实现，当前可用
• 🛠️ 计划中——其他模组支持该加载器；我尚未实现
• ⏳ 受阻——其他模组尚无针对该加载器/版本的构建
• — 不适用——其他模组不会支持此情况

“Trinkets” 在不同版本中指的是不同的模组：在 1.20.1 和 1.21.1 上是原始的 dev.emi/trinkets，但在 26.1.x 上是 eu.pb4/trinkets（“Trinkets Updated”）——由于原始版本未针对该版本进行维护，这是一次从零开始的重写，具有不同的 API。

1.20.1 没有 NeoForge 列——我不支持该版本。

来自其他模组的宠物和坐骑： 对于任何基于原版 TamableAnimal/OwnableEntity 构建的内容都会自动生效。自动骑乘（Shift+左键召唤并骑乘）是按实体类型选择性启用的——将实体添加到 pet_vault:auto_rideable 标签或 extraRideableEntities 配置选项中即可为其启用 Shift+点击骑乘。完全没有归属概念的实体（例如铁傀儡、快乐恶魂）默认无法存储——请参阅下方配置，通过 storableEntities 配置选项或 pet_vault:storable 标签将其加入。

1. 合成或获取 守秘人吊坠 并将其放在你的物品栏中。
2. 右键点击任何你拥有的驯服伙伴以将其注册到储物库。
3. 按下 V 键（默认）打开径向菜单，并通过点击相应扇区来召唤或存储宠物。
4. 左键点击 扇区以召唤伙伴。再次 左键点击 将其存储。

守秘人吊坠

核心物品。将其放在你的物品栏中以访问径向菜单。右键点击你拥有的驯服伙伴以将其 注册 到储物库。右键点击已召唤的伙伴以将其从储物库中永久 注销（该动物仍会留在世界中）。

径向菜单控制：

• 左键点击——召唤或存储
• Shift+左键点击——召唤并立即骑乘（仅限可骑乘的伙伴）
• Ctrl+左键点击——在你正前方强制召唤
• 右键点击——切换保镖模式；当你受到伤害时宠物会自动召唤（以蓝线显示）
• Shift+右键点击——选择一个扇区（以黄色高亮）；对第二个扇区使用 Shift+右键点击可交换它们的顺序；再次点击同一扇区可取消选择

生命水晶

用 金苹果 被四个 绿宝石 环绕合成（无序合成）。消耗它会永久为你所有已存储的宠物解锁被动治疗——它们在存储期间每 3 秒恢复 1% 的最大生命值。

灵魂水晶

用 不死图腾 被四个 绿宝石 环绕合成（无序合成）。消耗它会永久解锁宠物复活——如果已召唤的宠物死亡，它不会被丢失，而是进入 5 分钟恢复期并以满生命值返回。

调试物品 （仅限创造模式）

可在 Pet Vault 创造模式标签页中找到。

• 金骨头——右键点击任何 未驯服 的可驯服生物以立即将其驯服归你所有
• 守秘人放大镜——检查附近生物的储物库数据和实体状态

首次启动时会在 config/pet_vault-common.toml 生成配置文件。所有设置会在重启或重新加载世界后生效。

允许特定生物： 有些实体在原版中完全没有归属概念（例如铁傀儡、快乐恶魂）。将实体 ID 添加到 storableEntities 配置选项，或将实体类型添加到 pet_vault:storable 数据包标签——任意一种方式都能将它们纳入存储。由于没有所有者可检查，它们采用先到先得的方式存储，但召唤其中一个会将其标记为你的所有物，因此当它在外时其他人都无法重新存储它。

通过数据包阻止特定生物： 将实体类型添加到 pet_vault:excluded 标签，这样你的模组就可以在不改动配置的情况下自带排除列表。

通过数据包允许更多可自动骑乘的生物： 将实体类型添加到 pet_vault:auto_rideable 标签，这样你的模组就可以在不改动配置的情况下自带可自动骑乘坐骑。

我需要将守秘人吊坠放在物品栏中吗？

是的，需要它才能打开径向菜单。如果安装了 Curios/Trinkets 构建版本，吊坠必须装备在其饰品槽中——如果你希望无论何时都能从物品栏打开它，请启用 allowUnequippedLocket 配置选项。丢失吊坠不会删除你存储的宠物——它们保存在你的玩家数据中，当你获得新吊坠时它们仍会存在。

治疗或复活计时器会在我离线时推进吗？

是的——当你重新登录时，模组会计算过去了多少时间并相应地应用治疗和复活计时器。

其他玩家可以通过拾取我的吊坠来偷走我的宠物吗？

不能。宠物专门绑定于你——拾取你的吊坠不会给予对你宠物的访问权限。

如果我尝试存储一个所在区块未加载的宠物会怎样？

Minecraft 只会在玩家附近保持实体加载，因此你留下的宠物可能最终处于服务器已卸载的区块中。当这种情况发生时，模组会在宠物所在区块卸载的那一刻标记其最后已知位置。如果你随后尝试存储该宠物，它会强制加载仅该区块，等待（最多约 10 秒）宠物重新出现，正常存储它，然后再次释放该区块——在此过程中你会看到 “Recalling...” 消息和短暂的冷却楔形提示。

这种情况失败的概率很低（例如区块加载耗时过长，或其他东西已经移动/移除了该实体）。如果失败了，宠物也不会丢失——储物库槽位会回退到其已存储状态，以便你稍后再次召唤它。在返回途中，它会被赋予新的身份，因为旧身份可能仍与加载失败的实体绑定。还有一种理论上更小的边缘情况，即那个原始实体最终仍然存活在某个地方（例如它稍稍晚了一点才重新开始 tick）——在这种不太可能的情况下，你可能会短暂地同时拥有两个它。实际上可以忽略不计，但值得了解。

本模组按 “原样” 提供，不附带任何形式的保证。
使用本模组即表示你同意作者不对因其使用而可能产生的任何损害、数据丢失、滥用或意外后果负责。
本项目与 Mojang、Microsoft 或 CurseForge 无关联。