AddStage

Description

This command begins a stage in a mission.

AddStage();

Parameters

This command takes a minimum of 0 parameters and a maximum of 7 parameters.

final

The string final can be specified as any of the first 3 arguments to this command to mark the stage as the final stage of the mission

locked

The string locked followed by car or skin as the second parameter and finally the name of a car or skin respectively as the third parameter will create a locked stage. This type of stage will display a message (specified by the stage's call to SetStageMessageIndex) on completion if the specified conditions are not met.

Other Parameters

In many of Radical's mission scripts, a number is passed as an argument to this command. This number is meaningless.

Examples

Final Stage

A final stage should only be defined during a Story Mission, Street Race or Bonus Mission. It should not be used during a Sunday Drive mission.

Upon completing a final stage, the mission it is apart of will be marked as complete. Stages should not follow a final stage as this may cause unexpected issues

Here's an example of a Final stage with a timer objective wherein upon completing, the mission will be marked as complete.

AddStage("final");
	AddObjective("timer");
		SetDurationTime(1);
	CloseObjective();
CloseStage();

Locked Stage

A locked stage should only be defined in a Sunday Drive mission as it is intended to be followed by a stage with a buycar or a buyskin objective.

A locked stage should always have a dialogue objective.

AddStage("locked","car","homer_v");
	SetStageMessageIndex(0);
	AddObjective("dialogue");
		...
	CloseObjective();
CloseStage();

AddStage();
	AddObjective("buycar", "homer_v");
		// 
	CloseObjective();
CloseStage();

Limitations

Maximum Stages Per Mission

You may only have 25 stages per mission.

Maximum Locked Stage Arguments

You may only have 2 locked arguments (car and outfit) per stage.

More Information

  • A locked stage should only be used on a dialogue objective stage.
  • A locked stage should only be used before a buycar or buyskin objective stage.
Back to top