事件触发器

Craftorithm 支持多种 Bukkit 事件作为触发器类型，覆盖玩家、实体、背包、方块等各类事件。

使用方式

在触发器 YAML 的 type 字段中使用事件名即可：

my_trigger:
  type: 'player_join'
  actions:
    - 'tell("&a欢迎！")'

事件列表

玩家事件

事件名	说明	上下文变量
player_join	玩家加入	—
player_quit	玩家退出	—
player_death	玩家死亡	killer_name
player_respawn	玩家重生	—
player_interact	玩家交互	action
player_interact_entity	玩家与实体交互	entity_type
player_advancement	完成进度	advancement
player_level_change	等级变化	old_level, new_level
player_exp_change	经验变化	amount
player_toggle_sneak	潜行切换	sneaking
player_toggle_sprint	疾跑切换	sprinting
player_item_consume	消耗物品	item
player_item_held	切换手持物品	previous_slot, new_slot
player_animation	玩家动画	—
player_bed_enter	上床	—
player_bed_leave	离床	—
player_bucket_fill	装满桶	-
player_bucket_empty	倒空桶	-
player_changed_world	切换世界	from
player_portal	进入传送门	—
player_teleport	传送	cause
player_fish	钓鱼	state
player_shear_entity	剪羊毛	entity_type
player_edit_book	编辑书本	—
player_statistic	统计值变化	statistic, value
player_swap_hand_items	切换主副手	—
player_drop_item	丢弃物品	item
player_pickup_item	拾取物品	item
player_velocity	速度变化	—
player_game_mode_change	游戏模式变化	new_game_mode
player_item_damage	物品损坏	item, damage
player_item_mend	经验修补	item, amount, repair_amount
player_recipe_discover	发现配方	recipe
player_take_campfire	从营火取出物品	item
player_move	玩家移动	-
player_command_preprocess	命令预处理	message
async_player_chat	异步聊天	message

实体事件

事件名	说明	上下文变量
damage_entity	实体受伤	damage, entity_type, entity_name
kill_entity	实体被击杀	entity_type, entity_name
entity_shoot_bow	射箭	force
entity_breed	繁殖	entity_type
entity_tame	驯服	entity_type
entity_potion_effect	药水效果	effect_type

背包事件

事件名	说明	上下文变量
inventory_click	点击格子	slot, click_type
inventory_close	关闭背包	—
inventory_open	打开背包	—
prepare_grindstone	砂轮显示结果时	—
trade_select	选择村民交易项	index

方块事件

事件名	说明	上下文变量
block_break	破坏方块	block_type
block_place	放置方块	block_type

上下文变量

每个事件类型会自动注入相关变量到脚本上下文中，可通过 context("变量名") 函数访问。

event 对象 (1.13.0.0+)

从 1.13.0.0 版本开始，所有触发器的上下文中都新增了 event 对象，可以直接操作 Bukkit 事件对象。

event 对象是一个反射属性解析器，可以通过方法调用来访问事件的属性。

使用示例

on_craft_diamond_sword:
  type: 'crafting'
  recipes:
    - 'minecraft:diamond_sword'
  conditions:
    mode: script
    body:
      - 'if event.get("view").get("player").invoke("getName") == "Yufiria_"'
      - '  tell("是插件开发者正在进行合成！")'
      - 'endif'
  actions:
    - 'tell("&a合成成功！")'
    - 'give_level(100)'

访问方式

• event.get("propertyName") - 获取事件的属性
• .invoke("methodName") - 调用对象的方法
• 链式调用支持：event.get("view").get("player").invoke("getName")

示例：检查击杀的实体类型

on_kill_zombie:
  type: 'kill_entity'
  conditions:
    - 'entity_type == "ZOMBIE"'
  actions:
    - 'tell("&a你击杀了一只僵尸！")'

示例：检查进度

on_diamond_advancement:
  type: 'player_advancement'
  conditions:
    - 'advancement == "minecraft:story/mine_diamond"'
  actions:
    - 'tell("&b你挖到了钻石！")'
    - 'give_money(1000)'

示例：检查聊天消息

on_keyword:
  type: 'async_player_chat'
  conditions:
    - 'perm("craftorithm.vip")'
  actions:
    - 'tell("&aVIP 发言！")'