Event Actions
Event Actions, or simply events, are a system in Housing that allow for chains of actions to be triggered on a player when they fire a certain event within the house, such as joining, dying, getting a kill or dropping an item.
Event Actions were added in 2021 alongside Local Stats, the precursor to player stats. At the time, only Player Join, Player Death, Player Kill and Player Respawn were supported. As of 2024, there are 18 supported types of events.
Actions
Certain event actions prevent specific actions from being added, such as the action Change Player Group being blacklisted from the Group Changed event. This was likely implemented to prevent recursion, a type of programming logic that allows code to call itself repeatedly.
Event Actions can hold up to 30 conditional actions in a single action chain as opposed to the default 15.
Cancelling events
Some events have the ability to be cancelled through the Cancel Event action, such as Player Drop Item. This will stop the event before it is triggered. For example, by cancelling the Player Damage event you will stop the player from taking damage.
The Player Block Break event only triggers when a block is not successfully broken, and thus does not have the action available.
Additional conditions
The Conditional action has extra conditions to choose from in certain event actions. Below are all of the added event action conditions that are not usable outside of their respective contexts.
| Event Action | Condition | Description | Notes |
|---|---|---|---|
| PvP Stage Change | PvP Enabled | Requires the PvP state to have changed to enabled from disabled. | |
| Fish Caught | Fishing Environment | Check the type of environment that the player fished in. | Lava Fishing requires the
|
| Player Enter Portal | Portal Type | Check the type of portal that was used by the player. | Players in survival mode will trigger Nether Portals after 4 seconds, while creative mode is instant. |
| Player Damage | Damage Cause | Check the type of damage that was taken by the player. | |
| Player Damage | Damage Amount | Check the amount of damage that was taken by the player. | |
| Player Block Break | Block Type | Check that the type of block that has been broken matches the item provided. | |
| Player Block Break | Within Region | Requires the location to be within the selected region. | The appearance is the same as the regular condition, but the behaviour takes the position of the block instead of the player. |
| Player Drop Item | Is Item | Requires the item from the event to match the provided item. | |
| Player Pick Up Item | |||
| Player Change Held Item |