> For the complete documentation index, see [llms.txt](https://visualonecompany.gitbook.io/storyframeworkdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visualonecompany.gitbook.io/storyframeworkdocs/core-components/editor/quick-actions.md).

# Quick Actions

SF6 introduced a new system called "Quick Actions". These are modular object classes that can be used to build completely custom interactions and interaction results without ever coding it through BP or CPP yourself (Used on interactables, but is not limited to usage within interactions).

***

Inside of the `Quick Action Triggers` drop-down within any interactables "Interaction Data", you'll find arrays to execute quick actions at different events throughout a single interaction.

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FMAmhwWlkJcC16yz7QoCS%2Fimage.png?alt=media&amp;token=8a62cb41-d5cd-4084-9a37-283fe09a4549" alt=""><figcaption></figcaption></figure></div>

* **On Primary Interact**\
  Executes upon primary interacting with an object, regardless of interaction configurations.
* **On Secondary Interact**\
  Executes upon secondary interacting with an object. Secondary interaction and subsequently these Quick Actions would only be available if your object has a vaild secondary interaction method set.
* **After Interact**\
  Executes after certain interactions. A few examples are; After closing out of an inspection interaction, after exiting a Custom View interaction, after a "drag" interaction has been "released", after dialogue with one of SF's sample base NPC classes has finished, etc.
* **On Looked At**\
  A custom scenario that executes when the player looks at your interactable.

***

Upon adding a new index into either array above, you'll need to define an `Action Type` . SF includes a large collection of these action types out-of-the-box. Hovering over any action type will display a tooltip explaining what `Action Property` it supports, as well as how to use the `Universal Action Property` type (the "Universal" property is accepted by all Quick Actions, but behaves differently between each Action Type).

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FJdGztldQmgyrqj9Kz8xx%2Fimage.png?alt=media&amp;token=6e8a657d-d8fb-4ecf-a53c-42be3f6c2ec8" alt=""><figcaption></figcaption></figure></div>

`Delay` simply allows you to define a delay before this Quick Action executes. This can be used to delay any Quick Actions added after one with a delay as well, as Quick Actions execute sequentially. `Do Once (ID)` allows you to define a unique ID for this Quick Action if you'd only want this Quick Action to execute a single time.

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2Fdc6734ExiNhyAF9bGZwN%2Fimage.png?alt=media&amp;token=b6d30745-46d6-4149-a2c9-93e09e0fbc3a" alt=""><figcaption></figcaption></figure></div>

***

Let's look at a use-case example.

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FhvH78sTEmamylqSgXhO6%2Fimage.png?alt=media&amp;token=02c48762-9d7a-47e7-b683-f610880e3107" alt=""><figcaption></figcaption></figure></div>

Upon primary interacting with this actor, we play a custom sound through the `PlaySound_AtLocation` Quick Action > then add a codex entry into the players codex through the `AddEntry_Codex` Quick Action > and finally add an entry into the players journal through the `AddEntry_Journal` Quick Action.\
\
What we've done here is essentially setup a completely custom, bespoke piece of logic unique to this single interactable without ever creating a child blueprint or opening up a blueprint graph. That is the power of Quick Actions.

***

{% hint style="warning" icon="graduation-cap" %}
I heavily encourage you to read the tooltips of Quick Actions when hovering over them. They'll be very informative and help with understanding how exactly each Quick Action is used.
{% endhint %}
