创建精灵

配置说明

本插件里只内置下面这个精灵，其他的需要你自定义

现在开始有趣的部分！创建您自己的自定义精灵！
创建自定义精灵非常简单。如果您理解了本指南，一个精灵只需要大约5分钟就可以完成。

共享平台

这是专门为本插件制作的精灵配置共享平台,欢迎大家使用和贡献更多精灵

点击查看

配置预览

首先，您需要使用您喜欢的编辑器应用程序打开插件目录中的 companions/companions.yml 文件 (也可以在 companions 文件夹内为不同精灵新建 yml 文件)！
我个人偏好使用vscode
我将使用下面例子进行解释

yaml

# 配置类型，默认使用 default
type: "default"
companions:
  # 精灵商城查看权限 格式为:  companions.buy.reaper
  # companions.buy.all 表示全部精灵的商城查看权限
  # 精灵自动给予权限 格式为: companions.have.reaper
  reaper:
    # 精灵名称(可使用内部变量,精灵等级:${level})
    name: "&8&l收割者"
    # 名称可见 true可见
    nameVisible: true
    # 外观方式三选一：头颅材质、虚拟生物、ModelEngine模型
    # 头颅材质
    playerSkull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTM5YjVkMmU2MjRjMTQ3ZWZlNDdiMTMwZTFjZGRiOGEzNzdjZGIzZTc3NDJiZDJjZjRkZGRmNjlhNjg5MjcyIn19fQ=="
    # 虚拟生物示例：mob: "parrot"
    # ModelEngine模型示例：modelEngine: "example_model"
    # 虚拟生物缩放，仅 mob 生效
    # mobScale: 0.5
    # 这使用自定义模型数据，如果未设置为 NONE 则将覆盖玩家头颅。 如果要使用它，“MATERIAL:DATA”，例如：时钟材料和nbt数据值为15的 CLOCK:15
    customModelData: "NONE"
    # 如果您不想要武器，请设置为 NONE
    weapon: "STONE_HOE"
    # 是否显示武器（用于配带精灵装备但是不想显示出来,默认true）
    showWeapon: true
    # 多个能力逐行配置，不使用能力时填写 abilityList: []
    abilityList:
      - "INCREASE_DAMAGE"
    # 配置该精灵的最大等级上限 未配置会使用config.yml中的settings.maxAbilityLevel配置
    maxAbilityLevel: 3
    # 配置该精灵的等级升级费用 未配置会使用upgrade.yml中的up.price配置
    upPrice: '${level * 10000}'
    # 属性
    attribute:
      - '&e物理攻击: ${level * 1}'
    # 随机属性，获取精灵时抽取并保存
    randomAttribute:
      - '&e物理攻击: ${10~50}'
      - '&e魔法攻击: ${5~30}'
    # 未使用精灵的属性折扣，默认1；填空字符串时读取主配置discountRate
    discountRate: 1
    # 胸甲装备 NONE 为不设置
    chestplate: "LEATHER_CHESTPLATE"
    # 皮革颜色
    leatherColor:
      red: 32
      green: 32
      blue: 32
    # 盔甲纹饰 服务器1.19.4+生效
    armorTrim:
      material: amethyst
      pattern: coast
    # 获取POSE角度，请访问此链接：https://haselkern.com/Minecraft-ArmorStand/
    rightArmPose:
      angle1: 360
      angle2: 270
      angle3: 286
    leftArmPose:
      angle1: 0
      angle2: 0
      angle3: 0
    headPose:
      angle1: 0
      angle2: 0
      angle3: 0
    bodyPose:
      angle1: 37
      angle2: 0
      angle3: 0
    placement:
      x: 0
      y: 1.5
      z: 0
      yaw: 180
    GUI:
      shop:
        type: COMPANION_SKULL
        amount: 1
        name: "&6&l收割者"
        isEnchant: false
        tooltipStyle: ""
        itemModel: ""
        price: 12000
        description:
          - " "
          - "&7控制死亡的收割者,"
          - "&7变成了你的精灵."
          - " "
          - "&6能力 -"
          - "&e➩ 伤害增加"
          - ""
          - "&6价格: &e%price%"
      open:
        type: COMPANION_SKULL
        amount: 1
        name: "&6&l收割者"
        isEnchant: false
        tooltipStyle: ""
        itemModel: ""
        description:
          - " "
          - "&7控制死亡的收割者,"
          - "&7变成了你的精灵."
          - " "
          - "&6能力 -"
          - "&e➩ 伤害增加"
          - ""
          - "&6&l点击设置"

配置说明

