> 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/expert/condition-editor.md).

# Condition Editor

When a player is carrying out a stage of a quest, it may be desirable to force them to meet a certain criteria. For example, holding a specific item while completing objectives. To do this, a condition must be created and applied.

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

![](/files/hisRgnw44IpSI7k4gAoT)

Enter '1' in chat so the plugin may prompt you to enter a name for your condition. 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/D15akbIKokxQJjONJUmN)

<details>

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

1. Change the name of your condition
2. Ride an entity or [Citizens](https://pikamug.gitbook.io/quests/beginner/dependencies#citizens) NPC
3. Own permission, hold item in main hand, or wear items as armor
4. Stay within world, stay within ticks, stay within biome, or stay within [WorldGuard](https://pikamug.gitbook.io/quests/beginner/dependencies#worldguard) region
5. Whether placeholder value is true
6. Whether to fail quest if condition not met
7. Finish working on your condition
8. Discard all work on your condition

</details>

Select a condition type and decide whether the player should fail the quest if said condition is not met. Now, enter all the appropriate prompt numbers for 'Done' until you've saved your condition.

Nice job! Unlike the Quests Editor, there is no need to reload the plugin. Exit the Condition 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 11 to apply the condition.


---

# 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/expert/condition-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.
