View source for Instructions for using the Mission Editor / Tank Missions

__TOC__

= Creating the mission =

== Basics ==

Open the Mission Editor and when the location selection window appears select the avg_hurtgen map, all map names that start with '''avg''' are made mainly for tanks and ground battles. 
<br/>After that the tab to Mission Editor which is located near the top left corner of the mission editor window, the bar under it should update itself and new icons that are available for the mission editor appear. 
<br/>On the right side of screen there should be a '''Properties''' window, if it is not there then press the '''Properties and Trigger/MissionObj info''' icon which is located at the end of the most bottom bar (if your screen width resolution is lower than 1,400 pixels you won't be able to see it, 
<br/>but you can just press this tab using your middle mouse button and while holding it drag it to the left).
<br/ >First and the most important part of making the mission is giving it a proper name, location and type in the '''Properties''' window.
<br/>
:1. Go to Properties → Mission Settings → mission
:2. Set the '''locName''' to the mission name that you want to appear in the game later
:* LocName is a name that is shown in the '''User Missions''' tab in game, you can use spaces.
:3. Set the '''locDesc''' to the mission description that you want to appear in game later
:* locDesc is a description that is shown in the User Missions tab in game after selecting the mission.
:4. Set the '''type''' to '''singleMission'''
:* '''Type''' set to singleMission makes it so the custom mission is able to appear in the '''User Missions''' window in game.
:5. Set the '''level' to '''level/avg_hurtgen'''
:* It is important to set the '''level''' to the same map that you set at the start in the location selection window, otherwise some not intended things can happen like units appearing at wrong position etc.
:* There is another way of adding a mission name and description, it is possible by creating a special CSV file which stores all text that will be shown during the mission and since it will be needed later you should create one.
:1. Save your mission in the '''Mission Editor''' (it is located in the most top bar) → '''Save mission'''
:2. Sets it name to for example '''tank_battle.blk'''
:* Remember to set its extension to '''.blk''' because it is the format that the game can read, otherwise your mission won't be visible in game.
:3. Save it in '''WarThunder/userMissions''' directory
:* If the '''userMissions''' folder isn't there in your folder with installed War Thunder then create it.
:4. Go to the location where you saved your mission file and then open it
:5. Find mission{ block and paste this line under it so it looks like on the screenshot to the right [[File:Name mission file.JPG|250px|thumb|right]]
 name:t="hurtgen_forest_battle"
:* This line is used to assign the CSV file to your mission
:6. Create a new text file with the '''.csv''' extension and set its name to usr_yourMissionName.csv
:* More information about CSV files you can find [[CSV files for missions|here]]

<br/>Important note: Remember to regularly save your mission, sometimes the Mission Editor can crash itself and you will lose all your work (there is an autosave function which makes a copy of your mission but it can also fail to do it, although it should not).
<br/>

== Weather settings ==

The Mission Editor allows you to change time in your mission and other settings like weather - how many clouds appear over the map, 
wind - can affect planes and some effects like smoke and clouds (doesn't affect bullets), 
there are also settings that control the temperature and air pressure (it can affect the shell's ballistic and planes).
<br/>
:1. Go to Properties → Mission Settings → mission
:2. Press '''atmosphere''' which is located at the top, you can change the temperature and air pressure there
:* Default values are used in multiplayer in random Ground Forces battles.
:3. Go to Properties → Mission Settings → mission → weather params
:: You can set the wind, time and the amount of clouds there.
:* '''environment''': Controls mission time
:* '''weather''': Controls mission's weather
:* By default every time when you load the mission it will generate new clouds position based on current setting, to prevent that you need to set two options:
:* '''forceSkiesInitialRandomSeed''': If checked will make it so the clouds position will never change after reloading the mission
:* '''skiesInitialRandomSeed''': Sets the random clouds position, clouds that you can see in the mission editor will appear at the same position in game
:* '''stars''': Controls stars position, useful only in night missions
:* '''windSpeed''': Sets the wind speed (in meters per second)
:* '''windDirection''': Sets the wind direction (in degrees)
<br/>
== Other settings ==

If you want your mission to be played only on specific difficulty settings then you can set some options to make it playable for example with realistic battles difficulty only.
<br/>
:1. Go to Properties → Mission Settings → mission → Common params
:* Two first options don't do anything in missions for tanks, they were intended for use with planes only.
:* '''openDifLevels''' - If left unchecked (must be selected in order to add this line to the mission) makes it so the mission difficulty can't be adjusted in the mission's options selection screen
:2. Go to Properties → Mission Settings → mission → Singleplayer params
:3. Press the '''difficulty''' tab, after that it will be possible to select one of in game difficulties
:* It is possible to use custom difficulty settings by adding the netDifficultyBlk script, its functionality is explained [[Multiplayer mission creation#Enabling custom difficulty|here]], some options from it are not available in the in game Custom Difficulty window.

:* '''campaign''' - Controls under which tab your mission will be shown in User Missions window in game
:* It is possible to create your own tab in CSV files, but you will need to edit your mission manually and it is explained [[CSV files for missions|here]]
<br/>
== Creating the player's unit ==

First part is to create a new unit:
<br/>
:1. Press '''Create unit''' icon [[File:MissionEditor CreateUnitIcon Wiki.jpg]] which is located on the most bottom bar  
:2. Hover your cursor over the window which shows currently selected map, you should see a white dot on the ground, then press the ground somewhere on the map
:3. Your unit should be selected now, if yes then press the '''Drop object''' icon [[File:MissionEditor DropObjectIcon Wiki.jpg]] on the most bottom bar, it should put your unit on the ground
:* You can change the unit's position by selecting your unit and then pressing '''Ctrl + Alt + W''' buttons, after that there should appear three arrows, by pressing one of them and moving while holding it you can move your unit. It also can be done by pressing '''Move over surface''' icon [[File:MissionEditor MoveOverSurfaceIcon Wiki.jpg]] which is located on the most bottom bar. [[File:Mission editor moving units.JPG|250px|thumb|right]] There is a second method of moving units, instead of using an arrow point the cursor at the corner of the square shown to the right, then when its color turns to yellow click on it and just simply move your unit while holding the left mouse button.
[[File:Pressed icons.jpg|250px|thumb|right]] 
:* When you notice that moving units is not precise and it is being done in 100 meter steps then make sure that icons shown to the right are not pressed. 
:* It is also possible to rotate units, all you need to do is just to press '''E''' to switch to rotate mode, two circles should appear, rotating works like moving units, it is done by pressing the circle and moving the cursor while holding the left mouse button. It also can be done by pressing '''Rotate''' icon [[File:MissionEditor RotateIcon Wiki.jpg]] which is located on the most bottom bar.
:* Red line shows the unit's direction.
:4. While your unit is still selected press '''P''' button to show the 'Object properties' window
:* Here you can select your unit's type, class and other settings.
:* Remember that a player's unit needs to be something that is already bought, it is not possible to play not researched vehicles. It is possible to use custom user made models.
:5. Set your unit's class to for example the '''germ_pzkpfw_II_ausf_F''' and its name to '''player_unit'''
:6. In the '''Properties''' window scroll down to '''Weapons & Bullets''' tab, then press it
:* '''Weapons & Bullets''' tab allows you to give the player's unit specific ammo and change the amount of carried ammunition.
:7. Change the '''bullet 0''' to '''20mm_ger_kwk30_APCR''' and then set the '''Bullets Count 0''' to 180
:8. Open the '''Modifications''' tab and then in the first two tabs select '''tank_tool_kit''' and '''manual_extinguisher'''
:* By default the FPE and Parts modifications are disabled, you have to enable them manually every time, it is also the same with modifications like the '''NVD''' or '''Laser rangefinder''', overall everything that is not a performance modification (Tracks, Engine etc.).

<br/>Second part is to assign this unit as a player's unit:
<br/>
:1. Go to Properties → Mission Settings → mission → player_teamA
:* Here you can select which unit will be used by the player
:2. Press 'Wing' and then select that tank which you added before, in this case it should be '''player_unit'''

<br/>If you have done everything correctly so far then at this point your mission should work without any issues and you should be able to drive around the map.
<br/>

== Creating the spawn zone ==

This part will explain everything related to spawning in single player missions.

<br/>The first method of spawning at the start of the mission is to simply add your unit on the map, what was explained above.
<br/>The second method is to create a zone and use it as a spawn at the beginning of the mission.
:1. Press the '''Create sphere zone''' icon [[File:MissionEditor SphereZoneIcon Wiki.jpg]] which is located on the most bottom bar
:2. Create a new zone by clicking on the ground and dragging it while you hold left mouse button, by doing that it is possible to change its size
:3. After creating it set its name to '''spawn_zone''' 
:4. Create a new trigger in Properties → Trigger / Mission Obj. Navigation window by pressing '''Trigger''' button
:5. Change the trigger name to '''mission_start''', press '''periodicEvent''' and then press a big, wide bar with the same name and at the bottom and switch it to '''initMission'''
:* It needs to be done this way if you want the player's unit spawn right after launching the mission.
:6. Create a new action by pressing '''Action''' button, find one that is called '''unitRespawn''' and select it
:7. Set the '''object''' to player's unit, in this case it should be '''player_unit''', then select '''spawn_zone''' as the '''target'''
:* Now the game should spawn the player's unit at the '''spawn_zone''' after launching it.

<br/>By default after player's death it will be possible to respawn the vehicle three times at the same position, it can be changed, all you need to do is go to Properties → Mission Settings → mission → Singleplayer params and then press '''restoreType'''.
This option controls respawn during the mission, when set to the first option '''attempts''' it will work like explained before, it's a default setting, the amount of attempts can be changed in the '''missionAttempts''' action. '''Tactical control''' uses bots from the same unit as a replacement of player's unit after death, 
basically after you run out of units from your unit you won't be able to spawn anymore. The third option, '''manual''' lets you spawn the player's unit manually using the method above.

== Creating waypoints ==

Compared to missions for planes it is slightly harder to add waypoints, because that action which is used for flying units does not look so nice on the ground, it is needed to add them manually instead by adding an effect on the ground and then an icon on the map.

<br/>To create waypoints you have to add a custom effect first:
:1. Create a new sphere zone (area), put on on the road and change its name to '''waypoint_01''', then copy it and change its name to '''waypoint_02''' and move it 300 m further
:* You can make a copy of existing units by switching to '''Move''' (W button), '''Move over surface''' (Ctrl + Alt + W buttons), or '''Rotate''' (E button) mode and then pressing arrows or circles around the unit while holding '''shift''' button.
:2. Create a new trigger and change its name to '''waypoint_01'''
:3. Add '''unitPlayEffect''' action in this new trigger
:* It will be used to show a waypoint on the ground
:4. Set its target to the '''sphere zone''' that you created, in this case it should be '''waypoint_01'''
:5. Make sure that the '''effect_type''' is set to '''specific'''
:6. Type '''waypoint_ground''' under '''effect'''
:* It is an effect that will be visible in game, an arrow pointing at the ground with a circle under it.
:7. Make sure that '''show''', '''attach''' and '''mustExist''' are checked
<br/>The next part is creating an icon that will be visible on the map:
:8. Add '''missionShowMapIcon''' action in '''waypoint_01''' trigger
:9. Check the first option called '''show'''
:10. Paste '''ui/gameuiskin#radar_object_waypoint''' to tab under the '''iconName'''
:* This icon is a simple yellow circle, normally it is used by '''missionMarkAsWaypoint''' action
:11. Select the first waypoint (waypoint_01) in the tab next to the '''areaName'''
[[File:Waypoint 01 trigger.JPG|350px|thumb|right|Waypoints trigger]]
<br/>Adding more waypoints:
:1. Create a new trigger and change its name to '''waypoint_02'''
:2. At the top unmark the '''Enabled''' option
:* Prevents the trigger from performing its actions right after mission start
:3. Add a new condition - '''unitWhenInArea'''
:4. Click on it and set the '''object''' to '''player_unit''' and the '''target''' to '''waypoint_01'''
:* Makes it so the trigger will be activated only after reaching '''waypoint_01''' area
:5. Copy '''unitPlayEffect''' and '''missionShowMapIcon''' action from the previous trigger by using '''Copy''' and then '''Paste ...''' buttons which are located at the bottom of '''Trigger / Mission Obj. Info''' window under '''elements:'''
:* To copy them you have to click on the action, then press the '''Copy''' button, then do the same with the other action. After that click on '''waypoint_02''' trigger and press '''Paste ...''', in that new window switch '''Paste action:''' from '''Paste current''' to '''Paste all''' and press '''Ok'''.
:6. Click on '''unitPlayEffect''' in '''waypoint_02''' trigger and uncheck '''show''', '''attach''', '''mustExist'''
:7. Click on '''missionShowMapIcon''' in '''waypoint_02''' trigger and uncheck '''show'''
:* Makes existing effect and icon from the first waypoint disappear.
<br/>Adding a new effect and icon for the next waypoint:
:8. Paste both actions to the '''waypoint_02''' trigger again
:9. Change the '''areaName''' to '''waypoint_02''' in '''missionShowMapIcon''' action and the '''target''' to '''waypoint_02''' in '''unitPlayEffect''' action
:10. Go back to the previous trigger ('''waypoint_01''') and then add a new action called '''triggerEnable'''
:11. In '''triggerEnable''' set the '''target''' to '''waypoint_02'''
:* Activates '''waypoint_02''' trigger and only one waypoint at the same time (player won't be able to skip them).

<br/>You can use this method to create more waypoints, also you can copy existing triggers to make it faster, to do that use the '''Copy''' and '''Paste''' buttons which are located under the list of triggers.

{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Mission editor waypoints.JPG]]
</div></div>
|-
|}
<br/>

