弗金

Furkin

你是否曾看着那只跟着你回家的流浪狼，心想：你值得更好的，而不是坐在栅栏柱旁等我哪天想起你的存在？

Furkin 是一个轻量级的 Minecraft Forge 伙伴宠物框架。将原版动物契约化为伙伴，它们可以升级、学习技能、穿戴盔甲——而且因为冒险充满危险——在倒下后还能被复活。

在有人问之前先说明：猫和狗已开箱即用。 它们正是这个模组被构建的全部原因。

Minecraft 1.20.1 · Forge 47.0+ · Java 17 · 零依赖 · MIT

---

你实际能得到什么

• 契约 — 一份 Furkin 契约 即可将任何已注册的物种绑定到你身边。每次使用消耗一份，且不需要事先驯服，因此被动生物也可以使用。
• 技能树 — 共享主干加上各物种分支。狗偏向战斗，猫偏向侦察与支援。总计 13 个技能，并且完全数据驱动：将 JSON 放入 data/furkin/skills/ 然后 /reload。
• 装备 — 全部四个原版盔甲槽位。第三方盔甲零配置适配；属性通过原版属性系统结算。
• 旅行袋 — 一个随身物品栏，随 travel_pouch 技能等级增长，内置缩小、回收和死亡掉落处理。终于有别人帮你背圆石了。
• 伙伴名册 — 一本书即可管理你拥有的每一只宠物：召唤、召回、解绑、切换战斗模式。
• 复活 — 倒下的伙伴会掉落一颗灵魂石。捡起它，你就能将它们带回家，且所有等级完好无损。代价高昂，但它们值得。

---

快速上手

1. 合成一份 Furkin 契约（羊毛 + 纸）。
2. 右键点击一只有效的动物。它现在归你了——无需事先驯服。
3. 合成一本 Furkin 名册（契约 + 书）以召唤、召回和管理伙伴。
4. 潜行 + 右键点击你的伙伴以打开其面板——花费技能点、更换装备，或翻找旅行袋。
5. 后悔你的加点？合成一瓶 洗点药水（契约 + 水瓶）。不做评判。

这四件物品位于它们专属的创造模式标签页 Furkin 中（它们仍会出现在创造模式搜索里）。

倒下的伙伴会掉落一颗 Furkin 灵魂石。为此你需要一些羊毛……还有几朵花。

（好吧。十二朵花。这是仪式，不是建议。）

---

请阅读这一部分

• 右键行为会对你自己的伙伴接管。 对于绑定到你的动物，Furkin 会取消原版交互并自行处理：喂食、打开面板、契约。 检查很严格——它只适用于你自己的伙伴，并且只在你手持 Furkin 契约时生效。其他玩家的宠物和未绑定的原版动物不受影响。 如果你运行了另一个同样处理右键点击你自己猫或狗的模组，Furkin 会优先接管。 这是预期行为，不是 bug。
• 盔甲属性生效，盔甲外观不生效。 你的伙伴会从其穿戴的一切中获益，但盔甲不会在模型上渲染——与原版对大多数生物默认的做法相同。我们计算数值，不计算时尚。
• 所有调整都位于一个服务端 TOML 中（世界级别，加入服务器时自动同步）。当前数值是首版数值，后续可能会重新平衡。

---

致模组开发者

Furkin 同时充当一个前置模组：依赖它，然后注册你自己的物种、技能效果类型，或通过公开 API 响应升级。

FurkinApi.registerSpecies(EntityType.WOLF, ...);

任何已注册的物种都行。僵尸也行，只要你觉得它足够毛茸茸。:)

公开 API = 7 个类型，全部位于 com.wanancat.furkin.api 下。 该包之外的一切——尤其是 internal.*——均属实现细节，不承诺兼容性。本版本不附带独立 API jar，因此请将该边界视为一种约定，而非编译期壁垒。

版本方案为 MCVERSION-MAJORMOD.MAJORAPI.MINOR.PATCH。比较第二段（或调用 FurkinApi.getApiVersion()）；它当前为 0，意味着 API 尚不构成稳定性承诺。

---

兼容性

无 mixin、无访问转换器、无原版覆盖，所有 ID 均以 furkin: 命名空间。已在专用服务器、仅装此模组的原版客户端，以及 OptiFine 1.20.1_HD_U_I6 环境下验证——后者重写了 412 个原版类，因此算是一次不错的压力测试。

资源包风格的模组尚未逐一测试过。如果有什么渲染异常，请告诉我们。

---

安装

1. 安装 Minecraft Forge 1.20.1（47.0 或更高版本）。
2. 将 furkin-1.20.1-0.0.1.0.jar 放入你的 mods 文件夹。
3. 就这样。无依赖、无库模组、无必须先设置的配置。

---

反馈与 bug

两种渠道都行，哪个方便用哪个：

• 本页面的评论（开放，除 CurseForge 外无需账户）。
• GitHub issues：https://github.com/wanancat/furkin/issues —— 如果你想附上崩溃报告、日志，或一份可以持续编辑的复现步骤，这是最佳选择。

尤其欢迎兼容性报告。

许可证

MIT。 可自由使用、修改和再分发，包括用于整合包以及作为依赖。