Arma 3: Firing Drills

This guide will describe how to design and implement a custom Firing Drill Challenge as available in the vanilla game.

See also: Arma 3 Field Manual - Firing Drills (for players) Template:wip

Terminology

• Firing Drill (FD) - a live-fire exercise in which a competitor is graded for tactically moving through a course while engaging a set of targets
• Competitor - the actor performing the drill
• Range Officer (RO) - the actor observing the drill and providing feedback / guidance
• Course of Fire (CoF) - the physical space and layout in which the drill is performed
• Checkpoint (CP) - a navigation point within a course which a competitor must follow in a fixed sequence (if so defined as a rule - see below)
  • The first CP is the start.
  • The last CP is the finish.
  • A strict CP contains shooting boxes (marked areas) from which to fire.
• Target - an artificial object shot to complete a drill or to receive time bonuses
  • Appearing targets appear and disappear based on activation triggers (see below).
  • Accuracy targets contain zones corresponding to extra time bonuses.
  • Moving targets travel on rails between positions.
  • No-shoot targets are not allowed be hit (adding a time penalty).
  • Bonus targets are optional (rewarding a time bonus).
• Rule - these help to determine the completion and scoring conditions for a drill
  • Training rules - a rule-set allowing familiarization of the CoF (targets at CPs do not need to be shot to move on)
  • Competitive rules - a rule-set used for Achievements / Leaderboards (targets at CPs need to be shot to move on)
• Time - the time from the start it takes to complete a drill (raw)
  • Time bonuses / penalties are substracted / added to arrive at the final time.
  • The fastest / lowest time is the best and wins.
  • There are bronze, silver and gold medal times to beat.
  • There may be one special time to beat (typically faster than gold).

Setup

⚠

At time of writing it is not possible to add new Firing Drills as independent (Workshop) scenarios; they need to be added as 'mods' with configuration.

1. Insert a player character named BIS_FD_Competitor // Fixed system name
2. Insert a NPC Range Master character of type B_RangeMaster_F named BIS_rangeOfficer // Fixed system name
3. Insert a Firing Drill module
   1. It's not exposed in Eden Editor, so place any other module. We may change this after this documentation is completed.
   2. Save the scenario.
   3. Close Eden Editor to avoid auto-saves.
   4. Open the scenario SQM file in a text editor.
   5. Replace the module's class by ModuleFiringDrill_F.
   6. Save the SQM.
   7. Re-open the scenario in Eden Editor.
