Item Use Condition (Start / Stop / Finish)

基本信息

属性 值
父类 ItemUseConditionHandler（继承自 ItemConditionHandler）
子类 ID item.use.start, item.use.stop, item.use.finish
事件订阅 Forge MinecraftForge.EVENT_BUS（net.minecraftforge.event.entity.player.PlayerUseItemEvent$*）

共享配置字段

继承自 ItemConditionHandler：item / meta / nbt —— 含义与触发栈完全相同。

子类差异

子类 ID 监听事件 优先级 触发语义
item.use.start PlayerUseItemEvent.Start LOWEST 玩家开始使用物品（如拉弓、扔末影珍珠的前摇）时触发
item.use.stop PlayerUseItemEvent.Stop LOWEST 玩家停止使用物品（如松弓、取消）时触发
item.use.finish PlayerUseItemEvent.Finish 默认 玩家物品使用动作自然完成（如弓射出）时触发

JSON 示例

完成一次弓射击：

{
  "id": "bullseye",
  "x": -1, "y": 2,
  "icon": { "registryName": "minecraft:arrow" },
  "condition": {
    "type": "item.use.finish",
    "item": "minecraft:bow",
    "meta": 0
  }
}

相关条目

源码

src/main/java/glowredman/amazingtrophies/condition/ItemUseConditionHandler.java