# Quest

{% embed url="<https://youtu.be/-CWLO4OE1_Q>" %}

## Creation

To create a quest, find (or create) the *GameName/Resources/GameName/Quest* folder in the project tab and right click.  Choose *Create > AnyRPG > Quest*.

## Properties

| Name                        | Description                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Steps                       | A list of steps, with [Objectives](#undefined) for each step, that must be completed in order to finish the quest.                                                                                                                                                                                                                                                                      |
| Prerequisite Conditions     | A list of [Prerequisite Conditions](/shared-properties/prerequisite-conditions.md) that must be met to start the quest.                                                                                                                                                                                                                                                                 |
| Repeatable Quest            | If true, the quest can be accepted and completed more than once.                                                                                                                                                                                                                                                                                                                        |
| Has Opening Dialog          | If true, a Dialog with the same name as the quest will be used (if found) and will be required to be completed before the quest can be accepted.                                                                                                                                                                                                                                        |
| Experience Level            | The level that is considered appropriate for the quest. This value is used to calculate experience reward reduction if the player is a higher level than this value.                                                                                                                                                                                                                    |
| Dynamic Level               | If true, the quest will always be considered to be the same level as the player.                                                                                                                                                                                                                                                                                                        |
| Extra Levels                | If dynamic level is true, this value can be used to make the quest a higher level than the player.                                                                                                                                                                                                                                                                                      |
| Base Experience Reward      | The base experience for the quest, not scaled by level, and in addition to any automatic quest xp configured at the game level (in the System Configuration Manager).                                                                                                                                                                                                                   |
| Experience Reward Per Level | The experience for the quest, scaled by level, and in addition to any automatic quest xp configured at the game level (in the System Configuration Manager).                                                                                                                                                                                                                            |
| Automatic Currency Reward   | If true, the quest will reward [Currency](/scriptable-objects/currency.md) based on the system quest currency reward settings (in the System Configuration Manager).                                                                                                                                                                                                                    |
| Reward Currency Name        | The name of a [Currency](/scriptable-objects/currency.md) that will be rewarded to the player when the quest is complete.                                                                                                                                                                                                                                                               |
| Base Currency Reward        | The base [Currency](/scriptable-objects/currency.md) reward for the quest, not scaled by level, and in addition to any automatic currency reward configured at the game level (in the System Configuration Manager).                                                                                                                                                                    |
| Currency Reward Per Level   | The [Currency](/scriptable-objects/currency.md) rewarded for completing the quest, scaled by level, and in addition to any automatic [Currency](/scriptable-objects/currency.md) reward configured at the game level (in the System Configuration Manager).                                                                                                                             |
| Max Item Rewards            | The maximum number of [Item](/scriptable-objects/items.md) rewards that can be chosen, if there is more than one possible [Item](/scriptable-objects/items.md) reward.                                                                                                                                                                                                                  |
| Item Reward Names           | The names of [Items](/scriptable-objects/items.md) that will be given as rewards for completing the quest.                                                                                                                                                                                                                                                                              |
| Max Faction Rewards         | The maximum number of [Faction](/scriptable-objects/faction.md) rewards that can be chosen, if there is more than one possible [Faction](/scriptable-objects/faction.md) reward.                                                                                                                                                                                                        |
| Faction Rewards             | <p>A list of <a href="/pages/N8sUj6pl9VAwlgICxBe8">Faction</a> names and values that will be given as rewards for completing the quest.<br><strong>Faction Name</strong><br>The name of the <a href="/pages/N8sUj6pl9VAwlgICxBe8">Faction</a> whom the player will receive increased reputation with.<br><strong>Reputation Amount</strong><br>The amount of reputation to receive.</p> |
| Max Ability Rewards         | The maximum number of [Ability](/scriptable-objects/abilities.md) rewards that can be chosen, if there is more than one possible [Ability](/scriptable-objects/abilities.md) reward.                                                                                                                                                                                                    |
| Ability Reward Names        | The names of [Abilities](/scriptable-objects/abilities.md) that will be given as rewards for completing the quest.                                                                                                                                                                                                                                                                      |
| Max Skill Rewards           | The maximum number of [Skill](/scriptable-objects/skill.md) rewards that can be chosen, if there is more than one possible [Skill](/scriptable-objects/skill.md) reward.                                                                                                                                                                                                                |
| Skill Reward Names          | The names of [Skills](/scriptable-objects/skill.md) that will be given as rewards for completing the quest.                                                                                                                                                                                                                                                                             |
| Turn In Items               | If true, any items that are part of an Item Objective will be removed from the player inventory when the quest is turned in.                                                                                                                                                                                                                                                            |
| Allow Raw Complete          | If true, the player can complete the quest directly, without having the quest in the quest log.                                                                                                                                                                                                                                                                                         |

### Quest Objectives

There are many different types of quest objectives which will be covered below.  They all share the following properties.

| Name                  | Description                                                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Amount                | The amount of the specific objective that must be completed for the objective to be complete.                                                                       |
| Override Display Name | By default, the name of the specific objective will be shown in the quest log.  If this field is not empty, the text shown in this field will be displayed instead. |

#### Collect Objective

| Name          | Description                                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| Item Name     | The name of an [Item](/scriptable-objects/items.md) that must be collected.                                        |
| Partial Match | If true, the *Item Name* can be a substring of a longer name and does not have to match the exact name and length. |

#### Dialog Objective

| Name        | Description                                                                   |
| ----------- | ----------------------------------------------------------------------------- |
| Dialog Name | The name of a [Dialog](/scriptable-objects/dialog.md) that must be completed. |

#### Kill Objective

| Name        | Description                                                                                                              |
| ----------- | ------------------------------------------------------------------------------------------------------------------------ |
| Target Name | The name of an enemy that must be killed.  This can match a character name or [Faction](/scriptable-objects/faction.md). |

#### Learn Ability Objective

| Name         | Description                                                                      |
| ------------ | -------------------------------------------------------------------------------- |
| Ability Name | The name of an [Ability](/scriptable-objects/abilities.md) that must be learned. |

#### Finish Quest Objective

| Name       | Description                                                                       |
| ---------- | --------------------------------------------------------------------------------- |
| Quest Name | The name of another [Quest](/scriptable-objects/quest.md) that must be completed. |

#### Status Effect Objective

| Name        | Description                                                                                                                |
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| Effect Name | The name of a [Status Effect](/scriptable-objects/ability-effects/status-effect.md) that must be applied to the character. |

#### Trade Skill Objective

| Name       | Description                                                               |
| ---------- | ------------------------------------------------------------------------- |
| Skill Name | The name of a [Skill](/scriptable-objects/skill.md) that must be learned. |

#### Use Ability Objective

| Name         | Description                                                                   |
| ------------ | ----------------------------------------------------------------------------- |
| Ability Name | The name of an [Ability](/scriptable-objects/abilities.md) that must be used. |

#### Use Interactable Objective

| Name               | Description                                                                                                                   |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| Interactable Name  | The name of an [Interactable](/scriptable-objects/interactable-option-configurations.md) that must be used (interacted with). |
| Require Completion | If true, and the interactable is of the type that opens a popup window, the function the window provides must be used.        |

#### Visit Zone Objective

| Name      | Description                                                                    |
| --------- | ------------------------------------------------------------------------------ |
| Zone Name | The name of a [Scene](/scriptable-objects/scene-node.md) that must be visited. |

## Next Steps

* Add a quest to a [Quest Start Item](/scriptable-objects/items/quest-start-item.md).
* Add a quest to a [Quest Giver](/scriptable-objects/interactable-option-configurations/quest-giver-config.md).


---

# Agent Instructions: 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:

```
GET https://docs.anyrpg.org/scriptable-objects/quest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
