动作列表

通用选项

无论哪一个动作，它们都支持以下选项：

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 坐标。

一个示例如下：

on-target-tick:
  abilities:
    1:
      type: arrow_rain
      location:
        offset-y: 5
      target: TARGET
      random: 0.5
      cooldown: 5

1) Mark

标记实体“已经使用过能力”，用于系统内部逻辑判断（例如防重复链路）。

type: mark

默认 target: SKILL。

2) Delay

延迟一段时间后，再执行 abilities 子能力。

type: delay
ticks: 20
abilities:
  1:
    type: Sound
    sound: ENTITY_ENDERMAN_SCREAM

字段说明

ticks

作用：延迟 tick 数（20 tick = 1 秒）。

ticks: 40

delay

作用：ticks 的旧别名；仅在 ticks 未设置时使用。

delay: 40

abilities

作用：延迟后要执行的子能力列表。

abilities:
  1:
    type: particle
    particle: FLAME

3) PlaceBlock

在执行位置放置临时方块，时间到后恢复。

临时方块不会生成掉落物，Spigot 服务端上对于一些特殊手段破坏的方块可能无法检测到，Paper 服务端上无此问题。

建议不要放置价值过高的方块，当服务器崩溃而又没有保存插件储存的临时方块信息时，临时方块在下一次服务器启动后就会被视为真实存在的方块，可以掉落物品。

type: place_block
block: COBWEB
duration: 60

字段说明

block

作用：要放置的方块材质。

block: POWDER_SNOW

duration

作用：方块持续时间（tick）。

duration: 80

4) Explosion

在位置制造爆炸，可控制是否起火、是否破坏方块。

type: explosion
yield: 2.0
set-fire: false
break-blocks: false

默认 target: TARGET。

字段说明

yield

作用：爆炸威力（越大范围越大）。

yield: 4.0

set-fire

作用：爆炸后是否点燃周围。

set-fire: true

break-blocks

作用：爆炸是否破坏方块。

break-blocks: true

5) Remove

移除目标实体（玩家不会被移除）。

type: remove

默认 target: SKILL。

6) CancelEvent

取消当前触发事件。

on-death 事件不能取消，若需取消，请使用 on-death 的 revive-health 事件修改功能实现类似功能。

type: cancel_event

常用于“免疫某次伤害/行为”。

7) Lightning

在目标附近随机位置落雷，并可附加伤害。

type: lightning
count: 2
radius: 3
damage: 4

默认 target: TARGET。

字段说明

count

作用：落雷次数。

count: 5

radius

作用：相对目标的随机半径。

radius: 6

damage

作用：对命中生物追加伤害。

damage: 8

8) Particle

在位置播放粒子。

type: particle
particle: FLAME
count: 8
offset-x: 0.3
offset-y: 0.2
offset-z: 0.3
extra: 0

默认 target: TARGET。

基础字段

particle

作用：粒子类型。

particle: SMOKE

count

作用：每次播放粒子数量。

count: 30

offset-x / offset-y / offset-z

作用：粒子散布范围。

offset-x: 0.5
offset-y: 1.0
offset-z: 0.5

extra

作用：附加参数（不同粒子含义不同，如速度）。

extra: 0.01

特殊字段（按粒子类型生效）

block

作用：方块粒子的数据方块。

particle: BLOCK
block: STONE

item

作用：物品粒子的数据物品。

particle: ITEM
item: DIAMOND

color / size

作用：颜色粒子参数（如 DUST）。

particle: DUST
color: "255,0,0"
size: 1

from / to

作用：渐变色粒子参数（如 DUST_COLOR_TRANSITION）。

from: "255,0,0"
to: "0,0,255"

value / delay / duration

作用：震动粒子参数（如 vibration 目的地/时长相关）。

value: 1.0
delay: 20
duration: 40

9) Sound

在位置播放音效。

type: sound
sound: ENTITY_PLAYER_LEVELUP
volume: 1
pitch: 1

字段说明

sound

作用：Bukkit 声音枚举名。

sound: ENTITY_ENDERMAN_TELEPORT

volume

作用：音量。

volume: 2

pitch

作用：音调。

pitch: 0.8

10) SetAttribute

设置实体属性基础值。

type: set_attribute
attribute: MAX_HEALTH
value: 40

默认 target: SOURCE。

字段说明

attribute

作用：要修改的属性名。

attribute: MOVEMENT_SPEED

value

作用：属性新数值。支持使用 {max} 代表实体此属性最大值，和 {now} 代表实体当前此属性值。

value: 0.4

11) SetHealth

设置（或回复）目标生命值，结果不会超过最大生命。支持使用 {max-health} 代表实体血量最大值，和 {health} 代表实体当前血量值。

type: set_health
amount: 10

默认 target: SOURCE。

字段说明

amount

作用：设置后的生命值（支持公式变量）。

amount: 20

12) PullTarget

将目标拉向来源实体。

type: pull_target
strength: 1.0

默认 target: TARGET。

字段说明

strength

作用：拉拽力度，越大越快。