== Creating ground units ==

=== Artillery units ===

:1. Press the '''Create unit''' icon [[File:MissionEditor CreateUnitIcon Wiki.jpg]] on the the most bottom bar
:2. Create a new unit, drop it on the ground by using '''Drop object''' icon [[File:MissionEditor DropObjectIcon Wiki.jpg]]
:3. Change its type to '''tankModels''' and class to '''uk_at_gun_qf6pounder'''
:* Create at least 5 units
:* All artillery units from '''tankModels''' type have similar names, they start with the nation prefix (for example, germ = Germany, uk = United Kingdom) and the next part is _at_gun and after that cannon name. There is more artillery units and they are marked as the '''structures''' type, most of them can't damage playable tanks because they are intended for use in battles for the airplanes, but there are some like '''ussr_122mm_m30_smoke''', it can use smoke shells, and some other like '''streakartillery_203mm_r150m can be used as a long range artillery.
:4. Place them in the position near the place where the player is supposed to drive by, make sure that their field of view is not blocked by bushes or other objects
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Mission editor artillery.JPG]]
</div></div>
|-
|}
<br/>
=== Tank units ===

:1. Press the '''Create unit''' icon [[File:MissionEditor CreateUnitIcon Wiki.jpg]] on the the most bottom bar
:2. Create a new unit, drop it on the ground by using '''Drop object''' icon [[File:MissionEditor DropObjectIcon Wiki.jpg]]
:3. Change its type to '''tankModels''' and class to '''fr_hotchkiss_h39'''
:* Create at least 6 units, set their class to '''fr_hotchkiss_h39''' and '''fr_renault_r39'''
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Progress so far.JPG]]
</div></div>
|-
|}
<br/>
=== Squad units ===

