Models processes that have an objective with a defined achievement.

Derived classes implement the ways how the achievements can be realized.

1. GOAL constructor

• GOAL.New(): Creates a new GOAL object.

2. GOAL is a finite state machine (FSM).

2.1. GOAL States

• Pending: The goal object is in progress.
• Achieved: The goal objective is Achieved.

2.2. GOAL Events

• Achieved: Set the goal objective to Achieved.

3. Player contributions.

Goals are most of the time achieved by players. These player achievements can be registered as part of the goal achievement. Use GOAL.AddPlayerContribution() to add a player contribution to the goal. The player contributions are based on a points system, an internal counter per player. So once the goal has been achieved, the player contributions can be queried using GOAL.GetPlayerContributions(), that retrieves all contributions done by the players. For one player, the contribution can be queried using GOAL.GetPlayerContribution(). The total amount of player contributions can be queried using GOAL.GetTotalContributions().

4. Goal achievement.

Once the goal is achieved, the mission designer will need to trigger the goal achievement using the Achieved event. The underlying 2 examples will achieve the goals for the Goal object:

  Goal:Achieved() -- Achieve the goal immediately.
  Goal:__Achieved( 30 ) -- Achieve the goal within 30 seconds.

5. Check goal achievement.

The method GOAL.IsAchieved() will return true if the goal is achieved (the trigger Achieved was executed). You can use this method to check asynchronously if a goal has been achieved, for example using a scheduler.