Furkin

你有没有看过那只跟你回家的流浪狼，心想：你值得更好的待遇，而不是一直坐在栅栏旁，直到我想起来你还在？

Furkin 是一款轻量级的 Minecraft Forge 宠物伙伴框架。将原版动物契约为伙伴，让它们升级、学习技能、穿戴盔甲——而且，毕竟冒险充满危险，它们倒下时你还能把它们带回来。

先替大家解答：猫和狗开箱即用。这整个模组就是为了它们而做的。

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

你能获得什么

契约 — 一张Furkin Contract可将任意已注册物种与你绑定。每次使用都会消耗一张，而且不要求预先驯服，所以被动型生物也能契约。
技能树 — 共享主干加上各物种专属分支。狗偏向战斗，猫偏向侦察与辅助。总共有13 项技能，并且完全由数据驱动：把 JSON 放进data/furkin/skills/和/reload即可。
装备 — 原版盔甲的四个槽位全部可用。第三方盔甲无需任何配置即可适配；属性通过原版属性系统计算。
旅行袋 — 可随身携带的物品栏，会随着travel_pouch技能等级提升而扩容，并内置缩容、取回和死亡掉落处理。终于有人替你背圆石了。
伙伴记录 — 一本书管理你拥有的所有宠物：召唤、召回、解除绑定、切换战斗模式。
复活 — 伙伴倒下时会掉落一块灵魂石。捡起来就能带它们回家，等级也会完整保留。代价不低，但它们值得。

这四种物品都在名为Furkin的独立创造模式分类栏里（在创造模式搜索中也能找到）。

伙伴倒下时会掉落一块Furkin Soulstone。你得准备些羊毛……还有几朵花。

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

你自己的伙伴的右键交互行为会由本模组接管。对于绑定到你的动物，Furkin 会取消原版交互并接手处理：喂食、打开面板、使用契约。
判定十分严格——只有你自己的伙伴，以及手持 Furkin Contract 时才会触发。其他玩家的宠物和未绑定的原版动物不受影响。
如果你安装的其他模组也会处理右键点击你自己的猫或狗，Furkin 会优先接管。这是预期行为，不是漏洞。
盔甲属性有效，盔甲外观不会显示。伙伴会获得所穿盔甲带来的所有效果，但模型上不会渲染盔甲——这和原版对大多数生物的默认处理方式相同。我们计算属性，不负责穿搭。
所有参数都保存在服务端 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 个原版类，因此是相当不错的压力测试。

我们还没有逐一测试所有资源包风格的模组。如果遇到渲染异常，请告诉我们。

以下任一渠道均可，选择你觉得方便的方式：

在此页面发表评论（页面开放，无需 CurseForge 之外的账号）。
提交 GitHub issue：https://github.com/wanancat/furkin/issues——如果你想附上崩溃报告、日志，或可持续编辑的复现案例，这种方式最合适。

尤其欢迎提交兼容性报告。

MIT。可免费使用、修改和再发布，包括用于整合包或作为依赖项。