'''Squads''' are used to store lots of units in groups and by doing that make operating on them using triggers and actions easier.
:1. Press the '''Create unit''' icon [[File:MissionEditor CreateUnitIcon Wiki.jpg]] on the the most bottom bar
:2. Place it somewhere on the map
:* Since squad units are often being modified when you want to add more units it is the best to not place it close to other units.
:3. Select the created unit, change its name to '''t1_arty_squad''' and then '''type''' to '''squad'''
:4. At the bottom there is a tab called '''Properties''', you can add existing units there, for this mission add all existing '''t1_arty_xx''' units
:5. Create another '''squad''' unit and add all existing tank units there (except for the player's unit)
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Mission editor squad.JPG]]
</div></div>
|-
|}
<br/>
=== Adding a tank that will follow the player ===

:1. Press the '''Create unit''' icon [[File:MissionEditor CreateUnitIcon Wiki.jpg]] on the the most bottom bar
:2. Place it 20 meters behind the player's unit
:3. Set its name to '''t2_tank_01''', change '''type''' to '''tankModels''' and '''class''' to '''germ_pzkpfw_II_ausf_C'''

== Setting up the ground units ==

Create two new triggers and change their names to '''basic_properties''' and '''follow_player'''

Setting up the basic properties for all ground units:
:1. Select the '''basic_properties''' trigger
:2. Add a new action called '''unitSetProperties''' and select it
:3. Set the '''object''' to '''t1_tank_squad''', add another object by pressing the tab with the same name and then add '''t1_arty_squad''' and '''t2_tank_01'''
:4. Set the following options:
:Under '''Unit status params'''
:* destroyRIByCollision - enabled 
:: Makes it for the AI units possible to destroy some objects like fences.
:Under '''Attack params'''
:* accuracy - 0.7
:: To not make the AI's fire so accurate.
:* maxDeviationAngle - 1.5
:: Makes the AI not shoot all over the place, it happens when you lower the accuracy
:* checkVisibilityTarget - enabled
:* visibilityTreeTransparencyThreshold - 0.01
:: Very important option, makes the AI not shoot through trees, bushes, buildings and other similar objects.
:* adaptiveAccuracyTime - 0.15
:: Makes the AI miss some of the first shots.
:Under '''Movement params'''
:* advencedCollisionAvoidance - enabled
:: Makes the AI avoid obstacles like buildings.
:* ignoreCollisions - disabled
:* ignoresObstaclesAfterTime - disabled
:Under '''Collision params'''
:* registerCollisions - enabled

