Event triggers

Craftorithm supports multiple Bukkit event types as trigger types, covering player, entity, inventory, and block events.

Usage

Set the event name as the type field in your trigger YAML:

my_trigger:
  type: 'player_join'
  actions:
    - 'tell("&aWelcome!")'

Event List

Player Events

Event	Description	Context Variables
player_join	Player joins	—
player_quit	Player quits	—
player_death	Player dies	killer_name
player_respawn	Player respawns	—
player_interact	Player interacts	action
player_interact_entity	Interact with entity	entity_type
player_advancement	Advancement completed	advancement
player_level_change	Level changes	old_level, new_level
player_exp_change	Experience changes	amount
player_toggle_sneak	Sneak toggle	sneaking
player_toggle_sprint	Sprint toggle	sprinting
player_item_consume	Item consumed	item
player_item_held	Held item slot changes	previous_slot, new_slot
player_animation	Player animation	—
player_bed_enter	Enter bed	—
player_bed_leave	Leave bed	—
player_bucket_fill	Fill bucket	—
player_bucket_empty	Empty bucket	—
player_changed_world	World change	from
player_portal	Enter portal	—
player_teleport	Teleport	cause
player_fish	Fishing	state
player_shear_entity	Shear entity	entity_type
player_unleash_entity	Unleash entity	—
player_edit_book	Edit book	—
player_statistic	Statistic changes	statistic, value
player_swap_hand_items	Swap hand items	—
player_drop_item	Drop item	item
player_pickup_item	Pick up item	item
player_velocity	Velocity change	—
player_game_mode_change	Game mode change	new_game_mode
player_resource_pack_status	Resource pack status change	status
player_item_damage	Item durability loss	item, damage
player_item_mend	Mending	item, amount, repair_amount
player_recipe_discover	Recipe discovered	recipe
player_take_campfire	Take item from campfire	item
player_move	Player moves	-
player_command_preprocess	Command preprocessing	message
async_player_chat	Async chat	message

Entity Events

Event	Description	Context Variables
damage_entity	Entity damaged	damage, entity_type, entity_name
kill_entity	Entity killed	entity_type, entity_name
entity_shoot_bow	Shoot bow	force
entity_breed	Breeding	entity_type
entity_tame	Taming	entity_type
entity_potion_effect	Potion effect change	effect_type

Inventory Events

Event	Description	Context Variables
inventory_click	Click slot	slot, click_type
inventory_close	Close inventory	—
inventory_open	Open inventory	—
prepare_grindstone	Grindstone shows result	—
trade_select	Select villager trade	index

Block Events

Event	Description	Context Variables
block_break	Break block	block_type
block_place	Place block	block_type

Recipe Events

Event	Description	Context Variables
recipe_load	Fires when Craftorithm loads a recipe	recipe_key

In a recipe_load trigger, recipe_key holds the key of the recipe being loaded (for example craftorithm:my_recipe). This event fires while loading recipes, and there is no player in the context.

on_recipe_load:
  type: 'recipe_load'
  actions:
    - 'log("Loading recipe: " + recipe_key)'

Context Variables

Each event type automatically injects relevant variables into the script context.

Event Object

All triggers have an event object in their context that allows direct access to the Bukkit event object.

The event object is a reflective property resolver that can access event properties through method calls.

Usage Example

on_craft_diamond_sword:
  type: 'crafting'
  recipes:
    - 'minecraft:diamond_sword'
  conditions:
    mode: script
    body:
      - 'if event.get("view").get("player").invoke("getName") == "Yufiria_"'
      - '  tell("The plugin developer is crafting!")'
      - 'endif'
  actions:
    - 'tell("&aCrafting successful!")'
    - 'give_level(100)'

Access Methods

• event.get("propertyName") - Get event property
• .invoke("methodName") - Call method on object
• Chained calls supported: event.get("view").get("player").invoke("getName")

Example: Check Killed Entity Type

on_kill_zombie:
  type: 'kill_entity'
  conditions:
    - 'entity_type == "ZOMBIE"'
  actions:
    - 'tell("&aYou killed a zombie!")'

Example: Check Advancement

on_diamond_advancement:
  type: 'player_advancement'
  conditions:
    - 'advancement == "minecraft:story/mine_diamond"'
  actions:
    - 'tell("&bYou found diamonds!")'
    - 'give_money(1000)'

Example: Check Chat Message

on_keyword:
  type: 'async_player_chat'
  conditions:
    - 'perm("craftorithm.vip")'
  actions:
    - 'tell("&aVIP spoke!")'