Pet config

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

在 MythicMobs 中设置了宠物之后，你可能想由 MCPets 来接管并生成它

为此，你需要创建一个宠物配置，具体是装饰型宠物（Cosmetic Pet）还是实用型宠物（Living Pet）取决于你的具体需求

每只宠物都单独需要一个配置文件，你可以在路径 "./plugins/MCPets/Pets/自己创建的文件夹/你的宠物配置文件.yml" 中进行创建、修改或删除操作.

请确保每只宠物的ID都是唯一的，以避免出现各种奇怪的错误.

✨ 装饰性宠物配置

以下为典型的装饰宠物配置模板，其中包含了许多功能，但并非所有功能都是必需的. 装饰型宠物是处于无敌状态的，与具有生命值、属性、等级、等..数据的实用型宠物不同，不需要每个属性都进行设置，许多属性都是可选的，例如：皮肤、信号等...

# 宠物ID
Id: your_pet_id
# 宠物的生物ID
MythicMob: the_mythicmob_attached_to_the_pet
# 召唤宠物所需的权限
Permission: permission.to.summon.the.pet.can.be.custom
# 是否允许宠物被骑乘
# 若设置为true，请确保宠物模型具有 `mount` 骨骼
# (有关骨骼具体参阅 https://github.com/Ticxo/Model-Engine-Wiki/wiki/Mechanics/#mountmodel)
Mountable: false
# [可选]宠物骑乘操作类型，默认为 `walking`
# (具体参阅 https://github.com/Ticxo/Model-Engine-Wiki/wiki/Mechanics/#mountmodel)
MountType: walking
# 当玩家取消骑乘时是否移除该宠物
DespawnOnDismount: false
# [可选]当该宠物为坐骑时，是否在生成时自动骑乘
AutoRide: false
# (可选) 宠物骑乘权限
MountPermission: mcpets.mount_mypet
# 宠物移除时执行的技能
# | 注意 : 这将会阻止 AdvancedPet 自动删除宠物
# | 因此，请确保在宠物 "DespawnSkill" 技能结束时执行 "remove @self" 机制
# | 以确保宠物在适当的时候移除,防止宠物在执行完技能后未能正常消失
DespawnSkill: DespawnSkill_MM
# 宠物开始返回到主人身边的最小距离阈值
# 若宠物的距离与主人小于该属性的值，则将保持在原地或继续执行其他指令而不会主动回到主人身边
Distance: 10
# 宠物召唤的最小距离
SpawnRange: 1
# 宠物离开主人的距离超过该阈值，宠物将会回到主人身边
ComingBackRange: 3
# [可选]宠物背包，可以设置其背包的容量大小（无论填入任何值，游戏中都会将其四舍五入为9的倍数）
InventorySize: 9
# (可选) 驯化时触发特定技能
Taming:
  #驯化中
  TamingProgressSkill: TamingEffectSkill
  #驯化完成时
  TamingFinishedSkill: TamingEffectSkill
# 在菜单中的图标
Icon:
  # 图标名称
  Name: Name of the icon
  # 设置改图标的材质（若使用头颅作为图标则删除该属性）
  Material: STONE
  # [可选]若你想使用自定义头颅作为图标，请使用该属性
  # 头颅材质 (base64)
  # 更多头颅材质可参阅该页面： https://minecraft-heads.com/custom-heads
  TextureBase64: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTU1Mjc3Mjc3MDlmMDhiYjVmOTFhYWM4NTBmZTZmOTQ0YzViYzM0OGEwODBiM2I1NjNkNDQ5YzcyYjgxYmY4NiJ9fX0=
  # 使用资源包中的自定义模型数据
  CustomModelData: 0
  # 设置图标的描述
  Description:
  - 这是一条描述
  - 这是另一条描述
# 信号系统相关配置，用于指挥权杖（Signals Sticks）
Signals:
  # 列出希望传输至宠物的信号（可以为空）
  # 请确保宠物的MythicMobs配置中正在监听这些信号，否则将没有任何效果
  # 如果您需要了解更多有关 MythicMobs 技能系统和如何使用信号的信息，可以查看 MythicMobs Wiki 中的相关文档
  # https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/skills/mechanics/signal
  Values:
  - ATTACK
  - JUMP
  # 自定义物品属性
  Item:
    # 指挥权杖是否能在交互菜单中直接使用
    # 若你想玩家以其他方式获取到权杖（例如：在工作台中合成&NPC兑换），则将其设置为false这样指挥权杖便不会在交互菜单中显示.
    # 了解更多信息，请参阅该页面内容: https://app.gitbook.com/s/agejyp4OPFjyLRX5Q3cX/~/changes/hJm7QZW7HaVPhmJ6Ct1F/tutorials/plugin-features/commands
    GetFromMenu: true 
    Name: 物品名称
    Material: STICK
    CustomModelData: 0
    Description:
    - 物品描述