strength: 1.8

13) PotionCloud

生成药水效果云。

type: potion_cloud
radius: 3
duration: 120
potion: POISON
potion-duration: 100
potion-amplifier: 1

默认 target: TARGET。

字段说明

radius

作用：云半径。

radius: 5

duration

作用：云本体持续 tick。

duration: 200

potion

作用：云附带的药水类型。

potion: SLOWNESS

potion-duration

作用：玩家获得药水后的持续 tick。

potion-duration: 60

potion-amplifier

作用：药水等级（0=I，1=II）。

potion-amplifier: 2

14) PotionEffect

直接给实体施加药水效果。

type: potion_effect
potion: SLOWNESS
duration: 100
amplifier: 0
ambient: false
particles: true
icon: true

默认 target: TARGET。

字段说明

potion

作用：药水类型。

potion: WEAKNESS

duration

作用：药水持续 tick。

duration: 200

amplifier

作用：药水等级（0=I）。

amplifier: 1

ambient

作用：是否作为环境效果（视觉更淡）。

ambient: true

particles

作用：是否显示药水粒子。

particles: false

icon

作用：是否显示状态栏图标。

icon: false

15) Freeze

设置目标冻伤时间。

type: freeze
freeze-ticks: 60

默认 target: TARGET。

字段说明

freeze-ticks

作用：冻结 tick 数。

freeze-ticks: 120

16) Fire

设置目标燃烧时间。

type: fire
fire-ticks: 60

默认 target: TARGET。

字段说明

fire-ticks

作用：着火 tick 数。

fire-ticks: 100

17) HomingProjectile

让传递实体（通常是投射物）追踪附近目标。

type: homing_projectile
radius: 16
strength: 0.2

默认 target: SKILL。

字段说明

radius

作用：搜索可追踪目标半径。

radius: 24

strength

作用：转向强度，越大越“急转”。

strength: 0.35

18) TeleportNearTarget

将实体传送到目标附近的安全落点。

type: teleport_near_target
min-radius: 3
max-radius: 8
max-tries: 12

默认 target: TARGET。

字段说明

min-radius

作用：与目标最小距离，避免贴脸重叠。

min-radius: 4

max-radius

作用：与目标最大距离。

max-radius: 10

max-tries

作用：寻找安全点最大尝试次数。

max-tries: 20

19) GuardianBeam

模拟守卫者激光锁定，蓄力后造成伤害。

type: guardian_beam
range: 18
charge-ticks: 30
damage: 6

默认 target: TARGET。

字段说明

range

作用：可锁定目标最大距离。

range: 24

charge-ticks

作用：激光蓄力时长。

charge-ticks: 40

damage

作用：蓄力结束后的伤害值。

damage: 10

20) VanillaAnimation

播放原版实体动画（EntityEffect）。

type: vanilla_animation
animation: HURT

默认 target: SOURCE。

字段说明

animation

作用：动画类型名（首选字段）。

animation: HURT

entity-effect

作用：animation 旧别名。

entity-effect: HURT

21) ArrowRain

在目标上空区域下落箭雨。

type: arrow_rain
count: 10
radius: 4
height: 12
spread: 0.18
damage: -1
pierce-level: 0
critical: false

默认 target: TARGET。

字段说明

count

作用：箭数量。

count: 20

radius

作用：箭雨覆盖半径。

radius: 6

height

作用：箭生成高度。

height: 16

spread

作用：箭初速度随机偏移（控制散布感）。

spread: 0.3

damage

作用：箭伤害；< 0 表示不覆盖默认伤害。

damage: 5

pierce-level

作用：箭穿透等级。

pierce-level: 2

critical

作用：是否设为暴击箭。

critical: true

22) EnhanceEquipment

强化怪物护甲（替换材质/随机附魔）。

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）。

armor-material: DIAMOND

pieces

作用：指定要处理的护甲部位。

pieces:
  - HELMET
  - LEGGINGS

enchant.min-amount

作用：每件装备最少附魔条数。

enchant:
  min-amount: 1

enchant.max-amount

作用：每件装备最多附魔条数。

enchant:
  max-amount: 4

enchant.min-level

作用：附魔最小等级。

enchant:
  min-level: 2

enchant.max-level

作用：附魔最大等级。

enchant:
  max-level: 5

enchant.enchantments

作用：可被随机选中的附魔列表。

enchant:
  enchantments:
    - PROTECTION
    - THORNS

23) EnhanceHeldItem

强化怪物主手/副手物品附魔。

type: enhance_held_item
hand: MAIN_HAND
enchant:
  min-amount: 1
  max-amount: 3
  min-level: 1
  max-level: 4

默认 target: SOURCE。

字段说明

hand

作用：处理哪只手。

hand: OFF_HAND

enchant.min-amount

作用：最少附魔条数。

enchant:
  min-amount: 1

enchant.max-amount

作用：最多附魔条数。

enchant:
  max-amount: 3

enchant.min-level

作用：附魔最小等级。

enchant:
  min-level: 1

enchant.max-level

作用：附魔最大等级。