reaper: - 这个配置头确定了购买权限节点 companions.buy.reaper；它是精灵 key，同种精灵的多个实例共用此配置。
type: - 文件顶部的 type 用于神秘箱抽取分类，默认 default；精灵节点内的 type 可以覆盖文件类型。
name: - 精灵名称，支持颜色代码。
nameVisible: - 是否显示精灵名称。
playerSkull: - 获取精灵头的纹理值

playerSkull、mob、modelEngine 三者选择一种作为精灵外观。

mob: - 设置虚拟生物类型，支持服务器 1.20.5–1.21.11、26.1，不支持末影龙。
mobScale: - 设置虚拟生物缩放比例，默认 0.5，仅 mob 生效。捕捉精灵的缩放另见生物捕捉。
modelEngine: - 设置 ModelEngine 模型名称，需要安装 ModelEngine R4，服务器需为 1.19.4+。

您也可以使用此链接创建自己的纹理，只需找到所需的自定义头像，滚动到底部并复制其纹理ID。

player-heads

mineSkin

weapon: - 设置精灵购买时默认持有的武器。
abilityList: - 以列表形式配置药水能力/自定义能力，详情见精灵能力。旧版 ability 分号写法仍兼容，建议统一使用 abilityList，避免两者重复配置。
attribute - 精灵属性，详情见精灵属性。
randomAttribute - 随机属性池，获取精灵时按品质配置随机抽取并保存，详情见精灵属性。
discountRate - 全局属性模式下，未使用精灵的属性折扣，需在属性公式中使用 ${discountRate}。精灵未配置时默认为 1；配置 discountRate: "" 才会读取主配置值。
chestplate: - 设置精灵的胸甲。
leatherColor: - 如果精灵穿着皮质胸甲，请设置皮革胸甲的RGB颜色。
armorTrim: - 设置精灵胸甲的盔甲纹饰 (1.4.0+)。
rightArmPose: - 设置精灵的右臂姿势。
leftArmPose: - 设置精灵的左臂姿势。
headPose: - 设置精灵的头部姿势。
bodyPose: - 设置精灵的身体姿势。

您可以使用此在线盔甲架编辑器设置姿势。

ArmorStand

GUI.shop.type / GUI.open.type: - 设置 GUI 图标材质，可使用 COMPANION_SKULL 显示精灵头颅；虚拟生物精灵在未指定材质或使用此值时显示对应刷怪蛋。
amount: - 设置物品堆叠数量。
name: - 在商店GUI中设置物品显示的名称。
isEnchant: - 是否显示附魔光效，默认 false。
tooltipStyle: - 设置物品工具提示样式，1.21.2+ 生效，可不配置。
itemModel: - 设置物品模型，1.21.2+ 生效，可不配置。
price: - 设置购买价格，所用货币需安装对应的经济插件。
description：- 设置精灵的说明。

GUI.shop 是商城中的精灵图标，GUI.open 是已拥有精灵打开仓库时的图标。description 支持 ${attribute}、 ${randomAttribute}、${level}、${quality} 和 %price% 变量。商城显示随机属性范围，仓库显示该实例已抽取的结果。

武器、胸甲和盔甲架姿势用于头颅/物品外观；虚拟生物与 ModelEngine 外观不显示这些盔甲架部件。

price 价格说明

price: 1000 表示需要金币1000购买
price: 1000C表示需要精灵币1000购买
price: 1000P表示需要点券1000购买
price: "ply_money:10000" 表示需要ply插件的money货币10000

精灵权限说明

精灵商城查看权限格式为: companions.buy.reaper
companions.buy.all 表示全部精灵的商城查看权限
精灵自动给予权限 (1.2.4+) 格式为: companions.have.reaper，需在主配置开启 isHavePermission: true
reaper 表示对应的精灵key

精灵盔甲纹饰说明

盔甲纹饰材质	说明
quartz	石英
iron	铁
netherite	下界合金
redstone	红石
copper	铜
gold	黄金
emerald	翡翠
diamond	钻石
lapis	青金石
amethyst	紫水晶

盔甲纹饰图案	说明
sentry	哨兵盔甲纹饰
dune	沙丘盔甲纹饰
coast	海岸盔甲纹饰
wild	荒野盔甲纹饰
ward	监守盔甲纹饰
eye	眼眸盔甲纹饰
vex	恼鬼盔甲纹饰
tide	潮汐盔甲纹饰
snout	猪鼻盔甲纹饰
rib	肋骨盔甲纹饰
spire	尖塔盔甲纹饰
wayfinder	向导盔甲纹饰
shaper	塑形盔甲纹饰
silence	幽静盔甲纹饰
raiser	牧民盔甲纹饰
host	雇主盔甲纹饰
flow	涡流盔甲纹饰
bolt	镶铆盔甲纹饰

创建精灵 ​

配置说明 ​

共享平台 ​

配置预览 ​

配置说明 ​

创建精灵

配置说明

共享平台

配置预览

配置说明