Making the AI ally tank follow the player's unit:
:1. Select the '''follow_player''' trigger
:2. Enable '''enableAfterComplete''' option
:3. Make sure that the '''periodicEvent''' is set to 1
:4. Add a new condition called '''unitDistanceBetween'''
:5. Set the '''Object''' to '''t2_tank_01''', '''value''' to 15, '''target''' to '''player_unit''' and '''math''' to 3D
:* Condition will be checking if the AI is less or more than 15 meters from the player's unit.
:6. Add a new action called '''unitSetProperties''' and select it
:7. Set the '''object''' to '''t2_tank_01''', scroll down to '''Movement params''', click on that tab, set the '''move_type''' to '''stand''' and '''speed''' to 0
:* AI unit will stop when it is closer than 15 meters.
:8. Create a new else action (elseAction button), set the '''object''' to '''t2_tank_01''', '''target''' to '''player_unit''' and '''move_type''' to '''navmesh'''
:* Forces the AI unit to follow the player's unit and it will use navmeshes (roads) when it is possible.

Special settings for the enemy units:
:1. Select the '''basic_properties''' trigger
:2. Add a new action called '''unitSetProperties''' and select it
:3. Set the '''object''' to '''t1_tank_squad'''
:4. Set the following options:
:Under '''Movement params'''
:* moveSpeedKAtShooting - 0 
: Makes the AI stop the vehicle when it starts shooting.
:* slowWhenEnemyNear - 0.5
: Sets the multiplier of the speed that it is supposed to keep when it is moving, in this case it will be 0.5x slower.
:* slowWhenEnemyNearDistance - 500
: Sets the distance between the AI and enemy units when it is supposed to slow down.

