Objective System

An objective is a high-level game mission represented by a hierarchy of different components:

Objectives
    Objective 1
        Step 0
            Task 0.1
            Task 0.2
            Verifications
                Infrastructure Request 1
                Required Resorces
        Step 1
            Task 1.1
            Task 1.2
        ...
    Objective 2
        ...
    ...
---------------------------------------------
Infrastructure Requests
    Infrastructure Request 1
        Piping 1
    Infrastructure Request 2
     ...
---------------------------------------------
Pipings
    Piping 1
    Piping 2
    ...

Navigating and Troubleshooting

Use Find in project to navigate the objectives / infrastructure requests lists.

Use Links Validator to ensure that all cross-links in objectives and infrastructure requests are valid.

Use Debug UI to test your objectives.

Term

Description

Objective

A high-level mission that consists of smaller steps.

Step

Steps are the objective stages that should be completed consecutively, for example:

  1. Find and deliver Object 1.
  2. Collect additional resources.
  3. Build something that requires Object 1 and collected resources.

Steps consist of tasks and/or verifications.

Task

Task is the smallest unit of the objective system. Tasks within the same step can be completed in any order.
There are several types of tasks: go to the location, find an object, bring an object to the location, and so on.

Warning

Every task must have a corresponding TaskBasedVerification, otherwise, the task completion would not be tracked.

Verification

Verification is used to check the state of game events or the player's inventory, for example:

  • Has the task been completed?
  • Has an Infrastructure Request been completed?
  • Does the player have enough of some resource?

Infrastructure Request

Special request to fix something: conduct electricity, build a road, fix the piping.

Warning

Every task must have a corresponding Verification, otherwise, the request completion will not be tracked.

Actions

Actions can be triggered:

  • on start of an objective,
  • on finish of a step,
  • as a reward.

Examples: give money to the player, spawn a truck, unlock a bridge.

Rewards

XP, money, resources that the player can get for completing a step or an objective.