---
title: Quests
description: The quest system allows creating complex quests with multiple tasks, rewards and automatic progress. While you also can create quests by using schematics and logs, the quest system offers a convenient way to combine quest information and UI, rewards, navigation…
url: "https://orkframework.com/guide/ork3/ork3-documentation/features/quests/"
updated: "2026-07-21"
category: ORK 3 Documentation / Features
---

# Quests

The quest system allows creating complex quests with multiple tasks, rewards and automatic progress.

While you also can create quests by using schematics and logs, the quest system offers a convenient way to combine quest information and UI, rewards, navigation markers and quest progress. The quest's progress is separated into different quest tasks - the progress can optionally be handled automatically (e.g. finishing a task after killing the required amount of enemies).

To get your quests into your game, you still need schematics to add the quest and display dialogues.

The player's quests can be displayed using *Quest* menu screens and [Quest HUDs](https://orkframework.com/guide/documentation/ui-system/huds-quests/).

# Quest Settings

The quest settings define some basic quest-related settings. They can be found in **Game >****Quest Settings & Types > General Settings**.

E.g. define the number of quests that can be active at the same time or if quest notifications are queued.

## Quest Layout

The quest layout is used to define how quests are displayed in menu screens and quest dialogues.

The quest layout can list rewards, quest tasks and requirements.

Each quest, *Quest* menu screen and quest dialogue can optionally override the default layout.

## Notifications

Define notifications for changes in quests, quest tasks and when a task's finish requirements change.

