Complete reference: Actions
Actions live in resources/actions/. Definitions are reusable and execute only when invoked.
| Field | Format | Behavior |
|---|---|---|
enabled | boolean (true) | Activation |
permission | text/empty | Whole-action permission |
conditions / condition | IDs | Preconditions |
failure-message / condition-message | text | Denial feedback |
steps / actions | map | Ordered steps |
steps.<id>.type | operation type | Selects effect |
steps.<id>.delay | duration (5t, 2s) | Delay |
steps.<id>.chance | probability | Execution chance |
steps.<id>.permission | text | Step gate |
steps.<id>.conditions | IDs | Step-only eligibility |
steps.<id>.cancel-event | boolean | Supported event cancellation |
Core operations include MESSAGE, COMMAND, SOUND, TITLE, ACTION_BAR, PARTICLE, GIVE_ITEM, REMOVE_ITEM, TELEPORT, MENU, HUD, ACTION, VAR_SET, VAR_ADD, VAR_REMOVE, VAR_RESET, FLAG_SET, FLAG_TOGGLE, TIMER_START, LOOT, CLOSE_MENU. Aliases include GIVE, REMOVE, LOOT_TABLE; additional operations exist in specialized engines. Each type has distinct parameters.
Advanced reusable example
reward:
enabled: true
conditions: [showcase_level_five]
steps:
notice:
type: ACTION_BAR
message: '<green>Reward unlocked</green>'
prize:
type: GIVE_ITEM
delay: 10t
item: AMETHYST_SHARD
amount: 1
showcase_level_five is a bundled Showcase condition; replace with your own ID otherwise.