Events Reference
Obsidrel-Skript registers 23 Bukkit-backed event patterns. Their base syntax is on obsidrel <event name>:. All types have a registered Player conversion for Skript, but some individual events do not have an online player, for example an entity spawned without a player source. Do not assume that event-player always exists.
The Cancelable column reflects the Obsidrel public event classes implementing Bukkit's Cancellable interface. It does not guarantee that cancelling every event is supported by every external plugin or that every event has been independently runtime-tested.
All 23 events
| Event syntax | Cancelable | obsidrel event id returns |
|---|---|---|
on obsidrel action execute: | Yes | Action ID |
on obsidrel animation finish: | No | Definition ID |
on obsidrel armor equip: | No | Armor item ID |
on obsidrel armor unequip: | No | Armor item ID |
on obsidrel armor set bonus: | No | Armor set ID |
on obsidrel block place: | Yes | Block definition ID |
on obsidrel block break: | Yes | Block definition ID |
on obsidrel cosmetic equip: | Yes | Cosmetic ID |
on obsidrel cosmetic unequip: | No | Cosmetic ID |
on obsidrel entity spawn: | No | Entity definition ID |
on obsidrel entity interact: | Yes | Entity definition ID |
on obsidrel entity death: | No | Entity definition ID |
on obsidrel furniture place: | Yes | Furniture definition ID |
on obsidrel furniture interact: | Yes | Furniture definition ID |
on obsidrel furniture break: | Yes | Furniture definition ID |
on obsidrel furniture seat: | Yes | Furniture definition ID |
on obsidrel item break: | Yes | Item definition ID |
on obsidrel item damage: | Yes | Item definition ID |
on obsidrel item use: | Yes | Item definition ID |
on obsidrel loot roll: | Yes | Loot table ID |
on obsidrel player data change: | No | Data key |
on obsidrel state change: | No | Definition ID |
on obsidrel trigger fire: | Yes | Trigger ID |
Read a custom resource ID
on obsidrel furniture interact:
send "Furniture: %obsidrel event id%" to event-player
This was tested with a player-initiated furniture interaction. For event types without a guaranteed player, avoid blindly sending to event-player; inspect whether the event has a valid online actor in your application.
Cancel a custom block operation
on obsidrel block break:
if obsidrel event id is "obsidrel:ruby_block":
cancel event
send "This block is protected." to event-player
This pattern was validated: the custom block remained in the world when the event was cancelled with a suitable tool.
Notes
obsidrel event idchanges meaning by event type: e.g. block definition ID vs. Player Data key.- Skript event cancellation works only on cancellable underlying public events (see the table).
- Only representative events (furniture interaction, block placement and block breaking) were individually exercised in the initial 1.0.0 validation. The other patterns are registered but need scenario-specific tests.
- These are Obsidrel events, not general Bukkit
on breakoron interacthandlers.