CfgMissions: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "y[ _]*\|[ _]*(arma[0-9]+)[ _]*\|[ _]+" to "y|$1|")
m (Text replacement - "\[\[ *Armed Assault *\]\]" to "{{arma1}}")
Line 72: Line 72:
| Singleplayer missions. Menu name can vary in different projects:
| Singleplayer missions. Menu name can vary in different projects:
* [[Arma: Cold War Assault]]: Singleplayer
* [[Arma: Cold War Assault]]: Singleplayer
* [[Armed Assault]]: Missions
* [[:Category:ArmA: Armed Assault|{{arma1}}]]: Missions
* [[{{arma2}}]]: Scenarios
* [[{{arma2}}]]: Scenarios
* [[Take On Helicopters]]: Challenges
* [[Take On Helicopters]]: Challenges

Revision as of 01:29, 20 July 2021

CfgMissions contains list of all playable content available for players in ingame menus. It is core of missions exported in Addon Format.

Classes

Introduced in Param name Description
Logo A1 black.png1.00

Campaigns

Regular campaigns. For information on how to configure the campaigns themselves, please see the Campaign Description.ext page.
class Campaigns
{
	class Bootcamp
	{
		directory = "A3\Missions_F_Bootcamp\Campaign";
		filterGroup = 3;	// Only bootcamp campaign will be listed in Campaign dialogue invoked by Bootcamp button.
		// include the campaign description.ext to make its content re-usable outside of the campaign
		#include "\A3\Missions_F_Bootcamp\Campaign\description.ext"
	};
};
Arma 3 logo black.png1.00

Episodic Campaigns

Arma 3 has introduced the ability to configure episodic campaigns, as seen with the official The East Wind campaign.

Upon expanding the main tree, you will see all available episodes which, when expanded as well, function as a regular campaign.
For information on how to configure the campaigns themselves, please see the Campaign Description.ext page.

class Campaigns
{
	class RootCampaign
	{
		// Each of these definitions are applied to the root campaign
		briefingname = $STR_A3_CampaignName;
		overviewText = $STR_A3_CampaignOverview;
		author = $STR_A3_Bohemia_Interactive;
		overviewPicture = "a3\Missions_F_EPA\data\img\Campaign_overview_CA.paa";
		// Classes of episodes included
		campaigns[] = { StageA, StageB, StageC };
		class StageA
		{
			directory = "A3\Missions_F_EPA\Campaign";
			// include the campaign description.ext to make it is content re-usable outside of the campaign
			#include "\A3\Missions_F_EPA\Campaign\description.ext"
		};
		class StageB
		{
			directory = "A3\Missions_F_EPA\CampaignDummy";
		};
		class StageC
		{
			directory = "A3\Missions_F_EPA\CampaignDummy2";
		};
	};
};
Logo A1 black.png1.00

Missions

Singleplayer missions. Menu name can vary in different projects:
class Missions
{
	class SP_WarWelcome
	{
		directory = "ca\missions\Scenarios\SP_WarWelcome.utes";
	};
};

You can also group your missions into subfolders

class Missions
{
	class PMC_Missions
	{
		//--- Subfolder name
		displayName="$STR_pmc_scenarios_name";
		//--- Subfolder overview
		overview="ca\missions2_pmc\overview.html";
		//--- List of missions
		class SPP01_PMC
		{
			directory = "ca\missions2_pmc\scenarios\SPP03.ProvingGrounds_PMC";
		};
	};
};
Logo A1 black.png1.00

Tutorial

Tutorial scenarios. Structure same as Missions.
tkoh logo small.png1.00

TimeTrials

Time Trial scenarios. Structure same as Missions.
Logo A1 black.png1.00

MPMissions

Multiplayer missions. Structure same as Missions.
class CfgMissions
{
	class MPMissions
	{
		//--- ZEUS
		class MP_ZGM_m14 // class name MUST match the name in the 'directory' path
		{
			briefingName = $STR_A3_MasterTanoa_missionName;
			directory = "A3\missions_f_exp\mpscenarios\mp_zgm_m14.Tanoa"; // <--- match
		};
	};
};
Logo A1 black.png1.00

Templates

Singleplayer templates. Accessable through <My Missions> in SP missions list.
class Templates
{
	class ST_BasicEast
	{
		directory = "ca\missions\Templates\Basic.East";
	};
};
Logo A1 black.png1.00

MPTemplates

Multiplayer templates. Accessable through <My Missions> in MP missions list.
Logo A1 black.png1.00

Procedural

Procedural missions. Exclusive for Armory.


Params

Following params works for all mission/campaign classes placed in parent classes listed above.

Introduced in Param name Type Description Compatibility
Logo A1 black.png1.00

directory

String
  • Missions - path to mission folder (where mission.sqm is placed)
  • Campaigns - path to folder where campaign description.ext is placed
directory = "ca\missions\Scenarios\SP_WarWelcome.utes";
N/A
tkoh logo small.png1.00

briefingName

String Mission name overriding name set in Intel menu. Not in Campaigns
tkoh logo small.png1.00

overviewText

String Custom overview description Not in MPMissions and MPTemplates
tkoh logo small.png1.00

overviewPicture

String Path to custom overview picture Not in MPMissions and MPTemplates
tkoh logo small.png1.00

author

String Content Authorship signature Not in MPMissions and MPTemplates

You can also put any Description.ext param in mission class.


Examples