# [可选]宠物皮肤
Skins:
  # [可选]为宠物添加多个皮肤
  Skin1: # 创建一个皮肤选项
    MythicMob: mythicMobId # 皮肤要引用的MM生物模型id
    Permission: skin.permission # 设置皮肤使用权限
    Icon: # 设置皮肤图标
      Material: STONE
      CustomModelData: 0
      DisplayName: "Skin 1"
      Lore:
      - "描述"
      TextureBase64: anybase64youwant #[可选]若要使用该属性请删除 "Material" 属性
  Skin2:
     # 使用相同的语法添加任意数量的皮肤，注意！不要忘记添加默认皮肤！

💓 实用型宠物配置

创建实用型宠物与装饰型宠物并没有太大的区别. 实用型宠物是可被击杀的生物，拥有生命值、经验、属性修饰等功能，其更加富有生命力

使用实用型宠物，还可以在其达到特定经验阶段时使其进化，而进化会自动将权限转移给进化后的宠物，并提供一些自定义选项供玩家使用.

此外，你可以在实用型宠物上使用装饰型宠物中的所有功能，包括皮肤、信号等下面是用于创建实用型宠物的附加属性和功能的解释：

# 宠物ID
Id: your_pet_id
# 宠物的生物ID
MythicMob: the_mythicmob_attached_to_the_pet
# 召唤宠物的权限
Permission: permission.to.summon.the.pet.can.be.custom
# ...
# 你可以为实用型宠物添加装饰型宠物的任何功能属性
# ...
# 等级为管理宠物属性信息并使其成为实用型宠物的途径
Levels:
  # 第一个等级
  Lvl_Beginner:
    # 等级的名称
    Name: "Beginner"
    # 达到该等级所需的经验阈值
    # 因此，第一个等级的经验阈值为0，更高级别的经验阈值逐渐增加
    # 注意：各级别的经验阈值必须不同
    ExperienceThreshold: 0
    # 该等级下宠物的最大生命值
    MaxHealth: 200
    # 每秒恢复的生命值（以红心为单位）
    Regeneration: 0.1
    # 宠物的抗性系数(宠物受到的伤害减少的程度)
    # 其中 1 表示没有伤害减免(+0% 抗性)，2 表示伤害减免 100%(+100% 抗性)
    ResistanceModifier: 1
    # 宠物的伤害系数（造成的伤害应该增加多少）
    # 该修饰符为乘法系数
    # 其中 1 表示不增加伤害(+0% 伤害)，0.5 表示减少 50% 的伤害(-50% 伤害)
    DamageModifier: 1
    # 力量修饰符为额外的变量，可用于技能中，影响技能的强度.
    Power: 1
    # 宠物的冷却时间
    Cooldowns:
      # 宠物重生的冷却时间(以秒为单位)
      Respawn: 15
      # 宠物收回后重新召唤的冷却时间（以秒为单位）
      Revoke: 0
    # [可选] 可为宠物开启背包系统，该属性为宠物的背包容量扩展
    # 注意： 槽位的数量将始终取舍至9的倍数
    InventoryExtension: 0
  # 第二个等级
  Lvl_Intermediate:
    Name: "Intermediate"
    ExperienceThreshold: 100
    MaxHealth: 300
    Regeneration: 0.2
    ResistanceModifier: 2
    DamageModifier: 2
    Power: 2
    Cooldowns:
      Respawn: 7
      Revoke: 0
    InventoryExtension: 0
    # [可选] : 宠物升级时的通知
    Announcement:
      # 如何通知？
      # 当使用消息类型为TITLE时 使用 "\n" 来切换至副标题
      Text: "Level up !"
      # 可选消息类型： TITLE, CHAT, ACTIONBAR
      Type: CHAT
      # [可选] : 播放哪个技能
      Skill: Nocsy_YokibirdBaby_Interact_Happy
  Lvl_Adult:
    Name: "Adult"
    MaxHealth: 400
    Regeneration: 0.5
    ResistanceModifier: 2
    DamageModifier: 2
    Power: 2
    ExperienceThreshold: 200
    # [可选] : 进化系统
    # 在达到该级别后，宠物将进化为与另一个文件对应的进阶宠物
    Evolution:
      # 进化后的生物ID
      PetId: Nocsy_Yokibird-Orange-Living
      # 进化完成与实际进化发生之前的延迟时间(ticks)
      # 该延迟时间内你可以在宠物进化期间执行一些特定的动画或效果
      DelayBeforeEvolution: 0
      # 进化后是否应该移除当前阶段的宠物权限
      RemoveAccess: true
    Announcement:
      Text: "Evolving !\nGet ready..."
      Type: TITLE
      Skill: Nocsy_YokibirdBaby_Interact_Happy

