束缚之魅的伙伴们

咒缚伙伴

咒缚伙伴增加了一种通过单个咒缚护身符控制的魔法宠物伙伴。右键点击护身符即可打开你的伙伴收藏，通过主题化的游戏挑战解锁宠物，然后召唤拥有独特实用能力的忠诚伙伴。

版本目标

• Minecraft Java：1.20.1
• 模组加载器：Forge
• Forge 目标版本：47.4.10
• 模组 ID：charmboundcompanions
• 当前模组版本：1.0.1
• 当前目标：单人游戏 Forge 1.20.1

专用服务器支持目前未测试，也不支持。

模组功能

咒缚伙伴围绕一个核心物品构建：咒缚护身符。玩家无需为每个宠物携带单独的护符，而是使用护身符打开他们的伙伴收藏，选择一个已解锁的伙伴，然后召唤或解散它。

每个玩家只允许有一个激活的伙伴。召唤一个新伙伴会先安全地解散上一个激活的伙伴。

安装

1. 安装 Minecraft Java 1.20.1。
2. 安装 Forge 1.20.1。
3. 将 charmboundcompanions-1.0.1.jar 放入你的 Minecraft mods 文件夹。
4. 启动 Forge 1.20.1 配置文件。

咒缚护身符

• 物品 ID：charmboundcompanions:charmbound_amulet
• 指令：/give @p charmboundcompanions:charmbound_amulet
• 可在咒缚伙伴创造模式标签中找到。
• 右键点击打开伙伴选择 GUI。
• 护身符使用后不会被消耗。
• 其物品栏和手持图标使用原版火焰弹的外观。
• 提示文本："右键点击打开你的伙伴收藏。"

合成配方

在普通工作台中，用 4 个金锭放在四个角，1 个铁锭放在中心，合成 1 个咒缚护身符。

G _ G
_ I _
G _ G

G = 金锭 I = 铁锭

伙伴 GUI

咒缚护身符 GUI 会列出每个当前伙伴的名称、角色、能力名称、简短描述、状态以及召唤/解散按钮。锁定状态的伙伴会在护身符菜单中显示其解锁要求和进度。

当前伙伴

烬狐

一只火热的狐狸伙伴，可以烹饪生食，并在火灾紧急情况下为你提供短暂的火焰抗性。

• 角色：火焰生存伙伴
• 能力：烬火之温
• 使用原版风格的狐狸模型和纹理。
• 通过用打火石点燃 50 次火焰来解锁烬狐。
• 解锁进度会显示在咒缚护身符 GUI 中。
• 跟随主人并散发火焰粒子。
• 每 30 秒在其附近烹饪 1 个支持的原版生食。
• 当主人燃烧或最近接触过熔岩时，给予 5 秒的火焰抗性。
• 火焰抗性冷却时间：60 秒。

苔龟

一个温和的自然伙伴，可以给予短暂的抗性提升，并在附近时缓慢治疗你。

• 角色：防御型自然伙伴
• 能力：翠绿之壳 / 温柔绽放
• 使用原版风格的乌龟模型和纹理。
• 通过挖掘 50 个沙块来解锁苔龟。
• 解锁进度会显示在咒缚护身符 GUI 中。
• 跟随主人并散发自然粒子。
• 每 20 秒在附近时给予持续 6 秒的抗性提升 I。
• 如果主人受伤、处于附近且饥饿值高于 6 点，每 30 秒治疗主人 1 颗心。
• 苔龟的移动速度经过调整，比原版乌龟更能跟上行走的玩家。

辉蛾

一个发光的洞穴伙伴，激活时提供持续的夜视能力，并短暂高亮附近的敌对生物。

• 角色：洞穴视野伙伴
• 能力：灯笼粉尘
• 通过在黑暗区域或夜间放置 50 个火把来解锁辉蛾。
• 解锁进度会显示在咒缚护身符 GUI 中。
• 跟随并在主人附近飞行。
• 散发柔和的光芒粒子。
• 激活时提供持续的夜视能力。
• 当灯笼粉尘激活时，短暂揭示 20 格内附近的敌对生物（给予发光效果）。

幸运兔

一个幸运的伙伴，每 2 分钟可以找到一些有用的物品和偶尔的简单采矿资源。

• 角色：幸运伙伴
• 能力：幸运跳跃
• 使用原版风格的兔子模型和纹理。
• 通过收集 50 个煤炭、粗铜、粗铁或粗金来解锁幸运兔。
• 解锁进度会显示在咒缚护身符 GUI 中。
• 跟随主人并散发快乐粒子。
• 每次触发时在附近给予 1 个小型有用物品。
• 奖励池包括农业物品、简单生存物品和偶尔的采矿资源。
• 可能的奖励包括：小麦种子、甜菜种子、胡萝卜、马铃薯、苹果、线、羽毛、兔子皮、煤炭、粗铜、粗铁、红石粉、青金石、粗金、金粒、紫水晶碎片。
• 幸运跳跃不会给予钻石、绿宝石、下界合金、附魔书、盔甲、工具、武器、稀有生物掉落物或完整的矿石块。

蜜蜂

一个农业伙伴，可以传播魔法花粉来温和地促进附近作物生长。

• 角色：农业伙伴
• 能力：授粉光环
• 使用原版风格的蜜蜂模型和纹理。
• 通过收获 50 个完全成熟的作物来解锁蜜蜂。
• 解锁进度会显示在咒缚护身符 GUI 中。
• 跟随并在主人附近飞行。
• 每 45 秒促进附近最多 3 个支持的作物生长一个阶段。
• 支持的作物包括：小麦、胡萝卜、马铃薯、甜菜、南瓜茎、西瓜茎、甜浆果丛。
• 授粉光环不会收获作物、创造免费物品或直接给予玩家物品。

基本伙伴规则

• 伙伴会跟随它们的主人。
• 如果伙伴离主人太远，它们会传送靠近。
• 在正常游戏过程中，伙伴完全不受伤害。
• 玩家、生物、弹射物、爆炸、火焰、熔岩、溺水、摔落伤害、窒息、仙人掌、冰冻、魔法、凋零、中毒、闪电和环境伤害无法杀死伙伴。
• 伙伴不会攻击生物。
• 伙伴不会掉落战利品或经验值。
• 伙伴不会自然消失。
• 伙伴通过咒缚护身符的解散/交换系统或安全清理逻辑来移除。

CurseForge 上传说明

使用以下命令构建发布 jar：

./gradlew build

在 Windows 上：

gradlew.bat build

可上传的文件是 charmboundcompanions-1.0.1.jar，应该是常规的重新混淆 jar，而不是 sources/dev jar。README.md 和 CHANGELOG.md 可用于 CurseForge 的描述和更新日志字段。

已知限制

• 当前目标是单人游戏 Forge 1.20.1。
• 专用服务器支持目前未测试，也不支持。
• 所有当前伙伴都有解锁要求，进度会显示在咒缚护身符 GUI 中。
• 一次只能激活一个伙伴。
• 伙伴视觉效果主要使用原版风格的模型/占位符，未来可能会改进。
• Ember Cook（烬狐烹饪）仅支持原版生食。
• 跨维度伙伴传送尚未实现。

计划的未来功能

• 更多伙伴。
• 更多解锁要求和进度目标。
• 伙伴升级。
• 伙伴皮肤。
• 可配置的能力调整。
• 更好的自定义模型和动画。
• 与其他食物或烹饪模组的可选集成。