宠物饲料

MCPets 4.0.0 版本能够轻松在游戏中修改宠物选项，只需使用 /mcpets editor 命令即可 这将会节省不少配置时间!

使用实用型宠物时，可以充分利用饲料，既可以用来治疗你的宠物，也可以用来驯服宠物。

关于宠物饲料，有两种选择：

1 - 原版物品

你可以使用原版物品作为宠物的饲料.只需要将 "ItemId" 属性设置为需要作为饲料的物品的材质名称,你可以在 Spigot API 页面找到所需的材质名称

# petFood.yml 配置文件的部分设置实例
CarrotFood:
  ItemId: CARROT
  # ... 其它宠物饲料配置

2 - 自定义物品

你可以使用自定义物品来喂养你的宠物. 首先，确保已经使用命令 "/mcpets item add"（需要手持物品）将你想要用作宠物饲料的物品添加到MCPets. 使用命令后你会获得插件为该自定义物品生成的 ID，然后将该 ID 填入配置文件中即可.

# petFood.yml 配置文件的部分设置实例
CustomItemFood:
  ItemId: petFoodId
  # ... 其它宠物饲料配置

类型	可选作用方式	描述
HEALTH	add, multiply	影响宠物的生命值
TAME	add, multiply	影响宠物的驯化进度
EXP	add	影响宠物的经验值
EVOLUTION	​	使宠物A进化为指定的宠物B
UNLOCK	​	玩家使用饲料来解锁新的宠物 (需要 LuckPerms )
BUFF_DAMAGE	add, multiply	给予宠物临时的伤害增益效果
BUFF_RESISTANCE	add, multiply	给予宠物临时的抗性增益效果
BUFF_POWER	add, multiply	给予宠物临时的力量增益效果

当使用之前的命令将物品添加到 MCpets 后，或选择原版物品作为宠物饲料，可以打开 "./plugins/MCPets/petFood.yml" 文件，并按照以下示例添加新的宠物饲料

# 译者示例
custom_food_1:
  display: "火龙果"
  lore:
    - "新鲜的火龙果，让你的宠物充满活力。"
  item_id: "MINECRAFT:PINK_DYE"
  
custom_food_2:
  display: "甜甜圈"
  lore:
    - "美味的甜甜圈，适合喜欢吃甜品的小家伙。"
  item_id: "MINECRAFT:GLAZED_TERRACOTTA"

宠物饲料示例：驯服&生命恢复

# 宠物饲料实例
# 饲料名称不允许重复
TamingBerries:
  # 填入使用 /mcpets items 后生成的id
  ItemId: taming_berries
  # 选择饲料类型 : 
  # - TAME 驯服饲料
  # - HEALTH 治疗饲料
  Type: TAME
  # 设置对选定的饲料类型具体的影响程度
  # 注意 : 驯服进度介于 0 - 1 之间，当进度到达1时视为已驯服
  Power: 0.25
  # 选择作用类型:
  # - ADD 添加到当前数值上
  # - MULTIPLY 与当前数值相乘
  Operator: ADD
  # | 可选 |
  # 当饲料的配置中设置了 "Signal" 时，将会把特定的信号发送给宠物
  # 如果宠物正在监听这个信号，就可以触发宠物所关联的 MythicMobs 技能来执行一些特定的动作或效果
  # 如果您需要了解更多有关 MythicMobs 技能系统和如何使用信号的信息，可以查看 MythicMobs Wiki 中的相关文档
  # https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/skills/mechanics/signal
  Signal: TAMING
  # | 可选 |
  # 在该属性下可以指定宠物饲料的兼容性，即该饲料是否仅适用于特定宠物
  # 如果没有设置该属性，或者将该字段留空，该宠物饲料将默认为适用于所有宠物
  Pets:
  - Nocsy_Yokibird-Dark
  - Nocsy_Yokibird-Orange


# "FeedingCarrots" 为另一个宠物饲料，用于治疗目的
# 以原版的胡萝卜（CARROT）作为饲料，提供了20的生命值恢复
# 由于无法区分不同类型的原版胡萝卜(其它原版物品同理)，
# 应该避免在配置中使用两次 "CARROT"（比如：在此处用了Carrot，就不能再次使用，但是可以使用 "GOLDEN_CARROT" ）
FeedingCarrots:
  ItemId: CARROT
  Type: HEALTH
  Power: 20
  Operator: ADD

宠物饲料示例：进化

该饲料允许玩家将特定宠物进化为不同的宠物形态，从而为创建进化树等系统提供了多样性

# 宠物进化饲料示例
EvolutionItem:
  ItemId: evolution_crystal
  Type: EVOLUTION
  # 进化后的宠物 ID
  Evolution: Nocsy_Drakonin_Adult-Fire
  # (可选) 指定宠物在能够使用该饲料前需要达到的经验阈值
  ExperienceThreshold: 300
  # (可选) 定义在宠物饲料使用后，与实际进化发生之前的延迟时间
  # 该延迟时间内你可以在宠物进化期间执行一些特定的动画或效果
  DelayBeforeEvolution: 60
  # | 可选 |
  # 用于发送给宠物一个特定的信号
  # 如果宠物监听了该信号，可以触发相关的 MythicMobs 技能，例如进化动画
  # 详细用法参阅 : https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/skills/mechanics/signal
  Signal: EVOLVE
  # 允许使用该进化饲料进行进化的宠物
  # 在该属性下可以指定宠物饲料的兼容性，即该饲料是否仅适用于特定宠物
  # 如果没有设置该属性，或者将该字段留空，该宠物饲料将默认为适用于所有宠物
  Pets:
  - Nocsy_Drakonin_Baby-Fire

宠物饲料示例：解锁宠物

玩家可以消耗该饲料来解锁新的宠物，同时它们会自动检查玩家是否已经拥有该宠物，并可通过权限来控制玩家的使用. 这些特性使得可以在游戏中实现宠物解锁系统

# 解锁饲料示例
UnlockItem:
  ItemId: evolution_crystal
  Type: UNLOCK
  # (可选) 该饲料的使用权限
  Permission: perm.to_use_the_item
  # 对应解锁的宠物ID
  UnlockPet: Nocsy_Yokibird_Orange

宠物饲料示例：增益

您可以使用宠物饲料创建临时的增益效果，例如伤害增加、力量或抗性提升，或者相反的减益效果

以下为伤害增加的临时增益效果示例:

# 增益饲料示例
DamageBuffFood:
  ItemId: power_buff_lollipop
  # 可选类型： BUFF_DAMAGE, BUFF_RESISTANCE , BUFF_POWER
  Type: BUFF_DAMAGE
  # 增益的值
  Power: 10
  # 选择作用类型:
  # - ADD 添加到当前数值上
  # - MULTIPLY 与当前数值相乘
  Operator: ADD
  # 效果持续时间（ticks）
  # 1 s = 20 ticks,  600 ticks = 30 s.
  Duration: 600