> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/enchantedmobs-zhong-wen-wen-dang/features/dong-zuo-lie-biao.md).
# 动作列表
### 通用选项
无论哪一个动作，它们都支持以下选项：
* type：这个选项是必须的，其他都是可选值。代表您要使用哪一种动作。
* target：动作作用于谁。支持：
* SOURCE（触发实体）
* SKILL（传递实体）
* TARGET（目标实体）
* random：该动作执行的几率，`1.0` 代表百分之百。
* cooldown：该动作每次执行的冷却时间，以秒为单位。
* 您或许会发现，能力也提供了 `random` 和 `cooldown` 两个选项，如果能力的这两个选项都已满足，就会开始执行包含的动作。动作中的 `random` 和 `cooldown` 两个选项和能力互相独立，能力的 `cooldown` 不会因为动作正在处于 `cooldown` 而重置。
* 动作不提供 `times` 限制功能。
* location：对触发事件的位置进行偏移。
* offset-x：偏移的 X 坐标。
* offset-y：偏移的 Y 坐标。
* offset-z：偏移的 Z 坐标。
一个示例如下：
```yaml
on-target-tick:
abilities:
1:
type: arrow_rain
location:
offset-y: 5
target: TARGET
random: 0.5
cooldown: 5
```
***
### 1) Mark
标记实体“已经使用过能力”，用于系统内部逻辑判断（例如防重复链路）。
```yaml
type: mark
```
默认 `target: SKILL`。
***
### 2) Delay
延迟一段时间后，再执行 `abilities` 子能力。
```yaml
type: delay
ticks: 20
abilities:
1:
type: Sound
sound: ENTITY_ENDERMAN_SCREAM
```
#### 字段说明
**ticks**
作用：延迟 tick 数（20 tick = 1 秒）。
```yaml
ticks: 40
```
**delay**
作用：`ticks` 的旧别名；仅在 `ticks` 未设置时使用。
```yaml
delay: 40
```
**abilities**
作用：延迟后要执行的子能力列表。
```yaml
abilities:
1:
type: particle
particle: FLAME
```
***
### 3) PlaceBlock
在执行位置放置临时方块，时间到后恢复。
临时方块不会生成掉落物，Spigot 服务端上对于一些特殊手段破坏的方块可能无法检测到，Paper 服务端上无此问题。
建议不要放置价值过高的方块，当服务器崩溃而又没有保存插件储存的临时方块信息时，临时方块在下一次服务器启动后就会被视为真实存在的方块，可以掉落物品。
```yaml
type: place_block
block: COBWEB
duration: 60
```
#### 字段说明
**block**
作用：要放置的方块材质。
```yaml
block: POWDER_SNOW
```
**duration**
作用：方块持续时间（tick）。
```yaml
duration: 80
```
***
### 4) Explosion
在位置制造爆炸，可控制是否起火、是否破坏方块。
```yaml
type: explosion
yield: 2.0
set-fire: false
break-blocks: false
```
默认 `target: TARGET`。
#### 字段说明
**yield**
作用：爆炸威力（越大范围越大）。
```yaml
yield: 4.0
```
**set-fire**
作用：爆炸后是否点燃周围。
```yaml
set-fire: true
```
**break-blocks**
作用：爆炸是否破坏方块。
```yaml
break-blocks: true
```
***
### 5) Remove
移除目标实体（玩家不会被移除）。
```yaml
type: remove
```
默认 `target: SKILL`。
***
### 6) CancelEvent
取消当前触发事件。
`on-death` 事件不能取消，若需取消，请使用 `on-death` 的 `revive-health` 事件修改功能实现类似功能。
```yaml
type: cancel_event
```
常用于“免疫某次伤害/行为”。
***
### 7) Lightning
在目标附近随机位置落雷，并可附加伤害。
```yaml
type: lightning
count: 2
radius: 3
damage: 4
```
默认 `target: TARGET`。
#### 字段说明
**count**
作用：落雷次数。
```yaml
count: 5
```
**radius**
作用：相对目标的随机半径。
```yaml
radius: 6
```
**damage**
作用：对命中生物追加伤害。
```yaml
damage: 8
```
***
### 8) Particle
在位置播放粒子。
```yaml
type: particle
particle: FLAME
count: 8
offset-x: 0.3
offset-y: 0.2
offset-z: 0.3
extra: 0
```
默认 `target: TARGET`。
#### 基础字段
**particle**
作用：粒子类型。
```yaml
particle: SMOKE
```
**count**
作用：每次播放粒子数量。
```yaml
count: 30
```
**offset-x / offset-y / offset-z**
作用：粒子散布范围。
```yaml
offset-x: 0.5
offset-y: 1.0
offset-z: 0.5
```
**extra**
作用：附加参数（不同粒子含义不同，如速度）。
```yaml
extra: 0.01
```
#### 特殊字段（按粒子类型生效）
**block**
作用：方块粒子的数据方块。
```yaml
particle: BLOCK
block: STONE
```
**item**
作用：物品粒子的数据物品。
```yaml
particle: ITEM
item: DIAMOND
```
**color / size**
作用：颜色粒子参数（如 `DUST`）。
```yaml
particle: DUST
color: "255,0,0"
size: 1
```
**from / to**
作用：渐变色粒子参数（如 `DUST_COLOR_TRANSITION`）。
```yaml
from: "255,0,0"
to: "0,0,255"
```
**value / delay / duration**
作用：震动粒子参数（如 vibration 目的地/时长相关）。
```yaml
value: 1.0
delay: 20
duration: 40
```
***
### 9) Sound
在位置播放音效。
```yaml
type: sound
sound: ENTITY_PLAYER_LEVELUP
volume: 1
pitch: 1
```
#### 字段说明
**sound**
作用：Bukkit 声音枚举名。
```yaml
sound: ENTITY_ENDERMAN_TELEPORT
```
**volume**
作用：音量。
```yaml
volume: 2
```
**pitch**
作用：音调。
```yaml
pitch: 0.8
```
***
### 10) SetAttribute
设置实体属性基础值。
```yaml
type: set_attribute
attribute: MAX_HEALTH
value: 40
```
默认 `target: SOURCE`。
#### 字段说明
**attribute**
作用：要修改的属性名。
```yaml
attribute: MOVEMENT_SPEED
```
**value**
作用：属性新数值。支持使用 `{max}` 代表实体此属性最大值，和 `{now}` 代表实体当前此属性值。
```yaml
value: 0.4
```
***
### 11) SetHealth
设置（或回复）目标生命值，结果不会超过最大生命。支持使用 `{max-health}` 代表实体血量最大值，和 `{health}` 代表实体当前血量值。
```yaml
type: set_health
amount: 10
```
默认 `target: SOURCE`。
#### 字段说明
**amount**
作用：设置后的生命值（支持公式变量）。
```yaml
amount: 20
```
***
### 12) PullTarget
将目标拉向来源实体。
```yaml
type: pull_target
strength: 1.0
```
默认 `target: TARGET`。
#### 字段说明
**strength**
作用：拉拽力度，越大越快。
```yaml
strength: 1.8
```
***
### 13) PotionCloud
生成药水效果云。
```yaml
type: potion_cloud
radius: 3
duration: 120
potion: POISON
potion-duration: 100
potion-amplifier: 1
```
默认 `target: TARGET`。
#### 字段说明
**radius**
作用：云半径。
```yaml
radius: 5
```
**duration**
作用：云本体持续 tick。
```yaml
duration: 200
```
**potion**
作用：云附带的药水类型。
```yaml
potion: SLOWNESS
```
**potion-duration**
作用：玩家获得药水后的持续 tick。
```yaml
potion-duration: 60
```
**potion-amplifier**
作用：药水等级（0=I，1=II）。
```yaml
potion-amplifier: 2
```
***
### 14) PotionEffect
直接给实体施加药水效果。
```yaml
type: potion_effect
potion: SLOWNESS
duration: 100
amplifier: 0
ambient: false
particles: true
icon: true
```
默认 `target: TARGET`。
#### 字段说明
**potion**
作用：药水类型。
```yaml
potion: WEAKNESS
```
**duration**
作用：药水持续 tick。
```yaml
duration: 200
```
**amplifier**
作用：药水等级（0=I）。
```yaml
amplifier: 1
```
**ambient**
作用：是否作为环境效果（视觉更淡）。
```yaml
ambient: true
```
**particles**
作用：是否显示药水粒子。
```yaml
particles: false
```
**icon**
作用：是否显示状态栏图标。
```yaml
icon: false
```
***
### 15) Freeze
设置目标冻伤时间。
```yaml
type: freeze
freeze-ticks: 60
```
默认 `target: TARGET`。
#### 字段说明
**freeze-ticks**
作用：冻结 tick 数。
```yaml
freeze-ticks: 120
```
***
### 16) Fire
设置目标燃烧时间。
```yaml
type: fire
fire-ticks: 60
```
默认 `target: TARGET`。
#### 字段说明
**fire-ticks**
作用：着火 tick 数。
```yaml
fire-ticks: 100
```
***
### 17) HomingProjectile
让传递实体（通常是投射物）追踪附近目标。
```yaml
type: homing_projectile
radius: 16
strength: 0.2
```
默认 `target: SKILL`。
#### 字段说明
**radius**
作用：搜索可追踪目标半径。
```yaml
radius: 24
```
**strength**
作用：转向强度，越大越“急转”。
```yaml
strength: 0.35
```
***
### 18) TeleportNearTarget
将实体传送到目标附近的安全落点。
```yaml
type: teleport_near_target
min-radius: 3
max-radius: 8
max-tries: 12
```
默认 `target: TARGET`。
#### 字段说明
**min-radius**
作用：与目标最小距离，避免贴脸重叠。
```yaml
min-radius: 4
```
**max-radius**
作用：与目标最大距离。
```yaml
max-radius: 10
```
**max-tries**
作用：寻找安全点最大尝试次数。
```yaml
max-tries: 20
```
***
### 19) GuardianBeam
模拟守卫者激光锁定，蓄力后造成伤害。
```yaml
type: guardian_beam
range: 18
charge-ticks: 30
damage: 6
```
默认 `target: TARGET`。
#### 字段说明
**range**
作用：可锁定目标最大距离。
```yaml
range: 24
```
**charge-ticks**
作用：激光蓄力时长。
```yaml
charge-ticks: 40
```
**damage**
作用：蓄力结束后的伤害值。
```yaml
damage: 10
```
***
### 20) VanillaAnimation
播放原版实体动画（EntityEffect）。
```yaml
type: vanilla_animation
animation: HURT
```
默认 `target: SOURCE`。
#### 字段说明
**animation**
作用：动画类型名（首选字段）。
```yaml
animation: HURT
```
**entity-effect**
作用：`animation` 旧别名。
```yaml
entity-effect: HURT
```
***
### 21) ArrowRain
在目标上空区域下落箭雨。
```yaml
type: arrow_rain
count: 10
radius: 4
height: 12
spread: 0.18
damage: -1
pierce-level: 0
critical: false
```
默认 `target: TARGET`。
#### 字段说明
**count**
作用：箭数量。
```yaml
count: 20
```
**radius**
作用：箭雨覆盖半径。
```yaml
radius: 6
```
**height**
作用：箭生成高度。
```yaml
height: 16
```
**spread**
作用：箭初速度随机偏移（控制散布感）。
```yaml
spread: 0.3
```
**damage**
作用：箭伤害；`< 0` 表示不覆盖默认伤害。
```yaml
damage: 5
```
**pierce-level**
作用：箭穿透等级。
```yaml
pierce-level: 2
```
**critical**
作用：是否设为暴击箭。
```yaml
critical: true
```
***
### 22) EnhanceEquipment
强化怪物护甲（替换材质/随机附魔）。
```yaml
type: enhance_equipment
armor-material: NETHERITE
pieces:
- HELMET
- CHESTPLATE
enchant:
min-amount: 1
max-amount: 3
min-level: 1
max-level: 4
enchantments:
- PROTECTION
```
默认 `target: SOURCE`。
#### 字段说明
**armor-material**
作用：护甲材质前缀（如 NETHERITE / DIAMOND）。
```yaml
armor-material: DIAMOND
```
**pieces**
作用：指定要处理的护甲部位。
```yaml
pieces:
- HELMET
- LEGGINGS
```
**enchant.min-amount**
作用：每件装备最少附魔条数。
```yaml
enchant:
min-amount: 1
```
**enchant.max-amount**
作用：每件装备最多附魔条数。
```yaml
enchant:
max-amount: 4
```
**enchant.min-level**
作用：附魔最小等级。
```yaml
enchant:
min-level: 2
```
**enchant.max-level**
作用：附魔最大等级。
```yaml
enchant:
max-level: 5
```
**enchant.enchantments**
作用：可被随机选中的附魔列表。
```yaml
enchant:
enchantments:
- PROTECTION
- THORNS
```
***
### 23) EnhanceHeldItem
强化怪物主手/副手物品附魔。
```yaml
type: enhance_held_item
hand: MAIN_HAND
enchant:
min-amount: 1
max-amount: 3
min-level: 1
max-level: 4
```
默认 `target: SOURCE`。
#### 字段说明
**hand**
作用：处理哪只手。
```yaml
hand: OFF_HAND
```
**enchant.min-amount**
作用：最少附魔条数。
```yaml
enchant:
min-amount: 1
```
**enchant.max-amount**
作用：最多附魔条数。
```yaml
enchant:
max-amount: 3
```
**enchant.min-level**
作用：附魔最小等级。
```yaml
enchant:
min-level: 1
```
**enchant.max-level**
作用：附魔最大等级。
```yaml
enchant:
max-level: 4
```
***
### 24) ReplaceItem
替换指定槽位物品。
```yaml
type: replace_item
slot: MAIN_HAND
item:
material: DIAMOND_SWORD
```
默认 `target: SOURCE`。
#### 字段说明
**slot**
作用：要替换的装备槽位。
```yaml
slot: HELMET
```
**item**
作用：物品构建配置（支持项目已有 BuildItem 格式）。
```yaml
item:
material: SHIELD
```
***
### 25) Disarm
缴械玩家某个手持槽位，可选择是否掉落。
```yaml
type: disarm
slot: MAIN_HAND
drop: true
pickup-delay: 20
match-item:
material:
- diamond_sword
```
默认 `target: TARGET`。
#### 字段说明
**slot**
作用：缴械槽位（主手/副手）。
```yaml
slot: OFF_HAND
```
**drop**
作用：是否把移除物品丢在地上。
```yaml
drop: false
```
**pickup-delay**
作用：掉落物可被拾取前的延迟 tick。
```yaml
pickup-delay: 60
```
**match-item**
作用：设置哪些物品能够触发缴械。使用 Match Item Format。
```yaml
match-item:
material:
- diamond_sword
```
***
### 26) ShuffleInventory
随机打乱玩家背包某个槽位区间内的物品。
```yaml
type: shuffle_inventory
start-slot: 0
end-slot: 35
```
默认 `target: TARGET`。
#### 字段说明
**start-slot**
作用：起始槽位（含）。
```yaml
start-slot: 9
```
**end-slot**
作用：结束槽位（含）。
```yaml
end-slot: 35
```
***
### 27) LaunchProjectile
让来源实体主动发射一个投射物。
```yaml
type: launch_projectile
entity-type: ARROW
speed: 1.5
extra-y: 0
fireball-yield: 1.0
fireball-incendiary: true
```
默认 `target: SOURCE`。
#### 字段说明
**entity-type**
作用：发射实体类型（常见 `ARROW`、`FIREBALL`）。
```yaml
entity-type: FIREBALL
```
**speed**
作用：投射物初速度倍率。
```yaml
speed: 2.2
```
**extra-y**
作用：在朝向向量上附加向上偏移（抛物线更高）。
```yaml
extra-y: 0.2
```
**fireball-yield**
作用：火球爆炸强度（火球类实体生效）。
```yaml
fireball-yield: 2.5
```
**fireball-incendiary**
作用：火球爆炸是否点火。
```yaml
fireball-incendiary: false
```
***
### 28) SendMessage
向玩家发送文本消息（支持单条、多条、范围模式）。
```yaml
type: send_message
mode: target-player
messages:
- "&c你被诅咒了，{player}!"
```
默认 `target: SOURCE`。
#### 字段说明
**messages**
作用：多条消息，按顺序发送。
```yaml
messages:
- "&e第一条"
- "&c第二条"
```
**message**
作用：单条消息；仅在 `messages` 为空时使用。
```yaml
message: "&aHello {player}"
```
**mode**
作用：选择消息作用玩家。
* `target-player`：只对仇恨目标玩家
* `nearby`：对附近所有玩家
```yaml
mode: nearby
```
**radius**
作用：`mode: nearby` 时的范围半径。
```yaml
radius: 12
```
#### 可用变量
* `{player}`：当前发送对象玩家
* `{target}`：怪物仇恨目标
* `{level}`：怪物等级
***
### 29) ExecuteCommand
执行 Minecraft 指令（可多条，支持控制台或玩家身份执行）。
```yaml
type: execute_command
commands:
- give {player} diamond 1
```
默认 `target: SOURCE`。
#### 字段说明
**commands**
作用：多条命令列表，按顺序执行。
```yaml
commands:
- effect give {player} slowness 5 1
- say affected {player}
```
**command**
作用：单条命令；当 `commands` 没填时使用。
```yaml
command: give {player} golden_apple 1
```
**as-console**
作用：是否以控制台身份执行。
* `true`：控制台执行（默认）
* `false`：由目标玩家执行
```yaml
as-console: false
```
**mode**
作用：指令目标玩家选择方式。
* `target-player`：怪物当前仇恨目标
* `nearby`：附近所有玩家
```yaml
mode: nearby
```
**radius**
作用：`mode: nearby` 时搜索半径。
```yaml
radius: 16
```
#### 可用变量
* `{player}`：当前命令目标玩家
* `{target}`：怪物仇恨目标
* `{level}`：怪物等级
***
### 30) Limit
组合执行器：先应用限制参数，再执行内部 `abilities`。
```yaml
type: limit
cooldown: 5
random: 0.5
abilities:
1:
type: PotionEffect
effect: WEAKNESS
duration: 60
```
默认 `target: TARGET`。
#### 字段说明
**abilities**
作用：通过限制后要运行的子能力集合。
```yaml
abilities:
1:
type: Sound
sound: ENTITY_WITHER_AMBIENT
```
**times / random / cooldown**
作用：直接复用通用限制字段，对整个内部能力组生效。
```yaml
times: 2
random: 0.4
cooldown: 8
```
***
### 31) Mythic Skills
执行 MythicMobs 的技能。
`@target` 目标符可能无法正常使用，如果是那样的话，请替换成 `@trigger`。
```yaml
type: mythic_skill
skill: FireBlast
power: 1.0
```
#### 字段说明
**skill：**技能 ID。
```yaml
FireBlast:
Skills:
- effect:particles{particle=flame;amount=30;hS=0.4;vS=0.4;speed=0.02} @self
- sound{s=entity.blaze.shoot;v=1;p=1} @self
// 请避免使用 @target，请替换为 @trigger。
- projectile{bulletType=ARROW;onTick=FireBlast-Tick;onHit=FireBlast-Hit;v=12;i=1;hR=1;vR=1;g=0.03} @trigger
FireBlast-Tick:
Skills:
- effect:particles{particle=flame;amount=4;hS=0.05;vS=0.05;speed=0.01} @origin
FireBlast-Hit:
Skills:
- damage{a=8} @trigger
- ignite{ticks=60} @trigger
- effect:particles{particle=explosion_large;amount=1} @origin
- sound{s=entity.generic.explode;v=1;p=1} @origin
```
### 32) CreeperStats
**CreeperStats：修改苦力怕（Creeper）的爆炸属性。**用于调整目标苦力怕的爆炸半径、引爆时间，以及是否为高压苦力怕。\
如果目标不是 `Creeper`，此能力不会生效。\
默认目标类型为 **SOURCE**。
#### 字段说明
**explosion-radius：** 设置苦力怕的爆炸半径。\
值会被限制为不小于 `0`。
**fuse-ticks：** 设置苦力怕的引爆时间（ticks）。\
值会被限制为至少 `1`。
**powered：** 设置是否为高压苦力怕。
* `true` = 高压苦力怕
* `false` = 普通苦力怕
#### 示例
```yaml
type: creeper_stats
explosion-radius: 6
fuse-ticks: 20
powered: true
```
#### 说明
* `explosion-radius`、`fuse-ticks`、`powered` 都是可选字段。
* 只会修改配置中已写出的字段；未写出的字段保持原值不变。
### 33) Summon
用于在目标位置生成一个新的实体。\
召唤出的实体必须是可生成的实体类型，并且后续附加属性时要求其为 `LivingEntity`。\
默认目标类型为 **SOURCE**。
#### 字段说明
**entity / entity-type：** 要召唤的实体类型。\
可使用 Bukkit `EntityType` 名称，例如：
```yaml
type: summon
entity: ZOMBIE
```
或
```yaml
type: summon
entity-type: CREEPER
```
***
**max-health：** 设置召唤实体的最大生命值。\
当该值大于 `0` 时，会修改实体的 `MAX_HEALTH` 属性，并将当前生命同步为该上限。
***
**health：** 设置召唤实体的当前生命值。\
当该值大于 `0` 时生效，最终生命值不会超过最大生命值。
***
**attack-damage：** 设置召唤实体的攻击伤害。\
当该值大于等于 `0` 时，会尝试设置实体的 `ATTACK_DAMAGE` 属性。
***
**power-level / power.level：** 给召唤实体附加 Power 时使用的等级。\
默认使用当前能力上下文等级。
***
**powers：** 给召唤实体直接指定多个 Power。\
只会应用插件中实际存在的 Power，重复项会被去重。
```yml
powers:
- ExplosionArrow
- WebTrap
```
***
**power.list：** `powers` 的备用写法。\
效果与 `powers` 相同。
***
**power：** 给召唤实体额外追加一个单独的 Power。\
如果同时配置了 `powers` 或 `power.list`，该值会一起加入列表。
```yaml
power: ExplosionArrow
```
***
**random-power-by-level / power.random-by-level：**\
若未配置有效的 `powers` / `power.list` / `power`，则可启用按等级随机分配 Power。
* `true` = 按等级随机分配 Power
* `false` = 不随机分配
***
#### Creeper 专属字段
当召唤实体是 `Creeper` 时，还可额外设置以下字段：
**creeper.explosion-radius：** 设置召唤出的苦力怕爆炸半径。\
值会四舍五入为整数，并限制不小于 `0`。
**creeper.fuse-ticks：** 设置召唤出的苦力怕引爆时间（ticks）。\
值会限制为至少 `1`。
**creeper.powered：** 设置召唤出的苦力怕是否为高压苦力怕。
### 34) RemovePotionEffect
移除目标的药水效果。
```yaml
type: remove_potion_effect
potion: INVISIBILITY
```
默认 `target: TARGET`。
#### 字段说明
**potion**: 药水效果类型。设置为 `ALL` 代表移除所有药水。
```yaml
potion: WEAKNESS
```
**potions:** 如果你想要移除多种药水，可以使用这种格式。
```yaml
potions:
- 'WEAKNESS'
- 'INVISIBILI'
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://enchantedmobs.superiormc.cn/enchantedmobs-zhong-wen-wen-dang/features/dong-zuo-lie-biao.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.