1.26.0 版本以前

自定义宠物配置可以在 plugins/EcoPets/pets.yml 中找到，它的一般配置如下：

pets:
  - <第一个宠物>
  - <第二个宠物>

其中，pets 为一个 List 类型的自定义宠物的键，所有自定义宠物的一般配置如下：

  - id: tarantula
    name: "&6狼蛛"
    description: "&8战斗宠物"
    level-xp-requirements:
      - 50
      - 125
      - 200
      - 300
      - 500
      - 750
      - 1000
      - 1500
      - 2000
      - 3500
      - 5000
      - 7500
      - 10000
      - 15000
      - 20000
      - 30000
      - 50000
      - 75000
      - 100000
      - 200000
      - 300000
      - 400000
      - 500000
      - 600000
      - 700000
      - 800000
      - 900000
      - 1000000
      - 1100000
      - 1200000
      - 1300000
      - 1400000
      - 1500000
      - 1600000
      - 1700000
      - 1800000
      - 1900000
      - 2000000
      - 2100000
      - 2200000
      - 2300000
      - 2400000
      - 2500000
      - 2600000
      - 2750000
      - 2900000
      - 3100000
      - 3400000
      - 3700000

    xp-gain-methods:
      - id: gain_skill_xp
        multiplier: 1
        conditions: [ ]
        filters:
          skill:
            - combat
        
    level-placeholders:
      - id: "stat_1"
        value: "%level% * 0.1"
      - id: "stat_2"
        value: "%level% * 0.3"
      - id: "skill_1"
        value: "%level% * 0.5"
      - id: "skill_2"
        value: "%level% * 0.4" 
    effects-description:
      1:
        - "&8» &f+%stat_1% &#db0000🗡 力量"
        - "&8» &f+%stat_2% &9☠ 暴击伤害"
        - "&8» &f+%stat_1% &#f7ff85☣ 暴击率"
        - "&8» &r&6蜘蛛杀手"
        - "    &8击杀蜘蛛获得额外 &a%skill_2%% &8战斗技能"
        - "    &8经验值."
    rewards-description:
      1:
        - "&8» &f+%stat_1% &#db0000🗡 力量"
        - "&8» &f+%stat_2% &9☠ 暴击伤害"
        - "&8» &f+%stat_1% &#f7ff85☣ 暴击率"
        - "&8» &r&6蜘蛛杀手"
        - "    &8击杀蜘蛛获得额外 &a%skill_2%% &8战斗技能"
        - "    &8经验值."
    level-up-messages:
      1:
        - "&8» &f+%stat_1% &#db0000🗡 力量"
        - "&8» &f+%stat_2% &9☠ 暴击伤害"
        - "&8» &f+%stat_1% &#f7ff85☣ 暴击率"
        - "&8» &r&6蜘蛛杀手"
        - "    &8击杀蜘蛛获得额外 &a%skill_2%% &8战斗技能"
        - "    &8经验值."

    level-commands: [ ]

    effects:
      - id: add_stat
        args:
          stat: strength
          amount: "%level% * 0.1"
      - id: add_stat
        args:
          stat: crit_damage
          amount: "%level% * 0.3"
      - id: add_stat
        args:
          stat: crit_chance
          amount: "%level% * 0.1"
      - id: give_skill_xp
        args:
          amount: '%level% * 0.4'
          skill: combat
        triggers:
          - kill
        filters:
          entities:
            - spider
            
    conditions: [ ]

    entity-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODMwMDk4NmVkMGEwNGVhNzk5MDRmNmFlNTNmNDllZDNhMGZmNWIxZGY2MmJiYTYyMmVjYmQzNzc3ZjE1NmRmOCJ9fX0="
    
    icon: player_head texture:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODMwMDk4NmVkMGEwNGVhNzk5MDRmNmFlNTNmNDllZDNhMGZmNWIxZGY2MmJiYTYyMmVjYmQzNzc3ZjE1NmRmOCJ9fX0=
    
    spawn-egg:
      enabled: true
      item: player_head texture:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODMwMDk4NmVkMGEwNGVhNzk5MDRmNmFlNTNmNDllZDNhMGZmNWIxZGY2MmJiYTYyMmVjYmQzNzc3ZjE1NmRmOCJ9fX0=
      name: "&6狼蛛&f 宠物蛋"
      lore:
        - "&f力量: &a+10"
        - "&f暴击率: &a+10"
        - "&f暴击伤害: &a+30"
        - "&7以上是 &e100级 &7该宠物时的属性，"
        - "&7默认的属性比其低很多!"
        - ""
        - "&l&6八条腿"
        - "&7蜘蛛护靴，狼蛛护靴，反噬护靴的法力消耗减少 &a50%&7."
        - ""
        - "&l&6蜘蛛杀手"
        - "&7击杀蜘蛛获得额外 &a40% &7战斗技能经验值."
        - ""
        - "&8放置在地上以获得该宠物!"
        - ""
        - "&6&l传说"
      craftable: false
      recipe: [ ]

我们可以看出它由以下部分组成：

• id：宠物的 id。

• name：宠物的名称。

• description：宠物的介绍。

• level-xp-requirements：宠物升级所需的宠物经验值。

• xp-gain-methods：宠物经验值的获取方式。

其中：

• xp-gain-methods.id：填写一个宠物获得经验值的触发器名称。

• xp-gain-methods.multipulier：对应触发器获得宠物经验值默认值的加倍值。

• xp-gain-methods.conditions：对应触发器的条件。

• xp-gain-methods.filters：对应触发器的过滤。

具体请参考 The Effect System 的详细介绍。

• level-placeholders：自定义变量符。

每个自定义变量符下由以下部分组成：

• level-placeholders.id：变量符 id，在该宠物配置下的其他位置可以使用 %变量符 id% 来显示该变量符。

• level-placeholders.value：变量符值，具体请看 数值语法学习。

继续：

• effects-description：宠物菜单中对该宠物的描述内容，一般填写该宠物带来的技能（增益）。此处是 %effects% 变量的内容。

• rewards-description：宠物升级时的提示。此处是 %rewards% 变量的内容。

此处多说无益，你在 config.yml 找到宠物菜单（UI）方面的设置内容时就知道这两个变量是在哪里使用了。

• level-commands：宠物升级时的指令。

• entity-texture：宠物的材质。

有两种形式，第一种是直接填写玩家头颅 base64 码，我们已经在 EcoX 物品语法学习 一节详细说明了它，在此不再赘述。另外一种是 modelengine:id 形式，这样宠物就是 ModelEngine 插件下对应id的模型了。

• icon：宠物菜单中显示的物品。

• spawn-egg：宠物蛋物品。下面的子选项可以在 护身符和盔甲 两节找到对应的内容，在此不再赘述。

• effects/conditions：The Effect System（自定义技能系统）的内容，将在后文介绍。