Shared Gameplay Event IDs

EmakiCoreLib normalizes selected Bukkit / MythicMobs gameplay events into shared gameplay event IDs, then dispatches them to EmakiLevel and EmakiCodex.

This page answers two common configuration questions:

• Which trigger IDs can be used in EmakiLevel sources.*.trigger.
• Which event IDs can be used in EmakiCodex triggers.entries[].event.

These IDs are configuration strings, not Bukkit event class names. Use the lowercase IDs in the table directly, such as entity_kill or craft_item.

Where to use them

Plugin	Config path	Field	Purpose
EmakiLevel	plugins/EmakiLevel/sources/*.yml	sources.<source_id>.trigger	Triggers an experience source rule.
EmakiCodex	plugins/EmakiCodex/advancements/*.yml	advancements.<node_id>.triggers.entries[].event	Triggers an automatic advancement-node grant.

Available event IDs

Event ID	Raw source	EmakiLevel	EmakiCodex	Variables
entity_kill	A player-attributed entity death; uses Bukkit killer first and recent-damager attribution when needed	Usable as an exp source	Usable as an advancement trigger	%entity_type%
mythic_mob_kill	A MythicMobs active mob detected during the same death flow as entity_kill	Usable as an exp source	Usable as an advancement trigger	%mythic_id%, %mythic_level%
block_break	A player breaks a block	Usable as an exp source	Usable as an advancement trigger	%block_type%
crop_harvest	Derived from block_break when the broken block is a mature Ageable crop	Usable as an exp source	Usable as an advancement trigger	%block_type%
craft_item	A player crafts a recipe result	Usable as an exp source	Usable as an advancement trigger	%result_type%, %result_amount%
furnace_extract	A player extracts a smelted result from a furnace	Usable as an exp source	Usable as an advancement trigger	%result_type%, %result_amount%
player_fish	A player fishing event	Usable as an exp source	Usable as an advancement trigger	%fish_state%
brew_complete	Brewing completes and is attributed to the most recent player who used that brewing stand	Usable as an exp source	Usable as an advancement trigger	%potion_type%
entity_tame	A player tames an entity	Usable as an exp source	Usable as an advancement trigger	%entity_type%
block_place	A player places a block	Used only by Level anti-abuse tracking, not as an exp source trigger	Codex does not currently subscribe to it	%block_type%

Variables

Variable	Description
%entity_type%	Bukkit EntityType name, such as ZOMBIE, WOLF, or ENDER_DRAGON.
%mythic_id%	MythicMobs internal mob ID.
%mythic_level%	MythicMobs mob level; defaults when the level is unavailable.
%block_type%	Bukkit Material name, such as STONE, WHEAT, or OAK_LOG.
%result_type%	Bukkit Material name of the crafting or furnace result.
%result_amount%	Crafted or extracted amount. Crafting is clamped to at least 1; furnace extraction uses the extracted amount.
%fish_state%	PlayerFishEvent.State name, such as CAUGHT_FISH, CAUGHT_ENTITY, or FISHING.
%potion_type%	First recognized base potion type in the brewing stand output, or UNKNOWN.

EmakiCodex also adds these variables to every forwarded trigger:

Variable	Description
%player%	Player name.
%world%	Player world name.

Level example

sources:
  main_entity_kill_bonus:
    enabled: true
    type: "main"
    trigger: "entity_kill"
    include_players: false
    rules:
      - entity_types: ["ZOMBIE", "SKELETON"]
        exp_formula: "10"

Mature crop harvest:

sources:
  farming:
    enabled: true
    type: "farming"
    trigger: "crop_harvest"
    rules:
      - blocks: ["WHEAT", "CARROTS", "POTATOES"]
        exp_formula: "4"

Codex example

advancements:
  craft_table:
    icon: "minecraft-crafting_table"
    title: "<green>Start Crafting</green>"
    description: "<gray>Craft a crafting table.</gray>"
    triggers:
      entries:
        - event: "craft_item"
          condition:
            type: "all_of"
            entries:
              - '%result_type% == "CRAFTING_TABLE"'

Killing a specific MythicMobs mob:

advancements:
  ancient_guardian:
    icon: "minecraft-nether_star"
    title: "<gold>Ancient Guardian</gold>"
    description: "<gray>Defeat the configured MythicMobs mob.</gray>"
    triggers:
      entries:
        - event: "mythic_mob_kill"
          condition:
            type: "all_of"
            entries:
              - '%mythic_id% == "ancient_guardian"'
              - '%mythic_level% >= 10'

CoreLib-side configuration

Event publishing is controlled by CoreLib's own plugins/EmakiCoreLib/config.yml:

gameplay_events:
  enabled: true
  last_damager_expire_ticks: 200
  brew_attribution_expire_ticks: 6000

Key	Default	Description
enabled	true	Master switch. When disabled, CoreLib stops publishing gameplay events and dependent plugins receive nothing.
last_damager_expire_ticks	200	Last-damager attribution window for entity_kill. When Bukkit does not record the killer directly (arrows, delayed death), the kill is still attributed to the last attacking player within this window. This is a coarse upper bound; subscribers may narrow it further.
brew_attribution_expire_ticks	6000	Brewing attribution retention window for brew_complete, roughly 5 minutes. This is a loose upper bound that only prevents attribution records from being retained indefinitely; the effective business window is narrowed by each subscriber (for example EmakiLevel's per-source attribution.expire_ticks, default 1200). It must exceed every business window a subscriber might configure, otherwise attribution is cut off before the subscriber evaluates it.

Notes

• crop_harvest is not a standalone Bukkit event. It is a CoreLib config ID derived from block_break when the broken block is a mature crop.
• mythic_mob_kill is emitted separately from entity_kill for the same death. If both triggers are configured, both rules may be processed.
• brew_complete must be attributed to the most recent player who interacted with the brewing stand. Codex uses a shorter attribution window; Level can configure its own attribution.expire_ticks per source rule.
• block_place currently exists mainly so EmakiLevel can remember player-placed blocks and avoid rewarding players for placing then breaking blocks. Do not use it as a normal exp source or Codex advancement trigger.