PreviousConfig Next插件功能

Last updated 1 year ago

✨ 装饰性宠物配置

# 宠物ID
Id: your_pet_id
# 宠物的生物ID
MythicMob: the_mythicmob_attached_to_the_pet
# 召唤宠物所需的权限
Permission: permission.to.summon.the.pet.can.be.custom
# 是否允许宠物被骑乘
# 若设置为true，请确保宠物模型具有 `mount` 骨骼
# (有关骨骼具体参阅 https://github.com/Ticxo/Model-Engine-Wiki/wiki/Mechanics/#mountmodel)
Mountable: false
# [可选]宠物骑乘操作类型，默认为 `walking`
# (具体参阅 https://github.com/Ticxo/Model-Engine-Wiki/wiki/Mechanics/#mountmodel)
MountType: walking
# 当玩家取消骑乘时是否移除该宠物
DespawnOnDismount: false
# [可选]当该宠物为坐骑时，是否在生成时自动骑乘
AutoRide: false
# (可选) 宠物骑乘权限
MountPermission: mcpets.mount_mypet
# 宠物移除时执行的技能
# | 注意 : 这将会阻止 AdvancedPet 自动删除宠物
# | 因此，请确保在宠物 "DespawnSkill" 技能结束时执行 "remove @self" 机制
# | 以确保宠物在适当的时候移除,防止宠物在执行完技能后未能正常消失
DespawnSkill: DespawnSkill_MM
# 宠物开始返回到主人身边的最小距离阈值
# 若宠物的距离与主人小于该属性的值，则将保持在原地或继续执行其他指令而不会主动回到主人身边
Distance: 10
# 宠物召唤的最小距离
SpawnRange: 1
# 宠物离开主人的距离超过该阈值，宠物将会回到主人身边
ComingBackRange: 3
# [可选]宠物背包，可以设置其背包的容量大小（无论填入任何值，游戏中都会将其四舍五入为9的倍数）
InventorySize: 9
# (可选) 驯化时触发特定技能
Taming:
  #驯化中
  TamingProgressSkill: TamingEffectSkill
  #驯化完成时
  TamingFinishedSkill: TamingEffectSkill
# 在菜单中的图标
Icon:
  # 图标名称
  Name: Name of the icon
  # 设置改图标的材质（若使用头颅作为图标则删除该属性）
  Material: STONE
  # [可选]若你想使用自定义头颅作为图标，请使用该属性
  # 头颅材质 (base64)
  # 更多头颅材质可参阅该页面： https://minecraft-heads.com/custom-heads
  TextureBase64: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTU1Mjc3Mjc3MDlmMDhiYjVmOTFhYWM4NTBmZTZmOTQ0YzViYzM0OGEwODBiM2I1NjNkNDQ5YzcyYjgxYmY4NiJ9fX0=
  # 使用资源包中的自定义模型数据
  CustomModelData: 0
  # 设置图标的描述
  Description:
  - 这是一条描述
  - 这是另一条描述
# 信号系统相关配置，用于指挥权杖（Signals Sticks）
Signals:
  # 列出希望传输至宠物的信号（可以为空）
  # 请确保宠物的MythicMobs配置中正在监听这些信号，否则将没有任何效果
  # 如果您需要了解更多有关 MythicMobs 技能系统和如何使用信号的信息，可以查看 MythicMobs Wiki 中的相关文档
  # https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/skills/mechanics/signal
  Values:
  - ATTACK
  - JUMP
  # 自定义物品属性
  Item:
    # 指挥权杖是否能在交互菜单中直接使用
    # 若你想玩家以其他方式获取到权杖（例如：在工作台中合成&NPC兑换），则将其设置为false这样指挥权杖便不会在交互菜单中显示.
    # 了解更多信息，请参阅该页面内容: https://app.gitbook.com/s/agejyp4OPFjyLRX5Q3cX/~/changes/hJm7QZW7HaVPhmJ6Ct1F/tutorials/plugin-features/commands
    GetFromMenu: true 
    Name: 物品名称
    Material: STICK
    CustomModelData: 0
    Description:
    - 物品描述