Learn more about notifications in [this documentation](https://orkframework.com/guide/documentation/ui-system/notifications/).

# Quest Types

Quest types are used to organize quests by separating them into different types.

You'll mainly use them to filter quests in the editor and in-game menus (menu screens) and HUDs. Quest types can be sub-types of other quest types for a more detailed organization.

The quest type also defines the item type of it's quests, e.g. for when they're sold in shops.

Quest types are set up in **Game >****Quest Settings & Types**.

# Quests

Quests are the basic container for quest tasks. They are set up in **Game >****Quests**.

## Settings

Define the basic settings of a quest.

### Learn Logs

Quests can optionally add log texts when a quest was added, finished or failed.

### Availability Conditions

Optionally use conditions to determine if a quest is available.

E.g. use combatant status or variable conditions. Uses the player combatant (i.e. the leader of the player group) for the checks.

The quest can't be added if it's not available - e.g. this would still allow you to display a quest dialogue, but accepting the quest wouldn't be possible.

### Quest Text

Define the text explaining the quest.

The quest text can be displayed in menu screens and dialogues.

## Rewards

A quest can give the player rewards when it's finished.

### Experience Rewards

Gives the player or whole player group defined *Experience* type status values as rewards.

### Normal Status Value Rewards

Gives the player or whole player group defined *Normal* type status values as rewards.

E.g. allows increasing status values through quests.

### Item Rewards

Add items, equipment, currencies, crafting recipes or AI behaviours/rulesets to the player's inventory.

## UI

Define UI related settings for the quest.

### Quest Status Icons

Optionally use different icons for a quest based on it's state.

E.g. display a different icon for unavailable quests or when the quest is active or finished.

### Portraits

Add portraits to quests and display them in menu screens or HUDs.

### Information Overrides

Quests can override the default quest layout, notifications and console texts.

## Quest State

Quests that are added to the player's quests have four different states that determine how they're handled:

- **Inactive**
   The quest is currently inactive and wont have automatic task status changes, requirement updates or display navigation markers - i.e. even if you kill a required enemy or collect a required item, it wont be recognized and update the quest's tasks.
   The quest can only be set active in this state.
- **Active**
   The quest is currently active, automatic task changes and requirements are used and navigation markers are displayed.
   The quest can be set inactive, finished or fail in this state.
- **Finished**
   The quest is finished - no further actions are possible.
   When setting a quest to finished, you will receive the quest's rewards.
- **Failed**
   The quest failed - no further actions are possible.
   When setting a quest to failed, you wont receive the quest's rewards.

# Quest Tasks

Quest tasks are used to break a quest down into smaller parts. They are set up in **Game >****Quest Tasks**.

Quest tasks can track the progress of their requirements, e.g. register when an enemy needed for the task is killed or an item was collected.

## Settings

Define the basic quest task settings, including which quest the task is part of.

### Navigation Markers

Optionally add navigation markers while a quest task is active.

Navigation markers are used by *Navigation* type HUDs to display important positions in the game.

Via set up scene connections (**Game > Scene Connections**) the navigation markers can be used to display a the path to the target scene by marking the position of the scene changers leading to it.

### Quest Text

Quest tasks can update the quest's text.

The quest text can be displayed in menu screens and dialogues.

## Rewards

A quest task can give the player rewards when it's finished.

### Experience Rewards

Gives the player or whole player group defined *Experience* type status values as rewards.

### Normal Status Value Rewards

Gives the player or whole player group defined *Normal* type status values as rewards.

E.g. allows increasing status values through quests.

### Item Rewards

Add items, equipment, currencies, crafting recipes or AI behaviours/rulesets to the player's inventory.

## Activate Requirements

Define the requirements that must be met for a quest task to be active/available. E.g. the task can be made available once a different task has been finished.

If no requirements have been added, the task will be available once its quest has been learned.

Activating and inactivating the quest task can use a schematic.

### Learn Logs

Optionally add log texts when a quest task was activated.

### Finished Tasks

Define quest tasks that need to be finished.

This is tracked automatically, i.e. when a task finishes, it'll automatically be registered in this requirement.

### Items

Requires a defined item and quantity to either be in the player's inventory or be collected.

This is tracked automatically, i.e. when the player collects an item, it'll automatically be registered in this requirement.

### Enemy Kills

Requires the player to kill a defined number of combatants or combatants of a combatant type.

This is tracked automatically, i.e. when the player kills a defined enemy, it'll automatically be registered in this requirement.

### Count

The count requirement can be used for custom requirements.

The count can be changed using schematics and is identified by it's defined tag, i.e. the count matching a defined tag will be changed.

This isn't tracked automatically and has to be changed via schematics.

### Conditions

A quest task can be made available based on valid conditions, e.g. the player's combatant status or variable conditions.

## Finish Requirements

Define the requirements that must be met for this task to be finished. E.g. the task can be finished once a defined quantity of enemies has been killed.

Finishing the quest task can use a schematic.

The individual requirements have the same setup as the *Activate Requirements*. Finish requirements can also learn new log texts when the task was finished.

## Fail Requirements

Define the requirements that must be met for this task to fail. E.g. the task can fail once another task is finished.

Failing the quest task can use a schematic.

The individual requirements have the same setup as the *Activate Requirements*. Failed requirements can also learn new log texts when the task failed.

## UI

Define UI related settings for the quest task.

### Task Status Icons

Optionally use different icons for a quest task based on it's state.

E.g. display a different icon for active or inactive quest tasks.

### Information Overrides

Quest tasks can override console texts.

## Quest Task State

Quest tasks have four different statuses that determine how they're handled:

- **Inactive**
   The task is not yet available - no automatic status changes, requirement updates or navigation marker displays.
   It can only be set active in this state.
- **Active**
   The task is currently active and will do automatic status changes, requirement updates and display navigation markers.
   The task can't be set inactive any more - you can only finish or fail the task.
- **Finished**
   The task is finished - no further actions are possible.
   When setting a task to finished (or it's finished automatically), you will receive the task's rewards.
   Finishing a task can optionally also finish the task's quest.
- **Failed**
   The task failed - no further actions are possible.
   When setting a task to failed (or it failed automatically), you wont receive the task's rewards.
   Failing a task can optionally also fail a task's quest.

# Using Quests

Quests can be added and used in different ways.

## Schematics

Schematics are used to animate your quest interactions, e.g. display dialogues, play animations, etc., as you would for a regular interaction or cutscene.

Schematics can add quests using the *Add Quest* node. There are additional nodes available to change and check the state of quests and quest tasks.

You can display a choice dialogue with a quest's content information using the *Quest Choice* node. Please note that this node only shows the information, accepting the dialogue doesn't add the quest - use the *Add Quest* node for that.

Quests can also be used as selected data using the *Select Quest* node.

## Shops

Shops can sell quests to the player. Buying a quest will add it to the player's quests.

Learn more about shops in [this documentation](https://orkframework.com/guide/documentation/inventory/shops/).

## Research Trees

Research items can add a quest to the player's quest when it's research finished.

Learn more about research trees in [this documentation](https://orkframework.com/guide/documentation/features/research-trees/).

## Conditions

Many condition checks throughout the framework, both in settings and components, offer quest and quest task status checks.
