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

# Actions

Run commands when a tooltip is being shown.

Actions allow players to interact with tooltips. When any type of tooltip is currently being shown using presets conditions, you are able to listen to actions and execute commands.

## Action configuration

```yaml
preset-id:
    content:
        text:
        - 'Looking at bedrock'
    display:
        theme: default-one-line
    conditions:
      conditions:
      - lookingatblock{type=bedrock} true
      # Actions are specified optionally here
      actions:
        # Action name and list of commands
        right-click-block:
        # A single "say hi" command that will be executed by the console
        - say hi
```

<figure><img src="https://2056457066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO0fJVi4OrBJoOYrP9n9t%2Fuploads%2FZZblQ8QgK3NLmZWlgxtZ%2Fimage.png?alt=media&amp;token=048c7208-e239-46f6-9342-25259c3d5829" alt=""><figcaption><p>right-click-block action executes the "say hi" command in console</p></figcaption></figure>

### Supported actions

<table><thead><tr><th width="261">Action</th><th>Description</th></tr></thead><tbody><tr><td>left-click</td><td>Any type of left click</td></tr><tr><td>left-click-air</td><td>Left click air</td></tr><tr><td>left-click-block</td><td>Left click a block </td></tr><tr><td>left-click-entity</td><td>Left click an entity</td></tr><tr><td>right-click</td><td>Any type of right click</td></tr><tr><td>right-click-air</td><td>Right click air <br>(only works with an item in hand, blame Spigot)</td></tr><tr><td>right-click-block</td><td>Right click a block</td></tr><tr><td>right-click-entity</td><td>Right click an entity</td></tr><tr><td>on-show</td><td>Triggered when a tooltip is first triggered</td></tr><tr><td>on-stop-showing</td><td>Triggered when a tooltip stops being shown</td></tr><tr><td>animation-finished</td><td>Triggered when all animations are done</td></tr></tbody></table>

### Commands

All commands support both PAPI and local placeholders, as well as a backup built-in %player% placeholder for the players username.

This plugin provides some custom commands for convenience. Read more about them here:

{% content-ref url="/pages/yyG599C2wADNhiMoKqEp" %}
[Commands](/tooltips/configuration/preset/actions/commands.md)
{% endcontent-ref %}

### Examples

```yaml
actions:
  # All right and left clicks will make the console say hi
  left-click:
  - say hi
  right-click:
  - say hi
```