enchant:
  max-level: 4

24) ReplaceItem

替换指定槽位物品。

type: replace_item
slot: MAIN_HAND
item:
  material: DIAMOND_SWORD

默认 target: SOURCE。

字段说明

slot

作用：要替换的装备槽位。

slot: HELMET

item

作用：物品构建配置（支持项目已有 BuildItem 格式）。

item:
  material: SHIELD

25) Disarm

缴械玩家某个手持槽位，可选择是否掉落。

type: disarm
slot: MAIN_HAND
drop: true
pickup-delay: 20
match-item:
  material:
    - diamond_sword

默认 target: TARGET。

字段说明

slot

作用：缴械槽位（主手/副手）。

slot: OFF_HAND

drop

作用：是否把移除物品丢在地上。

drop: false

pickup-delay

作用：掉落物可被拾取前的延迟 tick。

pickup-delay: 60

match-item

作用：设置哪些物品能够触发缴械。使用 Match Item Format。

match-item:
  material:
    - diamond_sword

26) ShuffleInventory

随机打乱玩家背包某个槽位区间内的物品。

type: shuffle_inventory
start-slot: 0
end-slot: 35

默认 target: TARGET。

字段说明

start-slot

作用：起始槽位（含）。

start-slot: 9

end-slot

作用：结束槽位（含）。

end-slot: 35

27) LaunchProjectile

让来源实体主动发射一个投射物。

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）。

entity-type: FIREBALL

speed

作用：投射物初速度倍率。

speed: 2.2

extra-y

作用：在朝向向量上附加向上偏移（抛物线更高）。

extra-y: 0.2

fireball-yield

作用：火球爆炸强度（火球类实体生效）。

fireball-yield: 2.5

fireball-incendiary

作用：火球爆炸是否点火。

fireball-incendiary: false

28) SendMessage

向玩家发送文本消息（支持单条、多条、范围模式）。

type: send_message
mode: target-player
messages:
  - "&c你被诅咒了，{player}!"

默认 target: SOURCE。

字段说明

messages

作用：多条消息，按顺序发送。

messages:
  - "&e第一条"
  - "&c第二条"

message

作用：单条消息；仅在 messages 为空时使用。

message: "&aHello {player}"

mode

作用：选择消息作用玩家。

target-player：只对仇恨目标玩家
nearby：对附近所有玩家

mode: nearby

radius

作用：mode: nearby 时的范围半径。

radius: 12

可用变量

{player}：当前发送对象玩家
{target}：怪物仇恨目标
{level}：怪物等级

29) ExecuteCommand

执行 Minecraft 指令（可多条，支持控制台或玩家身份执行）。

type: execute_command
commands:
  - give {player} diamond 1

默认 target: SOURCE。

字段说明

commands

作用：多条命令列表，按顺序执行。

commands:
  - effect give {player} slowness 5 1
  - say affected {player}

command

作用：单条命令；当 commands 没填时使用。

command: give {player} golden_apple 1

as-console

作用：是否以控制台身份执行。

true：控制台执行（默认）
false：由目标玩家执行

as-console: false

mode

作用：指令目标玩家选择方式。

target-player：怪物当前仇恨目标
nearby：附近所有玩家

mode: nearby

radius

作用：mode: nearby 时搜索半径。

radius: 16

可用变量

{player}：当前命令目标玩家
{target}：怪物仇恨目标
{level}：怪物等级

30) Limit

组合执行器：先应用限制参数，再执行内部 abilities。

type: limit
cooldown: 5
random: 0.5
abilities:
  1:
    type: PotionEffect
    effect: WEAKNESS
    duration: 60

默认 target: TARGET。

字段说明

abilities

作用：通过限制后要运行的子能力集合。

abilities:
  1:
    type: Sound
    sound: ENTITY_WITHER_AMBIENT

times / random / cooldown

作用：直接复用通用限制字段，对整个内部能力组生效。

times: 2
random: 0.4
cooldown: 8

31) Mythic Skills

执行 MythicMobs 的技能。

@target 目标符可能无法正常使用，如果是那样的话，请替换成 @trigger。

type: mythic_skill
skill: FireBlast
power: 1.0

字段说明

skill：技能 ID。

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 = 普通苦力怕

示例

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 名称，例如：

type: summon
entity: ZOMBIE

或

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，重复项会被去重。

powers:
  - ExplosionArrow
  - WebTrap

power.list： powers 的备用写法。效果与 powers 相同。

power： 给召唤实体额外追加一个单独的 Power。如果同时配置了 powers 或 power.list，该值会一起加入列表。

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

移除目标的药水效果。

type: remove_potion_effect
potion: INVISIBILITY

默认 target: TARGET。

字段说明

potion: 药水效果类型。设置为 ALL 代表移除所有药水。

potion: WEAKNESS

potions: 如果你想要移除多种药水，可以使用这种格式。

potions: 
  - 'WEAKNESS'
  - 'INVISIBILI'

上一页伤害来源下一页匹配物品格式（Match Item Format）

最后更新于 5个月前