简易熊陷阱

简易捕熊夹

简易捕熊夹（Simply Bear Traps）为 Minecraft 添加了功能齐全、带有动画且可自定义的捕熊夹。

将捕熊夹放置在地面上，用来捕捉玩家和生物。一旦触发，捕熊夹会猛然合拢，造成伤害，并暂时阻止被困目标逃脱。

该模组旨在让捕熊夹保持简单实用的特性，适用于原版生存玩法，同时也为地牢、冒险地图、多人服务器和整合包提供了足够的自定义选项。

---

特性

• 可放置的功能性捕熊夹
• 由 GeckoLib 驱动的动画 3D 模型
• 捕熊夹可以捕捉玩家和生物
• 四种不同材质的捕熊夹：
  • 铁质
  • 金质
  • 钻石质
  • 下界合金质
• 根据材质不同，造成不同的伤害、束缚时间和重置速度
• 被困玩家可以通过挣扎来更快逃脱
• 挣扎会造成额外伤害
• 其他玩家可以帮助被困玩家脱困
• 捕熊夹自动重置
• 专用的捕熊夹工具，用于交互和回收捕熊夹
• 回收后的捕熊夹保留其属性
• 掉落物可以触发捕熊夹
• 飞行中的箭矢可以触发捕熊夹
• 可配置玩家、生物和 Boss 是否能被困住
• 支持染色的捕熊夹，并带有颜色混合功能
• 提供实体类型标签，便于整合包兼容
• 自定义进度

---

捕熊夹材质

捕熊夹有四种材质可供选择：

铁质捕熊夹
标准、均衡的捕熊夹。

金质捕熊夹
触发更快的捕熊夹，伤害较低，束缚时间较短。

钻石质捕熊夹
更强力的捕熊夹，伤害更高，束缚时间更长。

下界合金质捕熊夹
最强版本，专为危险生物和高等级玩法设计。

每种材质的具体伤害、束缚时间和重置时间均可通过配置文件修改。

---

捕熊夹染色

捕熊夹可以被染色，以便与周围环境融为一体。

染料颜色应用于整个捕熊夹模型，并直接存储在捕熊夹上。

所选颜色在以下情况下会保留：

• 捕熊夹被放置时
• 捕熊夹被回收时
• 捕熊夹存储在物品栏中时
• 捕熊夹作为物品掉落时

颜色还可以混合，从而产生比原版 Minecraft 染料调色板更广泛的颜色范围。

这使得捕熊夹可以在草地、洞穴、沙漠、地牢和其他环境中进行伪装。

---

捕捉与逃脱

当玩家或生物触发捕熊夹时，捕熊夹会合拢并对目标造成伤害。

被困实体会暂时无法直接走开。

被困玩家可以通过挣扎来更快逃脱。然而，挣扎会造成额外伤害，这就需要在等待释放和尝试提前逃脱之间做出风险/回报的选择。

其他玩家也可以帮助被困玩家脱困。

在释放目标后，捕熊夹可以自动重置，并准备好再次触发。

这些机制可以通过配置文件进行自定义。

---

配置

简易捕熊夹包含一个配置文件，面向玩家、服务器所有者、地牢制作者和整合包开发者。

大多数重要的捕熊夹机制都可以在不修改模组本身的情况下进行调整。

通用设置

以下行为可以配置：

自动重置
控制捕熊夹在释放目标后是否自动重置。

自动重置延迟
控制捕熊夹在开始自动重置过程之前等待的时间。

触发冷却
控制捕熊夹打开后再次激活前的宽限期。

挣扎逃脱加成
控制被困玩家在挣扎时获得的逃脱进度。

挣扎伤害
控制被困玩家在挣扎时受到的伤害。

释放后缓慢时长
控制逃脱捕熊夹后缓慢效果的持续时间。

释放后缓慢等级
控制释放后缓慢效果的强度。

玩家触发
控制玩家是否可以触发捕熊夹。

