一、开启与使用

生物捕捉需服务器 1.20.5+，默认关闭。在 capture.yml 中设置 enabled: true，保存后使用 /cpp reload 重载。

/cpp giveCapture 玩家名 example 1

玩家主手持捕捉道具，直接近战攻击目标生物。右键、投掷、远程攻击及横扫伤害不触发捕捉；外观相同的普通物品也不能代替插件发放的道具。

1. 本次攻击必须造成伤害，且扣除本次最终伤害后，目标仍存活、剩余血量不高于 healthPercent 设置的百分比。
2. 生物类型需符合 mobs、blacklist，且基础精灵 companion 已配置。玩家及末影龙不能捕捉。
3. 满足条件后按 chance 判断成功率：成功或概率失败都会消耗一个道具。
4. 成功时取消该次伤害，移除原生物，并将精灵加入仓库；概率失败时仍正常造成攻击伤害。
5. 血量不符、致死攻击、类型不符、仓库已满或入库失败时，不消耗捕捉道具；攻击仍按普通攻击处理。

捕捉精灵的属性与能力来自 companion 指定的基础精灵，外观使用被捕获的生物类型；不保存原生物的自定义名称、装备、颜色、年龄等个体数据，也不会自动选用。

二、配置示例

以下为 capture.yml 示例，可在 captures 下增加多种道具。

enabled: true
mobScale:
  pig: 0.5
captures:
  example:
    material: LEAD
    name: "&a捕捉道具 &e猪"
    custom-model-data: 0
    isEnchant: true
    tooltipStyle: ""
    itemModel: ""
    description:
      - "&7手持道具近战攻击猪"
      - "&7攻击后血量不高于10%时，80%概率捕捉"
    companion: reaper
    mobs:
      - pig
    blacklist:
      - ender_dragon
    healthPercent: 10
    chance: 80

• example：捕捉道具 key，用于 /cpp giveCapture。
• material：近战使用的物品材质，避免使用右键会投掷或消耗的材质。
• companion：基础精灵 key，必须存在于 companions/*.yml。
• mobs：允许捕捉的生物类型，支持 pig、minecraft:pig；空列表或 all 表示不限类型。
• blacklist：禁止捕捉的生物类型，优先级高于 mobs；末影龙始终不支持。
• healthPercent：攻击后剩余血量百分比上限，范围 0–100，0 表示无法捕捉。
• chance：血量达标后的成功率，范围 0–100。
• isEnchant：是否显示附魔光效；custom-model-data 需 1.14+，tooltipStyle、itemModel 需 1.21.2+。

三、捕捉精灵缩放

capture.yml 顶层的 mobScale 按生物类型设置捕捉外观倍率，如 pig: 0.5 表示原始大小的一半。

未配置单独倍率的捕捉生物，如果原始高度超过约 0.9875 格，会自动缩小到该高度；较小生物保持原始大小。显式配置倍率时优先使用配置值。

普通精灵配置中的 mobScale 默认 0.5；捕捉得到的实例使用本页的缩放规则，详见精灵模型。