pluginiPlugin

宠物配置

结构与配置

支持无限嵌套目录
example.yml
hello.yml
world.yml

节点

id

每个宠物的唯一标识符

pet:
  id: test // [!code highlight]

default

定义默认初始属性和设置

pet:
  default: 
    exp: 30 // [!code highlight]
    level: 66 // [!code highlight]
    attribute:
      ...
节点参数类型默认值描述
expInt100升级所需经验值
levelInt100最大等级
attribute属性相关

attribute

定义属性默认值

pet:
  default:
    attribute: 
      health: 20.22 // [!code highlight]
      speed: 2.0 // [!code highlight]
      attack: 0.3 // [!code highlight]
      hook: 
        ...
节点参数类型默认值描述
healthdouble20.0最大血量
speeddouble1.0速度
attackdouble0.0攻击伤害
hook

属性系统存储是一种灵活的数据管理方式，基于键值对的形式来存储和检索宠物的各种属性。

这种存储方式类似于一个简单的数据库，其中键（key）是属性的名称，而值（value）是该属性的具体数值或状态。

你可以将其作为存储系统，也可以作为属性系统（需要驱动）

pet:
  default:
      hook: 
        - key: 键1 // [!code highlight]
          value: 值1 // [!code highlight]
        - type: ATTRIBUTE_PLUS // [!code highlight]
          key: 键2 // [!code highlight]
          value: 值2 // [!code highlight]
节点参数类型默认值描述选项
typeSTORAGE存储系统
参数描述
STORAGE存储键值对内容
ATTRIBUTE_PLUS由AttributePlus插件驱动的属性系统
keyString键
valueString值

entityType

实体类型，默认值为 PIG

pet:
  entityType: PIG // [!code highlight]

addon

组件是宠物的附加组件，可以添加一些额外的功能，例如：全息显示，不可伤害

pet:
  addon: 
    - type: NAME // [!code highlight]
      select: ADYESHACH // [!code highlight]
      height: 2.0 // [!code highlight]
      lines: 
        - "{{pet name}}"
        - "Lv.{{pet level}}"
    - type: INVINCIBLE // [!code highlight]
      select: PLAYER // [!code highlight]

不可伤害

节点参数类型描述选项
type设为不可伤害INVINCIBLE
select指定免疫对象
参数描述
PLAYER玩家
ALL所有对象
pet:
  addon:
    - type: INVINCIBLE // [!code highlight]
      select: PLAYER // [!code highlight]

全息显示

节点参数类型描述选项
type全息显示NAME
select对象
参数描述
AdyeshachAdyeshach 全息提供商
DECENT_HOLOGRAMSDecentHolograms 全息提供商
heightDouble高度
linesString[]显示内容
pet:
  addon:
    - type: NAME // [!code highlight]
      select: ADYESHACH // [!code highlight]
      height: 2.0 // [!code highlight]
      lines: 
        - "{{pet name}}"
        - "Lv.{{pet level}}"

action

pet:
  action: 
    - id: attack // [!code highlight]
      priority: 11 // [!code highlight]
    - id: walk // [!code highlight]
      priority: 10 // [!code highlight]
    - id: lookowner
      priority: 9
节点参数类型描述选项
idString行为动作编号
priorityInt行为优先级，优先级越低越先执行

内置行为

行为动作编号描述
attack类似狼的近战攻击机制
walk跟随机制

可以通过文件配置或者API开发自定义行为动作，以编号为标识符

行为动作配置文件位于：imiPetCore/action/...

默认行为配置提供了 lookowner 示例，作用是偶尔看向主人

model

允许你为宠物选择不同的模型提供商和定义宠物的模型行为。

可以通过 MODEL_ENGINE、COMMON 等模型提供商自定义宠物的外观和动画。

pet:
  model: 
    select: MODEL_ENGINE // [!code highlight]
    id: hour // [!code highlight]
    state: 
      - ...
节点参数类型默认值描述选项
selectStringCOMMON模型提供商的名称，用于指定使用哪个模型引擎
参数描述
COMMON原版实体
MODEL_ENGINEModelEngine 插件的模型显示
ORANGE_ENGINEOrangeEngine 插件的模型显示
GERM_ENGINEGermEngine 插件的模型显示
DRAGON_COREDragonCore 插件的模型显示
idString实体类型（仅COMMON）或者模型编号
stateString模型的动画状态配置，用于控制模型的播放行为和时长

state

用于定义模型在不同情况下的动画播放效果，例如宠物攻击、跟随主人时的表现。

每个状态都可以通过 lerpin、lerpout、speed 等参数进行定制。

pet:
  model:
    state: 
      - id: attack // [!code highlight]
        lerpin: 0 // [!code highlight]
        lerpout: 1 // [!code highlight]
        speed: 1.0 // [!code highlight]
      - id: lookowner
        lerpin: 0
        lerpout: 1
        speed: 1.0
节点参数类型默认值描述备注
idString动作编号
lerpinDouble0.0插入动画的过渡时间仅 ModelEngine 需要
lerpoutDouble0.0插出动画的过渡时间仅 ModelEngine 需要
speedDouble1.0动画播放速度仅 ModelEngine 需要
forceBooleanfalse是否强制播放动画仅 ModelEngine 需要
timeInt3动画播放的时长GermEngine 和 DragonCore 需要

skill

定义宠物技能默认值

pet:
  skill: 
    number: 3 // [!code highlight]
节点参数类型默认值描述
numberInt3技能默认装载最大数量

icon

用于定义宠物在界面中的展示方式，包括物品的材质、名称、描述和自定义模型数据等。

该配置可在菜单、界面中展示宠物的具体信息。

pet:
  icon: 
    material: APPLE // [!code highlight]
    name: "&f"
    lore: 
      - "     &f名称：&8{{pet name}}"
      - ""
    modelData: 12 // [!code highlight]
节点参数类型默认值描述
materialStringZOMBIE_HEAD物品材质
nameString物品名称
loreString[]物品词条
modelDataInt0物品自定义模型数据

变量支持

图标配置支持 Kether 语句，可以通过 {{ Kether 语句 }} 形式嵌入动态变量。

例如：

  • {{pet name}} 表示宠物的名称。
  • {{pet level}} 表示宠物的等级。

使用这些动态变量，可以使图标描述更加个性化和实时更新。

目录