> For the complete documentation index, see [llms.txt](https://paw-studio.gitbook.io/paw-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paw-studio.gitbook.io/paw-studio-docs/litedungeon/dungeon-configuration/action-and-trigger-list.md).

# 📋Action & Trigger List

When you configure the RULE via the GUI, you will automatically get supported and available settings for the action.

## Actions

Actions define what happens when a dungeon trigger is activated.

| Action            | Description                                                  |
| ----------------- | ------------------------------------------------------------ |
| `SPAWN`           | Spawns an entity in the dungeon.                             |
| `SEND_MESSAGE`    | Sends a message to the player.                               |
| `SEND_ANIMATION`  | Plays a sound or animation for the player.                   |
| `CHEST_GENERATOR` | Generates loot inside a chest using a configured loot table. |
| `PLACE`           | Places a configured block at the target location.            |

***

## Triggers

Triggers define **when** an action should be executed.

| Trigger         | Description                                                           |
| --------------- | --------------------------------------------------------------------- |
| `START_DUNGEON` | Triggered when the dungeon starts.                                    |
| `BREAK`         | Triggered when a player breaks a configured block.                    |
| `PLACE`         | Triggered when a player places a block.                               |
| `USE`           | Triggered when a player uses or interacts with the configured object. |
| `DETECT`        | Triggered when a player is detected in the configured area.           |
| `IN_DUNGEON`    | Triggered when a player enters the dungeon.                           |
| `OUT_DUNGEON`   | Triggered when a player leaves the dungeon.                           |
| `KILL`          | Triggered when a player kills an entity by ID.                        |
| `KILL_ALL`      | Triggered when all ID entities have been killed.                      |
| `PUZZLE_FIND`   | Triggered when a player finds the configured puzzle target.           |

***

## Settings

Settings define the parameters and conditions used by actions and triggers.

| Setting         | Description                                                                                                                                                                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MAX_USES`      | How many times the trigger/actions can be activated.                                                                                                                                                                                                      |
| `AMOUNT`        | A quantity per use, such as the number of spawned entites.                                                                                                                                                                                                |
| `BLOCKS`        | Defines a group of blocks affected by the action or trigger.                                                                                                                                                                                              |
| `MESSAGE`       | Defines the message that will be sent to the player.                                                                                                                                                                                                      |
| `ANIMATION`     | Defines the sound or animation to play.                                                                                                                                                                                                                   |
| `TARGET_PLAYER` | Defines which player should be affected by the action.                                                                                                                                                                                                    |
| `ENTITY`        | Defines the entity type used by the action or trigger.                                                                                                                                                                                                    |
| `LOOT_TABLE`    | Defines the loot table used to generate items.                                                                                                                                                                                                            |
| `ID`            | Sets a unique ID for the object or rule.                                                                                                                                                                                                                  |
| `DELAY`         | Sets the delay before the action is executed, in ticks. If applied to an activity that supports a group of blocks or an entity, then these will be activated one at a time. For example, 10 spawned zombies that will spawn with an interval of 1 second. |
| `MATERIAL`      | Defines the material used by the action or trigger.                                                                                                                                                                                                       |