Note: If you are planning to use artillery units from '''structures''' type then keep in mind that they can damage only lightly armoured vehicles, and it is required to add an '''unitAttackTarget''' action to make them shoot at other units.

Note 2: Maximum shooting range of all high quality ground units is by default reduced to 1,000 m against other ground units. Some postwar vehicles like the ZSU-23-4 or the American M247 can fire at a targets that are further away, but only planes.
Their range can be further increased by using '''unitSetGunProperties''' action, for attacking ground units to up to 2,000 m and even more against air units.

Note 3: Turretless tank destroyers like the StuG Ausf A will always try to turn in order to hit any spotted by them target, they don't need any special action enabled to make that work.

== Making the enemy tanks move towards the player ==

There are two ways of making the ground units move, first and the simplest one is by creating waypoints, second one is by using '''unitMove''' action.
<br/>In the first case you can make them move by selecting the unit and then creating waypoints by using '''Create waypoint''' icon [[File:MissionEditor OnlyWaypointsIcon Wiki.jpg]]. 
<br/>It is also possible to make predefined waypoints that can be assigned to more units, not only just one. You can create them by using '''Create way''' icon which is located next to the '''Create waypoint''' icon.
<br/>They can be assigned to units manually by selecting the unit, then selecting it in '''Way Name''' tab, or by adding a new action called '''unitSetRoute''' where the '''object''' is the unit that you want to move and '''route''' is the name of the waypoint (the first one).
<br/>Second method is based on the '''unitMove''' action, it allows units to move on predefined waypoints called '''splines''' and the '''navmesh''', the first one can be found on maps that are designed primarily for airplanes, the second one is used only on maps for tanks and ships, it makes the AI use more random routes.

