> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/customization/actions.md).

# Actions

Action strings power every configurable click in GUIs. Format: a lowercase action id followed by its arguments; `{placeholders}` from the GUI context and PlaceholderAPI both resolve first.

| Action              | Syntax                                  | Does                                                             |
| ------------------- | --------------------------------------- | ---------------------------------------------------------------- |
| `message`           | `message <text...>`                     | Sends a colored chat message                                     |
| `console`           | `console <command...>`                  | Runs a command as console                                        |
| `player`            | `player <command...>`                   | Runs a command as the player                                     |
| `give-eco`          | `give-eco <currency> <amount>`          | Adds an [internal currency](/p/edpets/core/currencies.md)        |
| `take-eco`          | `take-eco <currency> <amount>`          | Removes an internal currency                                     |
| `title`             | `title <text...>`                       | Shows a title                                                    |
| `titlewithsubtitle` | `titlewithsubtitle <title>\|<subtitle>` | Title + subtitle                                                 |
| `sound`             | `sound <SOUND> [volume] [pitch]`        | Plays a sound                                                    |
| `close`             | `close`                                 | Closes the open menu                                             |
| `open-gui`          | `open-gui <gui-id> [key=value ...]`     | Opens a configured GUI (extra pairs become `{key}` placeholders) |

Example — a ticket purchase button:

```yaml
buy-ticket:
  material: PAPER
  slot: 30
  name: '&b&lBuy a Boost Ticket &7(100 tokens)'
  requirement: '%pinnaprison_currency_balance_tokens% >= 100'
  left-click-actions:
    - 'console tokens take {player} 100 -s'
    - 'give-eco boost-tickets 1'
    - 'sound ENTITY_PLAYER_LEVELUP 1 2'
    - 'message &aPurchased a Boost Ticket!'
```

Actions that touch the world/commands hop to the main thread automatically — they're safe on any button.