家族树

族谱

自动追踪你驯服、繁殖的宠物的血缘关系，并在游戏中直观展示——它们的父母是谁、何时出生、由谁驯服，以及是否健在。驯服两只动物并繁殖后，模组会默默记录完整的家族谱系。你可以通过专属界面浏览所有数据（含动态3D宠物头像），或将宠物的家谱以可缩放树状图形式展开。

功能概述

每当被追踪的宠物繁殖时，族谱会自动记录幼崽的双亲、出生日期（含真实时间戳）、自动生成的名字、主人及物种。久而久之便会形成完整的、可浏览的动物家族史。当追踪的宠物死亡时，其记录会标记为"已故"并保留，而非直接消失。

数据存储在服务器（或单人存档）中作为可靠来源，GUI仅负责展示。

追踪物种

猫、狼、鹦鹉、马、驴、骡、羊驼、骆驼。

特性

• 🐾 自动血缘追踪：繁殖时自动记录双亲、出生日、主人、名字和物种，无需额外设置。
• 📍 宠物定位器 （新功能！）：使用指令 /familytree locate <名字> 可显示宠物坐标、所在维度及距离。若宠物所在区块未加载，则显示最后已知位置。从此告别猫咪失踪案。
• ⚰️ 死亡原因 （新功能！）：宠物死亡时记录死因。家谱中会显示"被苦力怕击杀，第43天"或"摔死，第12天"，而非仅标注"已故"。
• 🪄 连接木棍：在铁砧上将普通木棍重命名为 familytree，右键点击宠物即可在已有存档中记录亲子关系：依次点击父、母、子代，并通过可点击的聊天按钮确认。潜行+右键点击宠物可清除其已记录的父母。被点击的宠物会短暂发光，方便在猫群中精准选择。每次点击还会显示该宠物的已知父母和子代，并为模组安装前已驯服的宠物即时创建记录。
• 🖼️ 追踪宠物浏览器：可搜索、筛选的宠物列表，猫和狗显示动态3D模型头像（展示每只宠物的真实毛色变体），配以物种色卡及存活/已故状态标签。
• 🔎 筛选与搜索：显示全部/存活/已故，按名字或物种搜索，并可展开某一物种的合并树状图。
• 🌳 家谱视图：任意宠物的可缩放系谱图。节点包含3D头像、名字、物种、主人、年龄及死亡状态。配对父母并排显示，子代列于下方。
• ⚙️ 显示设置：在界面中直接切换是否显示年龄和/或出生日（默认均关闭）。
• 🛠️ 管理指令：手动配对/解除父母关系、修正年龄、导入现有宠物及清理记录。
• 🎮 服务器友好：管理员可查看所有玩家的宠物；原版客户端仍可加入安装模组的服务器。

如何打开界面

模组新增 "打开族谱" 按键。默认绑定为 H（可在 选项 > 控制 > 族谱 中重新绑定）；在游戏中按下即可。

使用连接木棍

适用于模组安装前已存在且未繁殖过的宠物：

1. 在铁砧上将普通木棍重命名为 familytree（不区分大小写）。
2. 依次右键点击父代、母代、子代。聊天栏会确认每次选择，宠物会短暂发光。
3. 点击聊天栏中的 [确认] 保存关联（或 [取消] 放弃）。
4. 潜行+右键点击宠物可清除其记录的父母（同样需要确认）。

只有同物种的已驯服宠物才能连接，且每次点击的宠物都会自动添加至追踪列表。

指令

所有指令均以 /familytree 开头：

指令	功能
/familytree list	在聊天栏列出所有被追踪的宠物。
/familytree scan	导入当前世界中已加载的已驯服宠物，并刷新现有记录的毛色变体。
/familytree locate <名字>	显示宠物的坐标、维度及距离。若宠物未加载则显示最后已知位置。列出所有同名宠物。
/familytree info [名字]	显示宠物详情，未指定名字时显示指令帮助。
/familytree pair <父代A> <父代B> <子代>	手动连接两个父代与子代（需同物种且三者不同）。
/familytree unpair <子代>	清除子代的父母关联。
/familytree setage <名字> <天数>	设置宠物的相对世界天数年龄。
/familytree setbirth <名字> <天数>	直接设置宠物的出生日。
/familytree prune deceased	删除所有已故记录。（仅管理员）
/familytree prune species <ID>	删除某一物种的所有记录，例如 minecraft:wolf。（仅管理员）

💡 在已有存档安装模组后，在宠物附近运行 /familytree scan 补录之前驯服的宠物，并填充用于3D头像的毛色变体。之后使用连接木棍记录亲子关系。

运行需求

• Minecraft 26.1.1
• Fabric Loader 和 Fabric API
• Java 25

服务器（或单人存档）端安装以实现追踪；客户端也安装才能使用游戏内界面。支持单人游戏和专用服务器。

许可协议

MIT 许可证。