Take On Helicopters CfgBase

World

Every world is allowed to have one heliport. All settings are placed in CfgBase under classname matching those of CfgWorlds class (and returned value worldName).

class CfgBase { // --- World name (matches CfgWorlds class) class United_States_H { // --- Heliport name (visible in menus) displayName = $STR_HSIM_CfgBase_United_States_H; // --- Script executed every time heliport is loaded init = "\hsim\Modules_H\base\United_States_H\init.sqf"; // --- Starting date of heliport. Every completed mission adds one day initDate[] = {2013,8,5,10,0}; // --- Starting money initMoney = 1985;
// --- Subclasses (see below) class Mission { ... }; class Helicopters { ... }; ...etc... }; };

Following params are shared for Missions, Helicopters (including components), Staff and Upgrades.

• scope
• show
• hide
• enable
• enableText
• displayName
• libTextDesc
• price
• forced

Mission

Includes mission.sqm of heliport mission. Used mainly dor debugging object positions in case the mission was not loaded previously.

class Mission
{
	#include "\hsim\Missions_H\campaign\missions\United_States_H.United_States_H\mission.sqm"
};

Missions

Procedural missions (Contracts).

class Missions { class Visit { // --- Name visible in mission list on heliport displayName = $STR_HSIM_CfgBase_United_States_H_Missions_Visit; // --- List of helicopter classes used as default. One of them is selected randomly. helicoptersDefault[] = {MISSION_HELICOPTERS_LM}; // --- When 1, replaying the mission will still earn player money repeat = 1; // --- faction ID faction = 2; // --- Mission reward price = 15000; // --- Classes of missions required before mission is displayed in menu requiredMissions[] = { US_C_01 }; // --- Helicopter tags required for mission to be enabled in menu requiredHelicopters[] = { {light,medium} }; // --- Helicopter component required for mission to be enabled in menu requiredHelicopterUpgrades[] = { doors }; // --- Company logo displayed in heliport menu overviewLogo = "hsim\ui_h\data\logos\logo_larkin_ca.paa"; }; };

Helicopters

class HeliLight
{
	// --- Helicopter vehicle class (from CfgVehicles) 	vehicle = "Heli_Light01_H";
	// --- Name displayed in heliportmenu 	displayName = $STR_HSIM_CFGVEHICLES_HELI_LIGHT01_BASE_H0;
	// --- Description displayed in heliport menu 	libTextDesc = $STR_HSIM_CFGVEHICLES_HELI_LIGHT01_BASE_ARMORY;
	// --- Purchase price (negative value means amount is removed) 	price = -320000;
	// --- Condition for showing the helicopter in menu (default is "true") 	show = "random 1 > 0.5";
	// --- Condition for enabling the helicopter in menu (it can be visible, but not purchasable) (default is "true") 	enable = "daytime > 12";
	// --- Text displayed in case enable returns false 	enableText = "Helicopters before noon are so ungentlemanlike.";
	// --- When 1, helicopter is added automatically once show and enable conditions are met 	forced = 1;
	// --- Tags 	types[] = {"light"};

	// --- Component category class 	class Exterior
	{
		// --- Category name displayed in menu 		displayName = $STR_HSIM_CfgBase_United_States_H_Helicopters_HeliLight_Exterior;
		// --- Component class 		class Doors
		{
			// --- Component name displayed in menu 			displayName = $STR_HSIM_CfgBase_United_States_H_Helicopters_HeliLight_Exterior_Doors;
			// --- Component description displayed in menu 			libTextDesc = $STR_HSIM_CfgBase_United_States_H_Helicopters_HeliLight_Exterior_Doors_desc;
			// --- Model selections which component enables 			components[] = {"AddDoors"};
			// --- Component purchase price 			price = -1000;
			// --- Tags which component enables 			types[] = {"doors"};
			// --- Weight added to total helicopter weight 			weight = 10;
		};
	};

	class Init 
	{
		displayName = "Init";
		// --- Private scope - category is not displayed in menu 		scope = 1;
				
		class CargoHook
		{
			displayName = $STR_HSIM_CfgBase_United_States_H_Helicopters_HeliHeavy_Exterior_CargoHook;
			libTextDesc = $STR_HSIM_CfgBase_United_States_H_Helicopters_HeliHeavy_Exterior_CargoHook;
			components[] = {};
			// --- Component is added automatically 			forced = 1;
			// --- Condition for removing the component from owned ones 			hide = "myCounter > 42";
			types[] = {"cargoHook"};
		};
	};
};

Component tags are unique, only on of the can be enabled at the same time. That means that if two component has for example tag "camera", enabling one of them will disable the other one. Only tags defined in class Tags are displayed in requirements, which mean you can use virtual tags to handle correct technical exclusion

Example: class Benches { types[] = {"benches","posSide"}; }; class Camera { types[] = {"camera","posSide","posFrame"}; }; benches and camera are defined in class Tags and are displayed in mission requirements. However, posSide is virtual tag and makes sure that camera cannot be enabled at the same time as benches (as both occupy similar position).

Tags

Every helicopter or component is marked with tags, and missions can require helicopters or components with such tags to be owned by player before they can be played. Otherwise "Show Requirements" button is active instead of "Play" in heliport mission selection. Clicking on the button will display tag descriptions defined in this class.

class Tags { class Light { // --- Name visible in 'Show Requirements' message box displayName = $STR_HSIM_CfgBase_United_States_H_tags_Light; }; };

Factions

Factions serves as mission categories (e.g. Story, Government, Tutorials, ...). class Factions { class CORE { // --- Name visible in Contracts menu displayName = $STR_HSIM_CfgBase_United_States_H_Factions_CORE; // --- Unique faction id, used for mission categoriting (see Missions) id = 0; // --- Listbox icon image = "hsim\ui_h\data\igui_sidebriefing_civil_ca.paa"; }; };

Staff

TBA

Upgrades

Heliport upgrades are compositions placed on heliport itself, like hangar, tools, tables etc. However, it can also include environment objects further away from heliport, like cargo ship wreck.

class Hangars
{
	displayName = "Hangars";
	class Hangar_default
 	{
		displayName = "Default Hangar";
		libTextDesc = "Larkin Aviation offices";
		// --- Composition class from CfgObjectCompositions 		composition = "heliport_hangarDefault";
		// --- Composition position 		positions[] = {"hangar00"};
		forced = 1;
	};
};

NoFlyZones

No-fly zones created automatically by BIS_fnc_noFlyZonesCreate. class Factions { class P51 { // --- Zone position position[] = {2018.7,45494.7,0}; // --- Zone area (matches triggerArea format)) area[] = {4500,3000,90,1}; // --- Zone type (see below) type = 2; }; };

Zone types (simplified representation of airspace classes):

• 0 - Airport (Class D Airspace)
• 1 - International Airport (Class B Airspace)
• 2 - Restricted zone