Skip to content
OpenTS Manual

Scenario

The mission a campaign opens with, or the mission number from which a music track may be picked.

Campaign opening mission

Specification — Campaign opening mission
Applies to
Campaign
File
BATTLE*.INI
Section
[<Campaign ID>]
Value
string
When omitted
(empty)An empty name, which starts nothing.

The value is the map file of the campaign’s first mission. Choosing the campaign from the mission list starts that file. Write the path with its extension, as the shipped campaigns do with Maps/Missions/GDI1A.MAP.

If the file cannot be read, the game shows an error message and returns to the menu. An empty value fails the same way.

Only the first mission is named here. Choosing the next mission covers how each won mission leads to the next, through the map selection screen or the mission’s NextScenario. Campaign progression covers the whole sequence and the state carried between missions.

When the campaign’s CD is above 1, this value also decides its loading-screen artwork; see CD.

Track unlock level

Specification — Track unlock level
Applies to
Themes
File
THEME.INI + THEME01.INI
Section
[<Theme ID>]
Value
integer
When omitted
0

Scenario= holds the music track back until a single-player game reaches this campaign level number. The track is allowed once the number is equal to or higher than the value. The number is 1 when the game starts and goes up by one with each campaign mission won, so Scenario=3 allows the track from the third mission of the first campaign played after the game starts. A campaign started later in the same run can begin with a higher number and allow the track sooner.

theme.ini
[VALVES1B]
Name=Valves
Length=3.27
Scenario=1

A track held back is missing from the automatic playlist and from the sound options track list, and the next track and previous track commands skip it. Other ways of starting the track, listed under Normal, still play it.

Skirmish and multiplayer games skip the test, so this key holds back no track there.

This key means different things in its two scopes. In a campaign’s section of battle.ini it names the map the campaign opens with. In a music track’s section of theme.ini it is the campaign level number a single-player game must reach before the track can play.

See also — CD, Description, FinalMovie, NextScenario, Normal, Side