动作参数

每个动作都支持一组共享参数。这些参数允许你为动作设置权限门槛、添加延迟，以及控制动作的应用对象。你可以在同一个动作中任意组合使用它们

参数

`permission`

如果设置此项，则仅当玩家拥有此权限节点时动作才会触发。没有该权限的玩家会被静默忽略

actionbar:
  text: "<green>你好！"
  permission: "my_pack.greet"

`delay`

在执行动作前等待指定的刻数。20 刻 = 1 秒。默认为 0（立即执行）

message:
  text: "<gold>加载中..."
  delay: 40 # 触发后 2 秒

`target`

控制动作应用于谁。默认为 self

值	描述
`self`	触发事件的玩家 (默认)
`other`	玩家正在交互的实体（例如正在攻击的实体）
`all`	触发玩家和目标实体
`radius`	事件目标、事件方块或触发玩家周围指定 X/Y/Z 半径内的所有实体 - 需要 `target_radius`
`in_sight`	玩家当前注视的实体 - 需要 `target_in_sight_distance`

message:
  text: "<red>你打中了某人！"
  target: other

`target_radius`

仅当 target: radius 时使用。定义围绕事件目标、事件方块或触发玩家的 X/Y/Z 半径（以方块计）

actionbar:
  text: "<yellow>范围效果！"
  target: radius
  target_radius: 10

`target_in_sight_distance`

仅当 target: in_sight 时使用。搜索实体时从玩家眼睛位置进行射线检测的最大距离（以方块计）。如果在该范围内未找到任何实体，则完全跳过该动作

ignite:
  duration: 100
  target: in_sight
  target_in_sight_distance: 10

触发器放置位置

动作声明在 ItemsAdder 物品、方块、家具或复杂家具的 events 节中。

info:
  namespace: my_pack

items:
  ruby_staff:
    events:
      interact:
        right:
          message:
            text: "<green>Right-clicked"

  ruby_lamp:
    events:
      placed_furniture:
        interact:
          message:
            text: "<yellow>Furniture clicked"

placed_block 动作可以嵌套在 events.placed_block 下。家具和复杂家具动作从 events.placed_furniture 加载。

支持的触发器名称

常见物品触发器包括：

interact, interact_mainhand, interact_offhand, block_break, attack, kill,
drop, pickup, held, held_offhand, unheld, unheld_offhand, item_break,
eat, drink, bow_shot, gun_shot, gun_no_ammo, gun_reload, item_throw,
item_hit_ground, item_hit_entity, book_write, book_read, fishing_start,
fishing_caught, fishing_failed, fishing_cancel, fishing_bite,
fishing_in_ground, bucket_empty, bucket_fill

方块触发器包括 interact、break 和嵌套的 placed_block 触发器。家具触发器在 placed_furniture 下使用相同的物品风格触发器名称。复杂家具目前支持 placed_furniture.interact。

interact、interact_mainhand 和 interact_offhand 可以使用 right、left、right_shift、left_shift 等参数节。触发器下的 wildcard 动作也会在精确参数匹配之后执行。

冷却和属性要求

当动作由手持的 ItemsAdder 物品触发时，ItemsAdderAdditions 会在执行动作前检查 ItemsAdder 为该物品配置的冷却和属性要求。如果玩家不满足这些要求，该动作会被跳过。

完整示例

my_item:
  events:
    interact:
      right:
        actionbar:
          text: "<aqua>已右键点击！"
          permission: "some.permission" # 只有拥有此权限的玩家才能触发
          delay: 10 # 半秒延迟
          target: self # 仅应用于点击者自身

On this page