触发器实战示例

所属：动作系统　·　相关：触发器原子大全 · 处理器

触发器原子大全 给了全部原子的清单，本页给每类触发器一个最小可用 YAML，复制就能跑。所有示例只展示 actions 段，把它并进你的物品定义即可（注意 actions 与 material 同级）。

通用提醒：动作改完 /qi reload 才生效；right_click 对空气不一定触发，泛用场景优先 left_click。

---

点击类

left_click —— 最通用

actions:
  triggers:
    left_click:
      trigger:
        atom: left_click
      cooldown: 1s
      refs:
        - handler: qi:action_bar
          payload: "<gold>挥击！</gold>"

right_click

actions:
  triggers:
    right_click:
      trigger:
        atom: right_click
      refs:
        - handler: qi:message
          payload: "右键使用"

shift_left_click（潜行 + 左键）

actions:
  triggers:
    shift_left_click:
      trigger:
        atom: shift_left_click
      cooldown: 3s
      refs:
        - handler: qi:title
          payload: "<red>蓄力斩</red>||<gray>潜行重击</gray>||3||30||10"

---

潜行 / 移动类

double_shift_toggle（双击潜行）

actions:
  triggers:
    dash:
      trigger:
        atom: double_shift_toggle
      cooldown: 3s
      refs:
        - handler: qi:command
          payload: "effect give {player} minecraft:speed 3 2"
        - handler: qi:sound
          payload: "minecraft:entity.player.attack.sweep;1;1.4"

sprint_start（开始冲刺）

actions:
  triggers:
    sprint_start:
      trigger:
        atom: sprint_start
      refs:
        - handler: qi:action_bar
          payload: "<aqua>疾跑中…</aqua>"

glide（鞘翅滑翔）

actions:
  triggers:
    glide:
      trigger:
        atom: glide
      refs:
        - handler: qi:command
          payload: "effect give {player} minecraft:slow_falling 5 0"

---

物品管理类

equip / unequip（装备 / 卸下）

actions:
  triggers:
    equip:
      trigger:
        atom: equip
      refs:
        - handler: qi:action_bar
          payload: "<gold>✦ 守护之力已激活 ✦</gold>"
        - handler: qi:sound
          payload: "minecraft:item.armor.equip_gold;1;1.2"
    unequip:
      trigger:
        atom: unequip
      refs:
        - handler: qi:action_bar
          payload: "<gray>守护之力散去…</gray>"

consume（吃 / 喝，要求可食用材质）

actions:
  triggers:
    consume:
      trigger:
        atom: consume
      cooldown: 30s
      refs:
        - handler: qi:command
          payload: "effect give {player} minecraft:strength 20 1"

drop（丢弃）

actions:
  triggers:
    drop:
      trigger:
        atom: drop
      refs:
        - handler: qi:message
          payload: "你丢弃了它"

---

方块 / 射击类

break_block（破坏方块）

actions:
  triggers:
    break_block:
      trigger:
        atom: break_block
      refs:
        - handler: qi:sound
          payload: "minecraft:block.stone.break;1;1"

bow_shoot（弓射击）

actions:
  triggers:
    bow_shoot:
      trigger:
        atom: bow_shoot
      cooldown: 2s
      refs:
        - handler: qi:action_bar
          payload: "<gold>蓄力一击！</gold>"

fish（钓鱼）

actions:
  triggers:
    fish:
      trigger:
        atom: fish
      refs:
        - handler: qi:message
          payload: "上钩了！"

---

战斗类

on_hit（受到伤害）

actions:
  triggers:
    on_hit:
      trigger:
        atom: on_hit
      cooldown: 3s
      refs:
        - handler: qi:title
          payload: "<red>反击！</red>||<dark_red>+10 防御</dark_red>||5||20||5"

on_damage（造成伤害）

actions:
  triggers:
    on_damage:
      trigger:
        atom: on_damage
      cooldown: 1s
      refs:
        - handler: combat:swing
          payload: "heavy"

on_kill（击杀实体）

actions:
  triggers:
    on_kill:
      trigger:
        atom: on_kill
      refs:
        - handler: qi:command
          payload: "effect give {player} minecraft:regeneration 3 1"
        - handler: qi:action_bar
          payload: "<green>击杀回血</green>"

critical_hit（暴击）

actions:
  triggers:
    critical_hit:
      trigger:
        atom: critical_hit
      refs:
        - handler: qi:sound
          payload: "minecraft:entity.player.attack.crit;1;1.2"

---

实体交互类

interact_entity（右键生物）

actions:
  triggers:
    interact_entity:
      trigger:
        atom: interact_entity
      refs:
        - handler: qi:message
          payload: "你与生物互动"

vehicle_enter（进入载具）

actions:
  triggers:
    vehicle_enter:
      trigger:
        atom: vehicle_enter
      refs:
        - handler: qi:action_bar
          payload: "<aqua>启程！</aqua>"

---

环境 / 服务器类

join（进服）

actions:
  triggers:
    join:
      trigger:
        atom: join
      refs:
        - handler: qi:title
          payload: "<gold>欢迎回来</gold>||<gray>{player}</gray>||10||40||10"

world_change（切换维度 / 世界）

actions:
  triggers:
    world_change:
      trigger:
        atom: world_change
      refs:
        - handler: qi:message
          payload: "你来到了新的世界"

---

周期触发 tick

actions:
  triggers:
    regen_aura:
      trigger:
        atom: tick
      tick: 40                  # 每 40 tick（2 秒）
      refs:
        - handler: qi:command
          payload: "effect give {player} minecraft:regeneration 2 0"

---

序列连招 sequence

actions:
  triggers:
    whirlwind:
      trigger:
        sequence:
          - sneak_down
          - left_click
          - left_click
        window: 500             # 步间窗口（毫秒）
      cooldown: 5s
      consume:
        - "level:2"
      refs:
        - handler: qi:message
          payload: "<gold>旋风斩！</gold>"
        - handler: qinhskills:cast
          payload: '{"skill":"whirlwind_slash","level":1}'

---

组合：条件 + 消耗 + 冷却

actions:
  triggers:
    power_strike:
      trigger:
        atom: on_hit
      cooldown: 3s
      conditions:
        - "player_level:>=15"
        - "player_sneaking:true"
      consume:
        - "item:redstone:1"
      refs:
        - handler: qi:title
          payload: "<red>强力一击</red>||||5||20||5"
        - handler: combat:swing
          payload: "heavy"

条件 / 消耗 / 冷却语法见 冷却 / 消耗 / 条件。

---

下一步

• 触发器原子大全：全部原子清单
• 处理器：每个处理器的 payload
• 冷却 / 消耗 / 条件