Enchantment Events

Type: EnchantmentEvent (enum)

Events represent the game actions that trigger enchantment mechanics. Each event corresponds to a Bukkit event that the extension listens for.

Available Events

Event	Triggered When	Bukkit Event
PLAYER_ATTACK	Player hits an entity	EntityDamageByEntityEvent
PLAYER_DEFEND	Player takes damage	EntityDamageByEntityEvent
BLOCK_BREAK	Player breaks a block	BlockBreakEvent
BOW_SHOOT	Player shoots a bow or crossbow	EntityShootBowEvent
PROJECTILE_HIT	A shot projectile hits an entity	ProjectileHitEvent
ITEM_CONSUME	Player eats or drinks an item	PlayerItemConsumeEvent
PLAYER_DEATH	Player dies	PlayerDeathEvent
PLAYER_INTERACT	Player right/left clicks	PlayerInteractEvent
ARMOR_EQUIP	Player equips or unequips armor	Internal listener
ITEM_DAMAGE	An item takes durability damage	Internal listener
FALL_DAMAGE	Player takes fall damage	EntityDamageEvent
ENVIRONMENTAL_DAMAGE	Non-entity damage (fire, lava, kinetic)	EntityDamageEvent
PLAYER_MOVE	Player moves (throttled)	PlayerMoveEvent
SHIELD_BLOCK	Player blocks an attack with a shield	EntityDamageByEntityEvent
SNEAK	Player starts sneaking	PlayerToggleSneakEvent
SPRINT	Player starts sprinting	PlayerToggleSprintEvent

Usage

Events are used within EnchantmentMechanic to determine when mechanics should execute:

{
  "mechanics": [
    {
      "event": "PLAYER_ATTACK",
      "criteria": [...],
      "actions": ["combat:lifesteal_action"],
      "runOnLevel": 1,
      "chance": 100
    }
  ]
}