Truly Best Friends Forever

驯服的狼、猫、马、鹦鹉以及其他模组添加的宠物都会自动登记。每只宠物的完整 NBT 数据都会单独存储，并通过索引进行管理。

需要降低扫描开销的服务器可以在配置中启用 performanceMode。此选项会关闭自动追踪及其他高开销扫描。之后必须通过手动操作登记宠物：手持羽毛右键点击宠物，或使用 /tbf load。登记物品及其是否会被消耗均可配置。

可以通过可配置的按键绑定打开宠物界面。安装兼容版本的 L2 Library 后，也可以通过 Pet Companions 背包标签页打开。

界面会显示每只宠物的名称、生命值、维度和坐标。宠物的最新状态会实时从服务器同步。

• 点击收纳按钮即可保存宠物，并安全地将其移出世界。再次点击即可放出宠物。
• 宠物收纳的距离限制和冷却时间均可配置。
• 点击收纳按钮时按住 Shift，即可一次召回多只附近的宠物。
• 使用鼠标滚轮可调整区域召回半径，范围为 1 至 16 格。默认半径为 8 格。

无论身处哪个维度，都可以将宠物召唤到主人身边。坐下的宠物在被召唤后会自动起身。

如果宠物所在区块尚未加载，模组会创建待处理的召唤，并在区块可用后完成传送。强制加载区块和实体去重机制可防止生成重复宠物。

骑乘已登记的宠物时，其他曾经骑乘过的宠物对应的召唤按钮会变为“切换坐骑”。点击后会召唤新的坐骑，并自动收纳当前坐骑。

按住 Shift 可将“切换坐骑”按钮恢复为普通的“召唤”按钮。

• 普通治疗会消耗 3 点食物值，并使选中的宠物获得持续 15 秒的治疗。
• 按住 Shift 可使用高级治疗：消耗 9 点食物值，并以更高频率治疗宠物。
• 剩余治疗持续时间最多可延长至 60 秒。
• 创造模式玩家不会消耗食物值。

被追踪的宠物死亡时，模组会保存其状态并阻止物品掉落，避免反复复活导致物品复制。随后可以在管理界面中消耗指定的复活物品使其复活。默认情况下，复活需要消耗一个不死图腾。

复活后的宠物会获得不死图腾赋予的相同效果：生命恢复、伤害吸收和抗火。

需要保持正常死亡和掉落行为的实体类型，可以添加到 noReviveWhitelist 或 clearOnDeathWhitelist。

移除追踪中的存活宠物需要两步确认，以防误删：

1. 左键点击删除按钮，进入待删除状态。
2. 按住 Shift，再次左键点击以确认。

从追踪中移除已存储的宠物时，宠物会先被放回世界中。移除已死亡的宠物后，它会继续正常的死亡流程。

如果启用了 deleteStoredPetsDirectly，被召回或已死亡宠物的存储数据将被永久删除，且不会释放该实体。

• 按宠物种类筛选列表。
• 按名称搜索宠物。
• 按住 Shift 并左键点击宠物图标，可为宠物设置 1 到 6 的优先级，用于列表排序。
• 被玩家扛在肩上的宠物（例如鹦鹉）仍会继续受到追踪，并会在离开肩膀后自动关联到新的 UUID。

该模组提供专用的队伍编辑器：

• 最多可创建 8 支宠物队伍。
• 每支队伍默认可容纳 6 只宠物。使用 maxPendingSummons 可将上限调整至 8 只。
• 将宠物拖入队伍栏位，或选中宠物后点击空栏位中的加号按钮。

按住可配置的队伍轮盘按键，打开当前队伍的径向菜单。将指针移到宠物上后松开按键或左键点击，即可召唤宠物。轮盘也支持切换坐骑。点击瓶子图标可召唤整支队伍。

该模组还会单独备份可携带容器实体的物品栏 NBT，例如装备了箱子的马。模组实体的任意栏位数量均受支持。

在 Minecraft 1.21.1 中，安装 Curios 9.5.1+ 后，还可将宠物饰品作为完整实体快照的一部分进行备份和恢复。

该模组为 20 多个常见维度提供英文和中文显示名称，包括原版的三个维度、暮色森林、Blue Skies、天境、Everbright/Everdawn、The Undergarden、Bumblezone、Tropicraft、Gaia Dimension、The Midnight，以及 Ad Astra 中的行星和轨道。服务器管理员也可以通过配置添加自定义维度名称。

服务器停止运行时，可以直接编辑已存储宠物的 .nbt 文件。更改会被保留，并在服务器下次启动时应用到实体。