For this mission we will use the '''navmesh''' and waypoint areas to trigger the AI to move:
:1. Create a new trigger and change its name to '''enemy_attack_player_01'''
:2. Add a new condition called '''unitWhenInArea''' and select it
:3. Set '''player_unit''' as the '''object''' and '''waypoint_02''' as the '''target'''
:4. Add a new action called '''unitMoveTo''' and select it
:5. Set two units that are the closest to the waypoint from '''unitWhenInArea''' condition as the '''object''' and then set '''player_unit''' as the '''target'''
:6. Press '''move_type''' and select the '''navmesh''' and enable '''follow_target'''
:* This will make the AI use navmesh to get to the player

Now create another trigger called '''enemy_attack_player_02''' and set it up like it is explained above but select the next waypoint (waypoint_03) in the '''unitWhenInArea''' condition and the rest of tanks (03, 04, 05, 06) as the '''object''', this will make move all other AI tanks when the player reaches the next waypoint.

== Reducing the map area ==

Reducing the map area is useful when you do not want the player to have access to the entire map and during making more linear missions which look more like a corridor.
<br/>First you need to create an area which will indicate where the player is supposed to be able to drive, then make a new action:
:1. Create a new area using '''Create box zone''' icon [[File:MissionEditor BoxZoneIcon Wiki.jpg]] and change its name to '''battle_area'''
:* Press the place on the ground where you want to start creating it, then move the mouse to set the length of one side, then press the left mouse button to set the length of its second size and press for the last time to set its height.
:2. Select the '''mission_start''' trigger
:3. Add a new action called '''missionBattleArea''' and select it
:4. Set the '''area''' to '''battle_area''', then enable '''ground''' and '''killOutOfBattleArea'''
:* This will limit the map size for this mission, it is possible to add multiple areas to the same action, or even update it during the mission to make it more dynamic, but this requires adding a new trigger and action.
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Mission editor battle area.JPG]]
</div></div>
|-
|}
<br/>
== Adding objectives ==

To let the player know what are the mission's tasks you have to create some objectives, first one to make the player follow waypoints and the other one to destroy all ground units.

:1. Press '''Mission Obj''' at the bottom of '''Triggers / Mission Obj. Navigation''' category
:* By doing that a new objective will be created.
:2. A new objective should appear under '''Mission objectives''', select it and change its name to follow_waypoint, then uncheck the '''Enabled''' option
:* Unchecking that option will make it not appear right after the start of the mission.
:3. Create another objective and change its name to '''destroy_enemy_units'''
:4. Select the first trigger - '''mission_start'''
:5. Add a new action called '''wait''' and select it
:6. Set its '''time''' to 10
:7. Add two new actions called '''moAddMissionObjective''', in the first one set '''follow_waypoint''' as the '''target''', in the second one set it to '''destroy_enemy_units'''
:8. Add another '''wait''' action, set its time to 3 and then move by using '''Up''' button it so it is between two '''moAddMissionObjective''' actions
:* Makes both objectives appear 10 seconds after the start of mission, but the second one will appear 3 seconds after than the first one.