生物触发
控制非玩家生物实体是否可以触发捕熊夹。

Boss 被困
控制被归类为 Boss 的实体是否可以被捕获。

物品触发
控制掉落物品是否可以触发捕熊夹。

箭矢触发
控制飞行中的箭矢是否可以触发捕熊夹。

---

材质设置

每种捕熊夹材质都可以独立配置。

铁质、金质、钻石质和下界合金质捕熊夹可以修改以下数值：

• 伤害
• 束缚时间
• 重置时间

这允许整合包制作者为生存世界、PvP 服务器、硬核整合包或自定义地牢重新平衡所有四种捕熊夹等级的发展进程。

---

整合包与地牢支持

简易捕熊夹在设计时考虑到了整合包和地牢的兼容性。

提供了实体类型标签，这样无需修改简易捕熊夹本身，就可以对其他模组中的实体进行分类。

这对于 Boss、NPC、多部分实体、脚本实体以及其他在被困时可能无法正常行为的特殊生物尤其有用。

捕熊夹免疫实体

提供以下实体类型标签：

beartrapmod:trap_immune

包含在此标签中的实体无法被捕熊夹捕获，无论正常的生物或 Boss 配置如何。

将实体添加到 trap_immune

数据包可以通过提供以下文件来扩展该标签：

data/beartrapmod/tags/entity_types/trap_immune.json

示例：

{
  "replace": false,
  "values": [
    "examplemod:example_mob",
    {
      "id": "examplemod:example_boss",
      "required": false
    }
  ]
}

"replace": false 会在不替换简易捕熊夹已定义实体的前提下添加您的条目。

当引用可选模组中的实体时，建议使用 "required": false。这可以防止在未安装所引用的模组时标签加载失败。

---

Boss 实体

简易捕熊夹还提供了：

beartrapmod:bosses

包含在此标签中的实体被捕熊夹系统视为 Boss。

这些实体是否真的能被捕获，由 trapBosses 配置选项控制。

添加自定义 Boss

创建：

data/beartrapmod/tags/entity_types/bosses.json

示例：

{
  "replace": false,
  "values": [
    {
      "id": "examplemod:example_boss",
      "required": false
    }
  ]
}

该实体现在将被简易捕熊夹视为 Boss。

如果在配置中禁用了 Boss 捕捉，则该实体无法被捕获。

如果启用了 Boss 捕捉，则该实体可以被捕获，除非它也包含在：

beartrapmod:trap_immune

---

标签优先级

实体捕捉遵循以下优先级：

beartrapmod:trap_immune
→ 该实体永远无法被捕获。

beartrapmod:bosses
→ 该实体遵循 trapBosses 配置。

其他生物实体
→ 它们遵循普通的玩家或生物配置。

这允许整合包制作者通过数据包为其他模组的实体添加兼容性，而无需修改简易捕熊夹本身。

---

进度

简易捕熊夹包含与使用和交互捕熊夹相关的自定义进度。

一些进度会奖励成功捕获猎物，而另一些则涉及被困在捕熊夹中挣扎所带来的更危险后果。

---

需求

• Minecraft: 1.20.1
• 模组加载器: Forge
• 必需依赖: GeckoLib

请确保安装了适用于 Minecraft 1.20.1 对应版本的 GeckoLib。

---

兼容性

某些模组实体使用自定义移动系统、多部分身体、传送、Boss 阶段或其他特殊机制，在被困时可能无法正常行为。

如果遇到此类实体，可以通过将其添加到以下标签来将其排除在捕捉系统之外：

beartrapmod:trap_immune

这可以通过数据包完成，而无需修改简易捕熊夹本身。

---

反馈与 Bug 报告

这是简易捕熊夹的首次发布。

欢迎提交 Bug 报告、兼容性报告、平衡性反馈和功能建议。

当报告与其他模组的不兼容问题时，请尽可能提供模组名称和受影响的实体。

允许用于整合包。欢迎将简易捕熊夹包含在您的整合包中。