Skip to content

Events

All events fire synchronously on the target player's owner thread. All three cover only the vanilla advancement layer; category-entry unlock, activation, and claim currently publish no public events.

EventTimingCancellableMutable fieldCancellation/effect
AdvancementGrantEventAfter validation, before criterion awardYesNoneLeaves progress untouched and returns a cancelled result.
AdvancementRevokeEventAfter validation, before criterion revocationYesNoneLeaves the advancement intact and returns a cancelled result.
AdvancementCompletedEventFrom Bukkit's actual advancement-completion eventNoNoneInformational after completion; exposes player, advancement id, and key.

Grant/revoke pre-events cover every EmakiCodex mutation path: public operations, commands, actions, configured triggers, and external trigger providers. The completed event observes every advancement registered by EmakiCodex, including completion caused by another criterion-awarding source. It is not cancellable and cannot undo completion.