To mark the follow waypoints objective as completed:
:1. Create a new trigger and set its name to '''reached_final_waypoint''', uncheck the '''enabled''' option
:2. Add a new condition '''unitWhenInArea''' and select it
:3. Change the '''object''' to '''player_unit''' and '''target''' to the last waypoint, in this case '''waypoint_05'''
:4. Add a new action '''moSetObjectiveStatus''' and select it
:5. Set the '''target''' as '''follow_waypoint''' and then switch '''status''' to '''2'''
:* Status set to 2 marks the objective as completed.
:6. Select the last waypoint trigger, in this case it should be '''waypoint_05'''
:7. Add a new action '''triggerEnable''' and set the '''target''' to '''reached_final_waypoint'''
:* Enables that trigger with the objective after reaching the last waypoint so the player won't be able to skip the entire mission.
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:Progress so far 02.JPG]]
</div></div>
|-
|}
<br/>
=== Checking whether all the enemy ground units have been killed ===

:1. Create a new trigger and set its name to '''all_enemy_units_destroyed'''
:2. Add a new condition '''unitWhenCountMatches''' and select it
:3. Set the '''object''' to '''t1_arty_squad''' and '''t1_tank_squad'''
:4. Switch the '''object_type''' to '''isAlive'''
:5. Switch the '''func''' to '''less'''
:6. Set the '''value''' to 1
:* This condition will check if there is less than 1 of enemy units alive,
:7. Add a new action '''moSetObjectiveStatus''' and select it
:8. Set the '''target''' as '''destroy_enemy_units''' and then switch '''status''' to '''2'''

=== Mission completion ===

To make the mission end by completing all objectives:
:1. Create a new trigger and set its name to '''mission_completed'''
:2. Add two new '''misObjStatus''' conditions
:3. Set the '''target''' in the first one to '''destroy_enemy_units''' and the second one to '''follow_waypoint'''
:4. In both conditions set the '''status''' to '''completed'''
:* Makes the action activate when both objectives are completed
:5. Add a new action called '''missionCompleted'''
:* This action ends the mission and shows the mission completed message

=== Mission failed ===

To make the mission end when the player dies and show the mission failed message:
:1. Create a new trigger and set its name to '''mission_failed'''
:2. Add a new '''unitWhenStatus''' conditions
:3. Set the '''target''' to '''player_unit'''
:4. Switch the '''object_type''' to '''isKilled'''

Triggers window when everything is done:
<br/>[[File:All triggers.JPG]]

=== CSV file ===

To show the objectives properly the CSV file needs to be set up correctly.
:1. Open the CSV file which creation was explained at the top in '''Basics''' section
:2. Copy this code below:

 "<ID|readonly|noverify>";"<english>";
 
 "missions/mission_name/date";day + month + year;;
 
 "missions/mission_name";"mission name";;
 
 "missions/mission_name/objective";"mission description";;
 
 "objective_01";"objective name 01";;
 
 "objective_02";"objective name 02";;
 
:* mission_name - Mission name that you set in the mission's blk file in name:t="" line 
:* objective_01 - Needs to match the objective that is set in the mission file

For this mission it should look like that:
{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" |...
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
 "<ID|readonly|noverify>";"<english>";
 
 "missions/hurtgen_forest_battle/date";1940;;
 
 "missions/hurtgen_forest_battle";"Hurtgen Battle";;
 
 "missions/hurtgen_forest_battle/objective";"Battle in the Hurtgen forest against French forces";;
 
 "follow_waypoint";"Follow the objective";;
 
 "destroy_enemy_units";"Destroy all the enemy ground units";;
</div></div>
|-
|}

