自定义物品配置教程

CompanionsPlus 支持

• CraftEngine
• ItemsAdder
• ModelEngine

配置格式

插件	配置格式	示例
CraftEngine	[CE]命名空间:物品ID	[CE]myitems:ruby_sword
ItemsAdder	[IA]命名空间:物品ID	[IA]myitems:ruby_sword

两种插件的配置方式相同，只需要更换物品前缀。

精灵外观

在 companions/companions.yml 的 customModelData 中填写：

# CraftEngine
customModelData: "[CE]myitems:ruby_pet"

或：

# ItemsAdder
customModelData: "[IA]myitems:ruby_pet"

ModelEngine写法:

点击下载免费模型

# ModelEngine 模型名
modelEngine: "example_model"

将 example_model 替换为实际模型名；NONE 表示不使用 ModelEngine。需要安装 ModelEngine R4，服务器需为 1.19.4+。

3.0.0 也支持直接使用原版虚拟生物外观（服务器 1.20.5–1.21.11、26.1）：

# 放在精灵节点下，与 playerSkull、modelEngine 三选一
mob: "parrot"
mobScale: 0.5

mobScale 默认为 0.5，不支持末影龙。虚拟生物及 ModelEngine 外观不显示盔甲架武器、胸甲和姿势。捕捉得到的精灵使用捕获生物类型外观，缩放规则见生物捕捉。

精灵装备

在 equipment/equipment.yml 的 material 中填写：

equipment:
  rubySword:
    name: "&c红宝石长剑"
    material: "[IA]myitems:ruby_sword"
    custom-model-data: 0
    tooltipStyle: ""
    itemModel: ""
    lore: [ ]
    attribute: [ ]

使用 CraftEngine 时，只需将 material 改为：

material: "[CE]myitems:ruby_sword"

注意事项

• [CE] 和 [IA] 必须大写并保留。
• 将示例物品 ID 替换为对应插件中真实存在的物品 ID。
• 服务器需要安装所使用的自定义物品插件。