构筑配置

构筑配置文件默认在 builds 目录下，一个文件是一个独立构筑，可以复制文件添加多个构筑。

以下是示例配置文件 example.yml，摆出“钻石傀儡”形状，使用 ExampleItem 物品点击方块生成一个 ExampleMob 生物。

example.yml

# 是否启用该配置
enable: false

# 世界配置
worlds:
  # 配置可用世界白名单，留空则在所有世界可用
  whitelist: []
  # 配置可用世界黑名单
  blacklist: []

# 方块结构定义
block-layers:
  # 每一层使用什么方块
  layers:
    0:
      - ' a '
      - 'bbb'
      - ' b '
  defines:
    a:
      type: Vanilla
      material: CARVED_PUMPKIN
    b:
      type: Vanilla
      material: DIAMOND_BLOCK
  # 需要结构朝向哪边才能召唤生物，可用值有 NORTH, SOUTH, EAST, WEST
  # 留空则朝向任意方向均可触发召唤
  require-facing: []

# 触发点击物品
trigger-item:
  # 指定物品
  item:
    type: MythicMobs
    mythic: ExampleItem
  # 需要点击 block-layers.defines 中的哪种方块才能触发生成
  # 留空则点击其中的任意方块都可以触发
  require-blocks: []
  # 需要以什么方式点击方块才能触发生成，可用值有 LEFT, RIGHT, SHIFT_LEFT, SHIFT_RIGHT
  # 留空则以任意方式点击方块都可以触发
  require-actions: [ RIGHT ]

# 生成操作
spawn-actions:
  # 消耗物品数量
  cost-items:
    count: 1
    deny-actions:
      - message: '&e至少需要%count%个物品来召唤'
  # 需要移除什么方块，任意一项为 * 则代表移除所有方块
  remove-blocks: [ '*' ]
  # 怪物生成位置配置
  location:
    type: CENTER_BOTTOM
    offset:
      x: 0
      y: 0.5
      z: 0
  # 生成怪物类型，方便调整起见，只支持生成一个怪物
  # 如需多个怪物，请通过一个 MythicMobs 怪物的技能来生成多个怪物
  mob-type:
    type: MythicMobs
    mythic: ExampleMob
  # 条件均满足时，生成怪物前执行的命令，除了支持 PAPI 变量外，额外支持以下变量
  # %mob_x% - 已指定的怪物X坐标
  # %mob_y% - 已指定的怪物Y坐标
  # %mob_z% - 已指定的怪物Z坐标
  # %mob_x_block% - 已指定的怪物X坐标(整数)
  # %mob_y_block% - 已指定的怪物Y坐标(整数)
  # %mob_z_block% - 已指定的怪物Z坐标(整数)
  pre-actions: []
  # 条件均满足时，生成怪物后执行的命令
  # 变量支持情况同上
  post-actions:
    - message: '&b你召唤了示例怪物'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# 理解如何编写方块结构

如图所示，在配置中填写的层级将会被插件这样进行判定

插件会建立本地坐标系来储存方块对应关系，需要进行判定的时候，再

将本地 y 轴正方向与世界 y 轴正方向重合
将 layers 轴正方向改到与方位轴（东南西北）正方向重合

以此来旋转变换坐标系，对每个方位轴依此进行四次判定，寻找合适的构筑。

感觉复杂吗？实际上，只需要把 layers.0 当成竖着的方块画布就可以了，添加 layers.1 就是在 layers.0 前面再叠一层方块。

# 方块定义

目前方块定义（defines）支持使用以下格式

如需添加其它插件兼容，请参考 BlockCraftEngine.java (opens new window)。

##### 原版方块格式 #####
type: Vanilla
# 方块类型
material: CARVED_PUMPKIN
# 要求相对方向匹配，支持以下值:
# FRONT, BACK, LEFT, RIGHT
relative-facings: [ FRONT ]

1
2
3
4
5
6
7

##### CraftEngine 方块格式 #####
type: CraftEngine
# 方块的命名空间与ID
id: 'namespace:value'

1
2
3
4

##### ItemsAdder 方块格式 #####
type: ItemsAdder
# 方块的命名空间与ID
id: 'namespace:value'

1
2
3
4

# 物品定义

目前物品定义（item）支持使用以下格式

如需添加其它插件兼容，请参考 ItemCraftEngine.java (opens new window)。

##### 原版物品格式 #####
type: Vanilla
# 物品类型
material: STICK

1
2
3
4

##### MythicMobs 物品格式 #####
type: MythicMobs
# 物品类型
mythic: ExampleItem

1
2
3
4

##### CraftEngine 物品格式 #####
type: CraftEngine
# 物品的命名空间与ID
id: 'namespace:value'

1
2
3
4

##### ItemsAdder 物品格式 #####
type: ItemsAdder
# 物品的命名空间与ID
id: 'namespace:value'

1
2
3
4

# 怪物定义

目前怪物定义（mob-type）支持使用以下格式

如需添加其它插件兼容，请参考 MobMythicMobs.java (opens new window)。

##### 不生成怪物 #####
type: None

1
2

##### 原版生物格式 #####
type: Vanilla
entity-type: IRON_GOLEM

1
2
3

##### MythicMobs 怪物格式 #####
type: MythicMobs
# 生物类型
mythic: ExampleMob

1
2
3
4

上次更新: 2026/03/29, 20:46:07

← 命令与权限简介→