== Optional / Additional information ==

=== Adding hints ===

It is possible to add a text message that will shown on the center of screen, for example a warning, for this mission make it appear when the player reaches one of waypoints and warns about the enemy forces.
:1. Select the '''enemy_attack_player_01''' or '''waypoint_03''' depending where you added the '''unitWhenInArea''' condition with the ''waypoint_02'' target
:2. Add a new action called '''playHint''' and select it
:3. Set the '''hintType''' to '''standard'''
:4. In the '''name''' tab add the warning: Enemy forces have been spotted
:5. Set the '''time''' to 5
:* Hints will be shown at the center of screen after reaching the second waypoint and it will be visible for 5 seconds.

=== Making the tank use its smoke grenades ===

It is possible to make the AI use smoke grenades, it can be done by using the unitSetProperties action.
:1. Add a new '''unitSetProperties''' action
:2. Set the unit that you want to use its smoke grenades as the '''object'''
:3. Click on the '''controls''' bar and then after a new set of options appears select '''weaponTriggers'''
:* A new textbox should appear, you can set it to for example a "trigger" that uses smoke grenades.
:4. Type '''gunner2''' in the textbox
: For the Panzer III F it is '''gunner2''' and can be different for other units.
:5. Enable the '''Set''' option
:* Now the AI should start using its smoke grenades as soon as the trigger with this action is activated.

=== Checking the AI's spotting range and visibility ===

The visibilityTreeTransparencyThreshold option uses the center of vehicle to check if the unit is visible or not and there is an option in the mission editor which can help with determining what the AI can see, it is called a View Point with an icon looking like this: [[File:View point icon.PNG]]

After selecting the view point can be placed anywhere on the map and enabled when it is placed somewhere and selected by either pressing the F1 button or enabling the '''Show visibility map (F1)''' option in the '''Object Properties''' window.

{| class="wikitable" style="width: 100%;"
|+
! style="width: 100%;" | Screenshot
|-
|<div class="mw-collapsible mw-collapsed" style="width:100%"><div class="mw-collapsible-content">
[[File:View point screenshot.PNG]]
</div></div>
|-
|}

The violet area is what the AI cannot see and everything rendered with normal colors is visible to it.
It is the best to move it around by using '''Move over surface''' option (or by pressing Ctrl + Alt + W).

=== Switching the camouflage ===

By default it is not possible to switch the skin on high quality ground units like the M4A1 75 ('''tankModels'''), the option allows only to choose options for the low quality units used on maps for the airplanes ('''wheeled_vehicles''' etc.). The default, snow, sand, forest, jungle and urban are the only available options. In order to change this tab you need to follow these points:
:1. Go to the '''WarThunderCDK\dagor3_cdk\bin64\plugins\de3x\missions\units''' folder
:2. Open the '''common.scheme.nut''' file
:3. Find a line that starts with '''{name = "skin"'''
:4. Change this line to '''{name = "skin", type = "text", extensible=true, itemsCount=[0,1]}'''

Now after reloading the CDK it should be possible to type any camouflage name in the '''skins''' box for the '''tankModels''' in the '''Object Properties''' tab.

To find the camouflage name it is required to get a localization file that contains all their names.
The explanation of how it can be done can be found [[Instructions for the user localizations|here]]

The file that contains all those names is called '''unlocks_skins.csv''', it can be opened by using any kind of notepad software that can open '''.txt''' files.
To find the specific camouflage you need to find its name in the game, then find it in the localization file.
For example the name of the [[Lübeck|Lübeck's]] alternative skin called '''Deforming camouflage''' that can be used in CDK is called '''graynord_geometry''' and this exact name needs to be pasted to the '''skin''' box.

== Mission example ==
* [https://live.warthunder.com/post/1020113/en/ Very simple singleplayer mission for ground units]

= See also =
* [[Instructions for Using the Mission Editor]]
* [[Triggers]]
* [[Multiplayer mission creation]]

[[Category:War Thunder CDK]] 
[[Category:Custom missions]]