跳到主要内容

🪇 事件

简介​

events 配置段用于让物品、家具或方块在特定事件发生时执行预定义行为。先指定事件触发器，例如 "right_click" 表示右键点击；再在触发器下配置要执行的函数列表及其类型，例如使用 command 执行命令。

events:
  - on: right_click
    functions:
      - type: command
        command: say 1
        conditions:
          - type: permission
            permission: "craftengine.admin"
      - type: command
        command: say 2
        conditions: []
  - on:
      - attack
      - left_click
    functions:
      - type: command
        command: say 3

🧨 事件触发器​

物品​

  • item_break — 物品耐久度耗尽并损坏
  • block_break — 玩家使用该物品破坏方块
  • right_click
  • left_click
  • consume
  • pick_up
  • attack

方块​

  • block_break — 方块被破坏
  • place
  • right_click
  • left_click
  • step

家具​

  • furniture_break — 家具被破坏
  • place
  • right_click
警告

请注意：事件需配置在正确的区域。例如若需实现家具交互时执行指令，应将 events 置于 furniture 部分而非物品部分下。

items:
  default:bench:
    events: # ❌️
      right_click:
        - type: command
    behavior:
      type: furniture_item
      furniture:
        events: # ✅️
          right_click:
            - type: command