# [可选]宠物皮肤
Skins:
  # [可选]为宠物添加多个皮肤
  Skin1: # 创建一个皮肤选项
    MythicMob: mythicMobId # 皮肤要引用的MM生物模型id
    Permission: skin.permission # 设置皮肤使用权限
    Icon: # 设置皮肤图标
      Material: STONE
      CustomModelData: 0
      DisplayName: "Skin 1"
      Lore:
      - "描述"
      TextureBase64: anybase64youwant #[可选]若要使用该属性请删除 "Material" 属性
  Skin2:
     # 使用相同的语法添加任意数量的皮肤，注意！不要忘记添加默认皮肤！

💓 实用型宠物配置

创建实用型宠物与装饰型宠物并没有太大的区别. 实用型宠物是可被击杀的生物，拥有生命值、经验、属性修饰等功能，其更加富有生命力

使用实用型宠物，还可以在其达到特定经验阶段时使其进化，而进化会自动将权限转移给进化后的宠物，并提供一些自定义选项供玩家使用.

此外，你可以在实用型宠物上使用装饰型宠物中的所有功能，包括皮肤、信号等下面是用于创建实用型宠物的附加属性和功能的解释：

# 宠物ID
Id: your_pet_id
# 宠物的生物ID
MythicMob: the_mythicmob_attached_to_the_pet
# 召唤宠物的权限
Permission: permission.to.summon.the.pet.can.be.custom
# ...
# 你可以为实用型宠物添加装饰型宠物的任何功能属性
# ...
# 等级为管理宠物属性信息并使其成为实用型宠物的途径
Levels:
  # 第一个等级
  Lvl_Beginner:
    # 等级的名称
    Name: "Beginner"
    # 达到该等级所需的经验阈值
    # 因此，第一个等级的经验阈值为0，更高级别的经验阈值逐渐增加
    # 注意：各级别的经验阈值必须不同
    ExperienceThreshold: 0
    # 该等级下宠物的最大生命值
    MaxHealth: 200
    # 每秒恢复的生命值（以红心为单位）
    Regeneration: 0.1
    # 宠物的抗性系数(宠物受到的伤害减少的程度)
    # 其中 1 表示没有伤害减免(+0% 抗性)，2 表示伤害减免 100%(+100% 抗性)
    ResistanceModifier: 1
    # 宠物的伤害系数（造成的伤害应该增加多少）
    # 该修饰符为乘法系数
    # 其中 1 表示不增加伤害(+0% 伤害)，0.5 表示减少 50% 的伤害(-50% 伤害)
    DamageModifier: 1
    # 力量修饰符为额外的变量，可用于技能中，影响技能的强度.
    Power: 1
    # 宠物的冷却时间
    Cooldowns:
      # 宠物重生的冷却时间(以秒为单位)
      Respawn: 15
      # 宠物收回后重新召唤的冷却时间（以秒为单位）
      Revoke: 0
    # [可选] 可为宠物开启背包系统，该属性为宠物的背包容量扩展
    # 注意： 槽位的数量将始终取舍至9的倍数
    InventoryExtension: 0
  # 第二个等级
  Lvl_Intermediate:
    Name: "Intermediate"
    ExperienceThreshold: 100
    MaxHealth: 300
    Regeneration: 0.2
    ResistanceModifier: 2
    DamageModifier: 2
    Power: 2
    Cooldowns:
      Respawn: 7
      Revoke: 0
    InventoryExtension: 0
    # [可选] : 宠物升级时的通知
    Announcement:
      # 如何通知？
      # 当使用消息类型为TITLE时 使用 "\n" 来切换至副标题
      Text: "Level up !"
      # 可选消息类型： TITLE, CHAT, ACTIONBAR
      Type: CHAT
      # [可选] : 播放哪个技能
      Skill: Nocsy_YokibirdBaby_Interact_Happy
  Lvl_Adult:
    Name: "Adult"
    MaxHealth: 400
    Regeneration: 0.5
    ResistanceModifier: 2
    DamageModifier: 2
    Power: 2
    ExperienceThreshold: 200
    # [可选] : 进化系统
    # 在达到该级别后，宠物将进化为与另一个文件对应的进阶宠物
    Evolution:
      # 进化后的生物ID
      PetId: Nocsy_Yokibird-Orange-Living
      # 进化完成与实际进化发生之前的延迟时间(ticks)
      # 该延迟时间内你可以在宠物进化期间执行一些特定的动画或效果
      DelayBeforeEvolution: 0
      # 进化后是否应该移除当前阶段的宠物权限
      RemoveAccess: true
    Announcement:
      Text: "Evolving !\nGet ready..."
      Type: TITLE
      Skill: Nocsy_YokibirdBaby_Interact_Happy