A quest objective is an action you must take in order to make progress toward completing a quest.
All objectives are written under the
objectives property in QuestScript, and each objective must be preceded by a
-. Here are some formatting examples:
objectives: - kill Cow - kill 3 Chicken - kill 5 "Mangy Wolf"
❌ Not OK
objectives: - kill Cow # not indented far enough -kill 3 Chicken # no space after dash - kill 5 "Mangy Wolf" # indented too far
Each objective supports a "shorthand" format, which lets you quickly write an objective with only the most basic parameters in a single line. The parameters supported by the shorthand form are different for each objective.
For example, let's break down the shorthand form of the
objectives: - kill 5 "Mangy Wolf"
When compiled into a quest, this line gets broken apart into the following properties:
- objective: kill
- goal: 5 (optional, number of times this objective must be performed)
- target: "Mangy Wolf" (name of the monster which must be killed)
Note that multi-word phrases like "Mangy Wolf" must be written with quotes in order to be recognized as a single parameter value in the shorthand form. For single-word phrases, quotes are optional.
The help page for each objective (linked below) will outline the parameters supported by that objective's shorthand form.
If you want to access the full set of parameters for an objective, you can write it out in its complete form, where each parameter of the objective is defined explicitly. For example, the last example would be written in long-form as:
objectives: - kill: goal: 5 target: Mangy Wolf
List of objectives
You can view a list of all currently supported quest objectives at Category:Quest Objectives.