4. Insert an ellipse trigger with default properties named f.e. BIS_FD_COF // Referenced later
   1. Re-size the trigger to encompass your entire CoF and a little extra buffer area (you'll likely re-size it later as you progress).
5. For each CP (including start and finish), insert a trigger with default properties named f.e. BIS_FD_CP1 // Referenced later
   1. Re-size the trigger to meet your CP activation expectations.
6. Insert a Target - Oval (Ground) prop named BIS_FD_ruleSelector1 // Referenced later
   1. Using a similar workflow as above, manually change its class name to Land_Target_Oval_NoPop_F (all targets need their hidden NoPop variant).
   2. Position this target in comfortable shooting range / direction from the start CP (a few meters at most, oriented to be clearly visible and safe).
   3. In the target's Texture #0 field, enter: A3\modules_f_beta\data\FiringDrills\training_gray_ca // Other colors have corresponding textures - see below
7. Copy and paste the first rule target and name it BIS_FD_ruleSelector2 // Referenced later
   1. Position it near the first rule target, typically right from it.
   2. In the target's Texture #0 field, enter: A3\modules_f_beta\data\FiringDrills\competitive_gray_ca // Other colors have corresponding textures - see below
8. Copy and paste a rule target and name it BIS_FD_restartSelector1 // Referenced later
   1. Position it near the finish CP (a few meters from it, oriented to be clearly visible and safe).
   2. In the target's Texture #0 field, enter: A3\modules_f_beta\data\FiringDrills\restart_gray_ca // Other colors have corresponding textures - see below
9. Copy and paste a rule target and name it BIS_FD_quitSelector1 // Referenced later
   1. Position it near the restart target, typically right from it.
   2. In the target's Texture #0 field, enter: A3\modules_f_beta\data\FiringDrills\quit_ca // Fixed texture no matter the drill color
10. For each target at each CP, generally do the following (more specifics detailed below):
    1. Insert the desired target object named f.e. BIS_FD_target2_1 // Referenced later (apply a logical naming pattern, such as numbering based on CP index and target index)
    2. Using a similar workflow as above, manually replace its class name with the corresponding NoPop variant (see the look-up table below).
11. TODO: description.ext
12. Configure your drill via CfgFiringDrills and CfgMissions (see below).

Common Additions

• CP marking objects
  • Recolored objects
• Start whiteboard
• Ammunition containers
• Decorative props / sponsoring

Configuration

CfgFiringDrills

Drill

class MyFirstFiringDrill // This class name must correspond to the missionName (also CfgMissions class)
{
	displayName = "CoF: My First Drill"; // Vanilla drills use a format like this, but it's not enforced
	// This color is used in many places
	// It can be any color, but for best results pick a fully supported color (see section below)
	color[] = { __EVAL(177/255), __EVAL(51/255), __EVAL(57/255), 1 };
	colorName = "red"; // This version of the color is more restrictive and can only use specific supported colors (see section below)
	objectCOF = "BIS_FD_COF"; // The CoF trigger referenced in the setup guide
	// statistic = ""; // Steam stats are not supported for user-generated drills (used for Achievements)
	onReset = "reset.sqf"; // This script is executed each time the drill resets (restarts)
	// leaderboard = ""; // Steam Leaderboards are not supported for user-generated drills
	
	// List any number of objects that you want to be re-colored to the drill color above (f.e. road cones, small flags, etc.)
	recolor[] =
	{
		"BIS_FD_recolor1", 
		"BIS_FD_recolor2"
	};

	// Set up objects that should have special decal textures applied (this was more useful before Eden Editor - see vanilla decals below)
	// In vanilla drills these are often graffiti on wooden shoot house walls
	decals[] =
	{
		{ "BIS_FD_decal1", "A3\Missions_F_Beta\data\img\decals\decal_sidearm1_ca", 5 } // Object reference, texture path, hidden selection index
	};

	// Object references to the 4 special targets for drill mechanics, as defined in the setup guide
	ruleSelectors[] = 
	{
		"BIS_FD_ruleSelector1", 
		"BIS_FD_ruleSelector2"
	};
	restartSelectors[] = { "BIS_FD_restartSelector1" };
	quitSelectors[] = { "BIS_FD_quitSelector1" };
		
	containersWeapons[] = { "BIS_weaponsFD1" }; // All containers that should be filled with the drill weapons
	containersMagazines[] = { "BIS_ammoFD1_1", "BIS_ammoFD1_2", "BIS_ammoFD1_3", "BIS_ammoFD1_4" }; // All containers that should be filled with the drill ammunition
	containersMagazinesCount[] = { 10, 10 }; // The count of magazines of each type in the containers
	weapons[] = { "SMG_02_ACO_F", "hgun_Rook40_F" }; // The legal weapons for this drill
	magazines[] = { "30Rnd_9x21_Mag", "16Rnd_9x21_Mag" }; // The legal magazines for this drill
	weaponsCompetitor[] = { "SMG_02_ACO_F", "hgun_Rook40_F" }; // Starting weapons for the competitor
	magazinesCompetitor[] = {"30Rnd_9x21_Mag", "16Rnd_9x21_Mag"}; // Starting magazines for the competitor
	magazinesCompetitorCount = 6; // The starting magazine count per weapon for the competitor
		
	timesMedals[] = { 60, 45, 30 }; // Bronze, silver, gold medal times (be sure to follow this order or results may glitch)
		
	timeSpecial = 15; // Optional special time that is faster than gold (when defining this, you do need to also provide the data below)
	nameSpecial = "Nemisis"; // Optional special time label for the HUD
	colorSpecial = "#ffa500"; // Optional special time color for the HUD
	iconSpecial = "\A3\Ui_f\data\GUI\Cfg\Ranks\colonel_gs"; // Optional special time icon for the HUD
	
	// Rule-set parameters for competitive and training
	// All vanilla drills use these same settings
	// It is possible to tweak these values, but that will likely create confusion for players!
	class RuleSets 
	{
		// CP mode: 1 - CPs on but targets don't need shooting / 2 - CPs on and all non-optional targets need shooting
		// Target randomization: rule not used - ignored
		// Weapons used: 1 - any weapon can be used everywhere / 2 - CPs may define a required weapon (or incur a time penalty)
		// Shooting boxes: 1 - shooting boxes in CPs are ignored / 2 - shooting boxes in CPs are forced (shooting outside of them incurs a time penalty)
		// Stances used: 1 - any stance can be used everywhere / 2 - CPs may define a required stance (or incur a time penalty)
		// Medals: 0 - medal times are not tracked / 1 - medal times are tracked and feedback is given 
		competitive[] = { 2, 0, 2, 2, 2, 1 };
		training[] = { 1, 2, 1, 1, 1, 0 };
	};
	
	class DynOs {}; // Legacy class used before Eden Editor to load precise object compositions (should not be needed anymore)

	// All of the drill's CPs
	class CheckPoints 
	{
		class CP1 // Start
		{
			object = "BIS_FD_CP1"; // The CP trigger referenced in the setup guide
		};
		class CP2 // CP #1
		{
			object = "BIS_FD_CP2";
		};
		class CP3 // Finish
		{
			object = "BIS_FD_CP3";
		};
	};
};

System

⚠

The system-level configuration could be adjusted by a mod, but consider if that is not going to confuse players who may be trained on vanilla drills.

class CfgFiringDrills
{
	// Below point bonuses and penalties are multiplied by this factor to determine time bonuses and penalties
	pointTimeMultiplier = 0.1;

	bonusWeapon = 1; // Bonus for using the correct weapon at a CP (never awarded - disabled)
	bonusShootingBox = 3; // Bonus for shooting from shooting boxes at a CP (never awarded - disabled)
	bonusStance = 1.5; // Bonus for using the correct stance at a CP (never awarded - disabled)
	penaltyWeapon = 3; // Penalty for engaging using an incorrect weapon at a CP
	penaltyShootingBox = 5; //Penalty for engaging from outside a shooting box at a CP
	penaltyStance = 2; // Penalty for engaging from the incorrect stance at a CP
	penaltyNoShoot = 50; // Penalty for hitting a no-shoot target (so this is 5 seconds)
	penaltyMissed = 25; // Penalty for failing to hit an activated target

	// HUD icons for the medal times
	iconsMedals[] =
	{
		"A3\modules_f_beta\data\FiringDrills\medal_bronze_ca", // Bronze
		"A3\modules_f_beta\data\FiringDrills\medal_silver_ca", // Silver
		"A3\modules_f_beta\data\FiringDrills\medal_gold_ca" // Gold
	};
	// HUD colors for the medal times
	colorsMedals[] =
	{
		"#A0522D", // Bronze
		"#C0C0C0", // Silver
		"#FFD700" // Gold
	};

	// The vanilla configuration defines several common target type profiles
	// This example configures a theoretical new one
	class Targets 
	{
		class MyFirstTarget 
		{
			selectionsHit[] = {"target"}; // All named selections on the model that count as valid hit
			onReset = "myFirstTarget_onReset.sqf"; // Optional script executed when the target is reset
			onActivate = "myFirstTarget_onActivate.sqf"; // Optional script executed when the target is activated
			onDeactivate = "myFirstTarget_onDeactivate.sqf"; // Optional script executed when the target is deactivated
			onHit = "myFirstTarget_onHit.sqf"; // Optional script executed when the target is hit while activated
			downTime = 0.5; // An extra delay in seconds before a valid target hit is registered (i.e. onHit is executed - undefined uses 0)
			noRecolor = 1; // This target is never re-colored by the drill color (mainly applies to optional targets - undefined uses 0)

			// Certain targets over 200 meters away from the competitor will open a Picture-in-Picture camera feed to show hits
			cameraPos[] = {0, -1.5, 0.5}; // Relative camera position from the target center
			cameraTarget[] = {0, 0, 1}; // Relative camera target from the target center
			cameraFOV = 0.4; // Camera Field of View setting (zoom)

			// Accuracy (bonus) hit zones
			class Zones
			{
				class Top
				{
					center[] = {0, 0, 0.5}; //Relative center position of the zone from the target center
					maxDistances[] = //Radii in meters of accuracy rings within this zone
					{
						0.15,
						0.25
					};
					bonuses[] = //Bonuses associated to the rings defined above
					{
						6,
						3
					};
				};
			};

			// In some cases the same target model has several texture variants with different accuracy zones
			// These can be overridden within the same target profile by creating a sub-class of the same class as the specific target itself
			// In that sub-class, define only the relevant class Zones
			// class MyTargetType 
			// {
			// 	class Zones { ... };
			// };
		};
	};
};

CfgMissions

class CfgMissions
{
	// This will expose the drill in the SINGLEPLAYER > CHALLENGES > Firing Drills menu
	class Challenges
	{
		class Firing_Drills
		{
			class MyFirstFiringDrill // This class should correspond to the class in CfgFiringDrills above
			{
				directory = "myfirstfiringdrill.stratis"; // Full path to your drill's scenario folder
				briefingName = "CoF: My First Drill"; // Name of your drill (normally the same as defined in CfgFiringDrills)
				overviewText = "Can you beat my splendid drill?!"; // Overview text of your drill
				overviewPicture = "myfirstfiringdrill_overview_CO.paa"; // Overview picture of your drill
				overviewScript = "\A3\Modules_F_Beta\FiringDrills\scripts\overviewScript.sqf"; // Standard system script to handle the pause menu properly - don't change
				author = "Range Officer Bob"; // You!
			};

			// Alternatively you can list your drill in one of the vanilla color categories: Red, Blue, Orange, Purple
			// class Blue 
			// {
			// 		Define your drill here instead for example
			// };
		};
	};
};

Run-Time Overrides

• TODO: Competitor weapons / magazines

Colors

TODO

Decals

TODO

Tips

• Vanilla CoFs are designed to be somewhat realistic and safe as a non-lethal competitive shooting training / sport. Try to imagine and implement range safety concerns in your target and prop placement. For example, don't place targets in a line of sight of the start, Range Officer, or other spectators. Generally try to solidly block off areas behind targets where possible.