Opens via Editors › Mission Goals.
Defines the goals shown to the player at the end of the briefing and tracked on the HUD during the mission. When a goal is completed or failed a HUD popup notifies the player. Goals are hidden during the briefing if the Toggle Showing Goals In Briefing flag is set in Mission Specs.
Goal type is a classification that affects how goals are displayed and which music
plays on completion or failure. The actual consequences of a goal being met or failed
, which debriefing stage the player sees, whether the campaign advances, are
determined by SEXPs in the
Debriefing Editor and the
Campaign Editor, which can query goal state
using operators like goal-true and goal-false.
| Type | Description |
|---|---|
| Primary | Shown to the player from the start of the mission. Completion or failure triggers the primary goal music stinger. By convention these are the core objectives designers tie campaign progression and debriefing outcomes to. |
| Secondary | Shown to the player from the start of the mission. Completion or failure triggers the secondary goal music stinger. Designers typically use these for optional objectives whose state is queried in the debriefing or campaign for bonus outcomes. |
| Bonus | Hidden from the player until the goal is achieved, at which point the goal text appears on the HUD. Their state is queryable by SEXPs the same as any other goal type. |
The main area displays all goals as SEXP trees. The dropdown at the top filters the list to show one type at a time; Primary, Secondary, or Bonus. Use New Obj. to append a new goal of the currently filtered type.
| Field | Description |
|---|---|
| Type | Primary, Secondary, or Bonus. Changing this moves the goal into the corresponding type group. |
| Name | Internal identifier used in SEXPs such as
goal-true and goal-false, and in mission log
entries. Not shown to the player. |
| Goal text | Text displayed to the player in the briefing goal list and HUD objective display. |
| Score | Points awarded when this goal is completed. |
| Team | In multiplayer missions, the team this goal belongs to. |
| Flag | Description |
|---|---|
| Objective Invalid | Marks the goal as invalid from the start of the mission. Invalid goals are not shown to the player and are not evaluated. Goals can also be marked valid or invalid at runtime by SEXPs, making this useful for goals that are conditionally activated during play. |
| Don't Play Completion Music | Suppresses the event music stinger that normally plays when this goal is completed or failed. |