> For the complete documentation index, see [llms.txt](https://pikamug.gitbook.io/quests/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pikamug.gitbook.io/quests/casual/action-editor.md).

# Action Editor

Similar to how all quest stages have objectives, they can also perform actions. An action is something that happens during a stage, but is typically cosmetic and doesn't inherently progress the quest. For example, causing a player to lose hunger or get struck by lightning are considered actions.

To make an action, run **/quests actions** in-game (or from the console, with limited features). You will be greeted with the following:

![](/files/7MEjsiRyng5H05EXFsnP)

Enter '1' in chat so the plugin may prompt you to enter a name for your action. This can be any alphanumeric sequence, which means letters and numbers are OK, but no special characters or symbols! Don't worry, you can change it later if you're unsure.

After you've chosen a valid name, this screen will appear:

![](/files/31P2ekcEWF0jnT8spJsa)

<details>

<summary>Expand to see the breakdown.</summary>

1. Change the name of your action
2. Send message, clear inventory, give items, apply potion effects, set hunger level, set saturation level, teleport to location, or execute commands
3. Set time to fail quest and whether to cancel the quest timer
4. Set effects or set explosion locations
5. Set storm or thunder in a particular world, or set lightning strike locations
6. Set entities to spawn
7. Run a [Denizen](https://pikamug.gitbook.io/quests/beginner/dependencies#denizen) script
8. Immediately fail the quest, ignoring any Fail Actions
9. Finish working on your action
10. Discard all work on your action

</details>

For now, enter '5' for the Weather menu, then '2' to set up an action which will force thunder across a world for a while.

![](/files/CJlasmMS75mWPARYbJPd)

Input '1' to select one of your Minecraft server's worlds by name. They will be listed for your convenience, but you can only select one! You may create a second action later if you wish to deal out thunder across multiple worlds.

Once that's done, enter '2' to set a duration of time in seconds. This is how long your thunder action will last for. As an example, type in 180 for the event to last 3 minutes. Now, enter all the appropriate prompt numbers for 'Done' until you've saved your action.

Nice job! Unlike the [Quest Editor](/quests/setup/quests-editor.md), there is no need to reload the plugin. Exit the Action Editor and then create or edit a quest in the Quests Editor. Go to the 'Edit Stages' menu and, after setting at least one objective, select option 9 to run the action before, during, or after the stage:

![](/files/3ORxa0TkOvNMmpqWIpDQ)

<details>

<summary>Expand to see the breakdown.</summary>

1. Activate on start of stage
2. Activate at end of stage
3. Activate if player fails quest
4. Activate if player dies during stage
5. Activate if player disconnects during stage
6. Activate if chat message sent during stage
7. Activate if command run during stage
8. Save and return to previous menu

</details>

Chat and command actions are run during the stage when the player enters a specific keyword or command in-game, respectively.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://pikamug.gitbook.io/quests/casual/action-editor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