Arma 2: Operation Arrowhead Missions
For simplicity, every parent class contains only one mission example
class CfgMissions
{
	class Missions
	{
		class SP_Benchmark //03
		{
			directory = "ca\missions_e\scenarios\SPE1_Benchmark1.takistan";
		};
	};
	class MPMissions
	{
		class MPE_HikeInTheHills
		{
			directory = "ca\missions_e\MPScenarios\MPE1_HikeInTheHills.Takistan";
		};
	};
	class MPTemplates
	{
		class MTE_Deathmatch
		{
			directory = "ca\missions_e\MPTemplates\MPTE_Deathmatch";
		}
	};
	class Templates
	{
		class ST_BasicEast
		{
			directory = "ca\missions_e\Templates\Basic.East";
		};
	};
	class Campaigns
	{
		class Arrowhead
		{
				directory = "ca\missions_e\campaign";
		};
	};
	class Tutorial
	{
		class TE01
		{
			directory = "ca\missions_e\Bootcamp\TE01_Basic_controls.Zargabad";
		};
	};
	class Procedural
	{
		class Armory
		{
			onLoadMission = $STR_LIB_ONLOAD;
			debriefing = 0;
			playerKilledScript = "\ca\missions\armory\data\scripts\respawn.sqf";
			onPauseScript = "\ca\missions\armory\data\scripts\pauseOnload.sqf";
			onCheat = "[_this] call LIB_onCheatFunction";
		};
	};
};
Arma 2: Private Military Company Missions
class CfgMissions
{
	class Missions
	{
		class PMC_Missions
		{
			displayName="$STR_pmc_scenarios_name";
			overview="ca\missions2_pmc\overview.html";
			class SPP01_PMC
			{
				directory = "ca\missions2_pmc\scenarios\SPP03.ProvingGrounds_PMC";
			};
			class SPP02_PMC
			{
				directory = "ca\missions2_pmc\scenarios\SPP02.ProvingGrounds_PMC";
			};
			class SPP03_PMC
			{
				directory = "ca\missions2_pmc\scenarios\SPP01.Takistan";
			};
			class SPPXX_PMC
			{
				directory = "ca\missions2_pmc\scenarios\SPP00.Zargabad";
			};
		};
	};
	class Templates
	{
		class SupplyDrop
		{
			directory = "ca\missions2_PMC\Templates\SupplyDrop.West";
		};
	};
};
Arma 3 Missions
class CfgMissions
{
	// Campaigns
	class Campaigns
	{
		class RootCampaign
		{
			// Each of these definitions are applied to the root campaign
			briefingname = $STR_A3_CampaignName;
			overviewText = $STR_A3_CampaignOverview;
			author = $STR_A3_Bohemia_Interactive;
			overviewPicture = "a3\Missions_F_EPA\data\img\Campaign_overview_CA.paa";
			// Classes of episodes included
			campaigns[] = {StageA, StageB, StageC};
			class StageA
			{
				directory = "A3\Missions_F_EPA\Campaign";	
				// include the campaign description.ext to make it is content re-usable outside of the campaign
				#include "\A3\Missions_F_EPA\Campaign\description.ext"
			};
			class StageB
			{
				directory = "A3\Missions_F_EPA\CampaignDummy";
			};
			class StageC
			{
				directory = "A3\Missions_F_EPA\CampaignDummy2";
			};
		};
	};
	// Showcase missions
	class Showcases
	{
		displayName = $STR_A3_CFGMISSIONS_SHOWCASES0;
		briefingName = $STR_A3_CFGMISSIONS_SHOWCASES0;
		author = $STR_A3_Bohemia_Interactive;
		overviewPicture = "a3\Missions_F_Beta\data\img\Campaign_overview_CA.paa";
		overviewText = $STR_A3_CFGMISSIONS_SHOWCASES0;
		class Showcase_Combined_arms
		{
			briefingName = $STR_A3_Showcase_Combined_Arms_Mission_Name;
			directory = "a3\Missions_F_Beta\Showcases\Showcase_Combined_arms.Stratis";
		};
	};
	// Multiplayer missions
	class MPMissions
	{
		class MP_COOP_m01
		{
			briefingName="@STR_A3_MP_COOP_m01_briefingName";
			directory = "A3\missions_f\mpscenarios\MP_COOP_m01.Stratis";
		};
	};
	// Challenges
	class Challenges
	{
		briefingName = $STR_A3_CHALLENGES_NAME;
		overviewText = $STR_A3_CHALLENGES_OVERVIEW;
		overviewPicture = "\a3\Missions_F_Beta\data\img\Challenges_overview_CA.paa";
		// Firing Drills
		author = $STR_A3_Bohemia_Interactive;
		class Firing_Drills
		{
			briefingName = $STR_A3_FIRING_DRILLS_NAME;
			overviewText = $STR_A3_FIRING_DRILLS_OVERVIEW;
			overviewPicture = "\a3\Missions_F_Beta\data\img\FiringDrills_overview_CA.paa";
			author = $STR_A3_Bohemia_Interactive;
			class SP_FD04 // Green
			{
				directory = "a3\Missions_F_Beta\Challenges\firing_drills\sp_fd04.stratis";
				briefingName = $STR_A3_FIRING_DRILLS_SP_FD04_NAME;
				overviewText = $STR_A3_FIRING_DRILLS_SP_FD04_OVERVIEW;
				overviewPicture = "\a3\Missions_F_Beta\data\img\SP_FD04_overview_CA.paa";
				author = $STR_A3_Bohemia_Interactive;
			};
		};
	};
};