2D Editor: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 7: Line 7:
[[Category: Take On Helicopters: Editing]]
[[Category: Take On Helicopters: Editing]]


This article will take you on a tour of the mission editor used in majority of Bohemia Interactive's product, explaining the functions of the many menu options and menus. The focus of this article is explaining the function and effect of each option, rather than recommending which option should be used to create a desired outcome. Many options create different effects depending on different circumstances. The shear amount of information presented may seem daunting at first, but remember games based on [[Real Virtuality]] engine are more complex than many other games, and there is always more than one way to create the desired effect.  
Mission editor is primary tool for creating both singleplayer and multiplayer scenarios in majority of [[Bohemia Interactive]]'s [[:Category:Projects|products]].


== Definitions ==
The focus of this article is explaining the function and effect of each option, rather than recommending which option should be used to create a desired outcome. Many options create different effects depending on different circumstances. The shear amount of information presented may seem daunting at first, but remember games based on [[Real Virtuality]] engine are more complex than many other games, and there is always more than one way to create the desired effect.  
For the purposes of this article only, the following terms use are used:
*'''Unit''' - A controlled object. This includes soldiers and game logics, but not vehicles.
*'''Vehicle''' - A literal vehicle or a vehicle class object. For example, a car, tank or static machine gun is a vehicle. Note any crew or passengers are referred to as units, and are not considered to be an integral part of the vehicle.
*'''Object''' - Any object that appears in the mission. This includes terrain defined objects (trees, buildings) and mission placed units and objects.
*'''Entity''' - Anything on the mission map that is not the terrain. This includes terrain defined objects, mission placed objects, triggers, waypoints and markers.


{| class = "wikitable collapsible" style="text-align:center;" align="right"
! colspan="5" | Keyboard Shortcuts
|-
! Function
! [[Arma: Cold War Assault|Arma: CWA]]
! [[Arma]]
! [[Arma 2]]
! [[Take On Helicopters|TKOH]]
|-
| [[#Units|Units]]
| colspan="4" | F1
|-
| [[#Groups|Groups]]
| colspan="4" | F2
|-
| [[#Triggers|Triggers]]
| colspan="4" | F3
|-
| [[#Waypoints|Waypoints]]
| colspan="4" | F4
|-
| [[#Synchronization|Synchronization]]
| colspan="4" | F5
|-
| [[#Markers|Markers]]
| colspan="4" | F6
|-
| [[#Modules|Modules]]
| colspan="2" |
| colspan="2" | F7
|-
| [[#New|New]]
| colspan="2" |
| R
| Ctrl + N
|-
| [[#Load|Load]]
| colspan="3" |
| Ctrl + O
|-
| [[#Save|Save]]
| colspan="3" |
| Ctrl + S
|-
| [[#Save As|Save As]]
| colspan="2" |
| S
| Ctrl + Shift + S
|-
| [[#Marge|Merge]]
| colspan="2" |
| M
| Ctrl + M
|-
| [[#Show IDs|Show IDs]]
| colspan="3" |
| Ctrl + I
|-
| [[#Show Textures|Show Textures]]
| colspan="2" |
| T
| Ctrl + T
|-
| [[#Preview|Preview]]
| colspan="4" | Enter
|-
| [[#Continue|Continue]]
| colspan="4" |
|-
| [[#Intel|Intel]]
| colspan="4" |
|-
| [[#Exit|Exit]]
| colspan="4" | Escape
|-
| [[#Debug Console|Debug Console]]
| colspan="3" |
| Ctrl + D
|-
| [[#Functions|Functions]]
| colspan="3" |
| Ctrl + F


== Mission Modes ==
|-
This drop down list allows you to choose which component of a mission you are currently editing. A single mission stores all objects and mission parameters for the intro and outro cutscenes completely separately from the gameplay component of a mission. It is not essential to use any of these other than the mission component. While each component requires a player unit if it is to be used, the player will only have control of the unit in the ''Mission'' component. In the ''Intro'' and ''Outros'', AI will control the player's unit. The ''Intro'' and ''Outros'' will not end when the player unit dies, but must be ended using a trigger.
| [[#Config Viewer|Config Viewer]]
*'''Mission''' is the default. This defines the interactive component of a mission. It is the only essential part of a mission.
| colspan="3" |
*'''Intro''' plays before the briefing screen.
| Ctrl + G
*'''Outro - Win''' will play after the debriefing screen in the case of a Win 1-6 trigger being activated.
 
*'''Outro - Loose''' will play after the debriefing screen in the case of a Lose trigger being activated.
|}
 
 
== Starting the Editor ==
Editor is accessable from main menu by button labelled "Mission Editor" or just "Editor". In Arma 2 and Take On Helicopters, this button can be found in Singleplayer subcategory.
<gallery>
File:ofp_editor_menu.jpg|[[Arma: Cold War Assault]]
File:arma_editor_menu.jpg|[[Arma]]
File:arma2_editor_menu.jpg|[[Arma 2]]
File:tkoh_editor_menu.jpg|[[Take On Helicopters]]
</gallery>




Line 56: Line 163:
}}
}}
Status bar on the bottom of a screen displays current map grid and cursor's XYZ coordinates.
Status bar on the bottom of a screen displays current map grid and cursor's XYZ coordinates.
== Mission Modes ==
This drop down list allows you to choose which component of a mission you are currently editing. A single mission stores all objects and mission parameters for the intro and outro cutscenes completely separately from the gameplay component of a mission. It is not essential to use any of these other than the mission component. While each component requires a player unit if it is to be used, the player will only have control of the unit in the ''Mission'' component. In the ''Intro'' and ''Outros'', AI will control the player's unit. The ''Intro'' and ''Outros'' will not end when the player unit dies, but must be ended using a trigger.
*'''Mission''' is the default. This defines the interactive component of a mission. It is the only essential part of a mission.
*'''Intro''' plays before the briefing screen.
*'''Outro - Win''' will play after the debriefing screen in the case of a Win 1-6 trigger being activated.
*'''Outro - Loose''' will play after the debriefing screen in the case of a Lose trigger being activated.




Line 63: Line 178:


=== [[File:icon editor units.png|30px]] Units ===
=== [[File:icon editor units.png|30px]] Units ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
''Main article: [[Mission Editor: Units]]''
''Main article: [[Mission Editor: Units]]''


Line 83: Line 190:


=== [[File:icon editor groups.png|30px]] Groups ===
=== [[File:icon editor groups.png|30px]] Groups ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
''Main article: [[Mission Editor: Groups]]''
''Main article: [[Mission Editor: Groups]]''


Group editing mode can be used in several ways. The primary use is to join previously placed individual entities together into groups. Joining individual units together into groups can greatly improve their combat abilities. A group will move together, share information about enemy units and can bring greater firepower to bare on a target. Each individual unit on the map that has no visible group links is actually in a group of it's own. When a unit is created near another unit of the same side, it will automatically be placed in the other unit's group. To join a unit into an existing group, simply left click and hold on the unit, then drag a line to any unit of the group you wish to add it too. Release the button to join the unit into that group. Group links are displayed by light blue line drawn from the leader to each other unit in the group. Removing a unit from a group is done by left clicking and holding on the unit and dragging the group link line into empty space, then releasing. The highest ranking unit in a group will generally be the leader. While it is possible to create extremely large groups in ArmA, huge formations of AI units create path finding issues and can be very hard to manage for a human leader.
Group editing mode can be used in several ways. The primary use is to join previously placed individual entities together into groups. Joining individual units together into groups can greatly improve their combat abilities. A group will move together, share information about enemy units and can bring greater firepower to bare on a target. Each individual unit on the map that has no visible group links is actually in a group of it's own. When a unit is created near another unit of the same side, it will automatically be placed in the other unit's group. To join a unit into an existing group, simply left click and hold on the unit, then drag a line to any unit of the group you wish to add it too. Release the button to join the unit into that group. Group links are displayed by light blue line drawn from the leader to each other unit in the group. Removing a unit from a group is done by left clicking and holding on the unit and dragging the group link line into empty space, then releasing. The highest ranking unit in a group will generally be the leader. While it is possible to create extremely large groups, huge formations of AI units create path finding issues and can be very hard to manage for a human leader.


<gallery>
<gallery>
Line 103: Line 202:


=== [[File:icon editor triggers.png|30px]] Triggers ===
=== [[File:icon editor triggers.png|30px]] Triggers ===
{{Versions|
''Main article: [[Mission Editor: Triggers]]''
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}


''Main article: [[Mission Editor: Triggers]]''
A trigger is an abstract game entity that will wait until it's [[#Condition|condition]] block returns true, then carry out the ''On Activation'' string. When used effectively, they can make your mission seem much more dynamic and realistic. For example, you can use a trigger to set off a siren and call reinforcements when the player is spotted near an enemy base, or to start a convoy moving when the player gives a radio command.


A trigger is an abstract game entity that will wait until it's [[#Condition|condition]] block returns true, then carry out the ''On Activation'' string. When used effectively, they can make your mission seem much more dynamic and realistic. For example, you can use a trigger to set off a siren and call reinforcements when the player is spotted near an enemy base, or to start a convoy moving when the player gives a radio command. Triggers are represented in the mission editor by a dark blue ellipse or rectangle with a small blue flag in the centre. Triggers may be linked to an object in [[#Groups|Groups Mode (F2)]], which generally means that only that object or group can activate the trigger. Triggers can be used in various ways, for example the location and dimensions of a trigger are not always used as part of it's conditions, and triggers do not necessarily require an ''On Activation'' block, instead being used to return a [[list]] of objects that satisfy it's conditions. Each trigger's ''Condition'' block will be checked approximately twice every second for the duration of the mission. To add a new trigger to your mission, double left click in some empty map space. The ''Trigger Menu'' will open.
Triggers are represented in the mission editor by a dark blue ellipse or rectangle with a small blue flag in the centre. Triggers may be linked to an object in [[#Groups|Groups Mode (F2)]], which generally means that only that object or group can activate the trigger. Triggers can be used in various ways, for example the location and dimensions of a trigger are not always used as part of it's conditions, and triggers do not necessarily require an ''On Activation'' block, instead being used to return a [[list]] of objects that satisfy it's conditions. Each trigger's ''Condition'' block will be checked approximately twice every second for the duration of the mission. To add a new trigger to your mission, double left click in some empty map space. The ''Trigger Menu'' will open.


<gallery>
<gallery>
Line 123: Line 216:


=== [[File:icon editor waypoint.png|30px]] Waypoints ===
=== [[File:icon editor waypoint.png|30px]] Waypoints ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
''Main article: [[Mission Editor: Waypoints]]''
''Main article: [[Mission Editor: Waypoints]]''


Line 143: Line 228:


=== [[File:icon editor synchro.png|30px]] Synchronization ===
=== [[File:icon editor synchro.png|30px]] Synchronization ===
{{Versions|
''Main article: [[Mission Editor: Synchronization]]''
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}


''Main article: [[Mission Editor: Synchronization]]''
Synchronization mode is used to make different groups carry out their waypoint orders at the same time, and optionally only under specific circumstances. Synchronization can seem a hard concept to understand at first, but it is a very powerful and easy to use tool. For example, synchronization can be used to organize friendly forces to wait until everyone is in position before launching a mass attack, or wait in ambush until an enemy convoy is in the perfect location before opening fire. Synchronizing links can be made between any of a group's waypoints and any number of other group's waypoints, and any number of triggers. A synchronized waypoint will not complete until all waypoints it is linked with are ready to complete, and all synchronized triggers are activated. Synchronizing links are displayed by a dark blue line connecting the entities.


Synchronization mode is used to make different groups carry out their waypoint orders at the same time, and optionally only under specific circumstances. Synchronization can seem a hard concept to understand at first, but it is a very powerful and easy to use tool. For example, synchronization can be used to organize friendly forces to wait until everyone is in position before launching a mass attack, or wait in ambush until an enemy convoy is in the perfect location before opening fire. Synchronizing links can be made between any of a group's waypoints and any number of other group's waypoints, and any number of triggers. A synchronized waypoint will not complete until all waypoints it is linked with are ready to complete, and all synchronized triggers are activated. Synchronizing links are displayed by a dark blue line connecting the entities. To create a synchronized link between a waypoint and another group's waypoint or a trigger, simply left click and hold on the waypoint, move the mouse to the desired waypoint/trigger then release. To remove synchronization lines from a waypoint or trigger, left click on it, hold and drag a line into empty space. Note this will remove '''all''' synchronizing lines from that entity, so be careful.
To create a synchronized link between a waypoint and another group's waypoint or a trigger, simply left click and hold on the waypoint, move the mouse to the desired waypoint/trigger then release. To remove synchronization lines from a waypoint or trigger, left click on it, hold and drag a line into empty space. Note this will remove '''all''' synchronizing lines from that entity, so be careful.


=== [[File:icon editor marker.png|30px]] Markers ===
=== [[File:icon editor marker.png|30px]] Markers ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
''Main article: [[Mission Editor: Markers]]''
''Main article: [[Mission Editor: Markers]]''


Line 194: Line 265:
== Basic Operations ==
== Basic Operations ==
=== [[File:icon editor clear.png|30px]] New ===
=== [[File:icon editor clear.png|30px]] New ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Remove all map entities such as units, waypoints, markers and triggers. Settings such as those defined in the Intel are retained. Be warned that there is no undo function in the mission editor.  
Remove all map entities such as units, waypoints, markers and triggers. Settings such as those defined in the Intel are retained. Be warned that there is no undo function in the mission editor.  


=== [[File:icon editor load.png|30px]] Load ===
=== [[File:icon editor load.png|30px]] Load ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Allows you to load a previously saved mission. Only uncompressed mission folders in your current profiles missions folder can be loaded.
Allows you to load a previously saved mission. Only uncompressed mission folders in your current profiles missions folder can be loaded.


=== [[File:icon editor saveas.png|30px]] Save As ===
=== [[File:icon editor saveas.png|30px]] Save As ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
You can save your current mission with this menu.  
You can save your current mission with this menu.  
*'''User missions''' - These missions are only available through the mission editor while using the current user profile. Note that if you save your mission under a new name, only the [[Mission.sqm]] file will be written in the new folder. Saving a already named ''User mission'' also reloads any mission support files that are in the chosen mission folder, such as [[Description.ext]] and [[Init.sqs]].  
*'''User missions''' - These missions are only available through the mission editor while using the current user profile. Note that if you save your mission under a new name, only the [[Mission.sqm]] file will be written in the new folder. Saving a already named ''User mission'' also reloads any mission support files that are in the chosen mission folder, such as [[Description.ext]] and [[Init.sqs]].  
Line 237: Line 284:


=== [[File:icon editor merge.png|30px]] Merge ===
=== [[File:icon editor merge.png|30px]] Merge ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Merge will import all map data (units, groups, waypoints, triggers, etc) from one mission into the currently loaded mission. Other settings such as those set in the [[#Intel|Intel Display]] are not imported.
Merge will import all map data (units, groups, waypoints, triggers, etc) from one mission into the currently loaded mission. Other settings such as those set in the [[#Intel|Intel Display]] are not imported.


=== [[File:icon editor id.png|30px]] Show IDs ===
=== [[File:icon editor id.png|30px]] Show IDs ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Every object defined in the terrain you are using has an assigned ID number that can be used to refer to the object in script code. These IDs are normally hidden for clarity, and this button toggles them on or off. IDs are only visible at high zoom levels.
Every object defined in the terrain you are using has an assigned ID number that can be used to refer to the object in script code. These IDs are normally hidden for clarity, and this button toggles them on or off. IDs are only visible at high zoom levels.


=== [[File:icon editor textures.png|30px]] Show Textures ===
=== [[File:icon editor textures.png|30px]] Show Textures ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Clicking on this option will backfill the map with the satellite map texture rather than the default white. This gives the user an idea of the type of terrain found in an area, although the satellite map does not always correspond exactly with the ground detail textures as seen at close range.
Clicking on this option will backfill the map with the satellite map texture rather than the default white. This gives the user an idea of the type of terrain found in an area, although the satellite map does not always correspond exactly with the ground detail textures as seen at close range.


=== [[File:icon editor preview.png|30px]] Preview ===
=== [[File:icon editor preview.png|30px]] Preview ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
Preview will start the mission from within the editor so that you can test the results of your labour. A player unit must be on the map for the preview button to be visible. If shift is held down while clicking on the preview button, the mission preview will include the mission briefing and debriefing. Note that in preview mode, some aspects of a mission may not always behave in the same way as they would if the mission was played as a single mission. It is wise to check your mission in "single mission mode" (outside of the mission editor) before considering release.
Preview will start the mission from within the editor so that you can test the results of your labour. A player unit must be on the map for the preview button to be visible. If shift is held down while clicking on the preview button, the mission preview will include the mission briefing and debriefing. Note that in preview mode, some aspects of a mission may not always behave in the same way as they would if the mission was played as a single mission. It is wise to check your mission in "single mission mode" (outside of the mission editor) before considering release.


=== [[File:icon editor continue.png|30px]] Continue ===
=== [[File:icon editor continue.png|30px]] Continue ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
After you have exited from the preview mode, clicking 'Continue' will allow you resume the mission from the point you left it. Note that any changes made in the editor since you exited the preview will not be shown. You must click 'Preview' again to restart with the updated version of your mission.
After you have exited from the preview mode, clicking 'Continue' will allow you resume the mission from the point you left it. Note that any changes made in the editor since you exited the preview will not be shown. You must click 'Preview' again to restart with the updated version of your mission.


=== Intel ===
=== Intel ===
{{Versions|
[[Image:ofp_1.00.gif]]
[[Image:arma_1.00.gif]]
[[Image:arma2_1.00.gif]]
[[Image:arma2oa_1.51.gif]]
[[Image:TKOH_1.00.gif]]
}}
''Main article: [[Mission Editor: Intel]]''
''Main article: [[Mission Editor: Intel]]''


Line 309: Line 308:
File:Arma2 editor intel.jpg|[[Arma 2]]
File:Arma2 editor intel.jpg|[[Arma 2]]
File:tkoh editor intel.jpg|[[Take On Helicopters]]
File:tkoh editor intel.jpg|[[Take On Helicopters]]
</gallery>
=== Easy / Advanced ===
{{Versions|
[[Image:ofp_1.00.gif]]
}}
The mission editor has two modes, easy and advanced. The easy mode simply hides aspects of the mission editor and takes away a lot of the control you have as a skilled designer, but could distract you when new to the editing.
<gallery>
File:OFP_editor_easy.jpg|Easy
File:OFP_editor_advanced.jpg|Advanced
</gallery>
</gallery>


Line 355: Line 365:




== Keyboard Shortcuts ==
==External Editing ==
{| class = "wikitable sortable" style="text-align:center;"
''Main article: [[Mission Editor: External]]''
|-
! Function
! [[Arma: Cold War Assault|Arma: CWA]]
! [[Arma]]
! [[Arma 2]]
! [[Take On Helicopters|TKOH]]


|-
Mission editor provides majority of tools required for designing a mission, but finishing touches are usually made outside of it. Briefings, debriefings, multiplayer settings or final packing are only handled by separate files programs.
| [[#Units|Units]]
| colspan="4" | F1
 
|-
| [[#Groups|Groups]]
| colspan="4" | F2
 
|-
| [[#Triggers|Triggers]]
| colspan="4" | F3
 
|-
| [[#Waypoints|Waypoints]]
| colspan="4" | F4
 
|-
| [[#Synchronization|Synchronization]]
| colspan="4" | F5
 
|-
| [[#Markers|Markers]]
| colspan="4" | F6
 
|-
| [[#Modules|Modules]]
| colspan="2" |
| colspan="2" | F7
 
|-
| [[#New|New]]
| colspan="2" |
| R
| Ctrl + N
 
|-
| [[#Load|Load]]
| colspan="3" |
| Ctrl + O
 
|-
| [[#Save|Save]]
| colspan="3" |
| Ctrl + S
 
|-
| [[#Save As|Save As]]
| colspan="2" |
| S
| Ctrl + Shift + S
 
|-
| [[#Marge|Merge]]
| colspan="2" |
| M
| Ctrl + M
 
|-
| [[#Show IDs|Show IDs]]
| colspan="3" |
| Ctrl + I
 
|-
| [[#Show Textures|Show Textures]]
| colspan="2" |
| T
| Ctrl + T
 
|-
| [[#Preview|Preview]]
| colspan="4" | Enter
 
|-
| [[#Continue|Continue]]
| colspan="4" |
 
|-
| [[#Intel|Intel]]
| colspan="4" |
 
|-
| [[#Exit|Exit]]
| colspan="4" |
 
|-
| [[#Debug Console|Debug Console]]
| colspan="3" |
| Ctrl + D
 
|-
| [[#Functions|Functions]]
| colspan="3" |
| Ctrl + F
 
|-
| [[#Config Viewer|Config Viewer]]
| colspan="3" |
| Ctrl + G
 
|}

Revision as of 09:04, 25 October 2011


Mission editor is primary tool for creating both singleplayer and multiplayer scenarios in majority of Bohemia Interactive's products.

The focus of this article is explaining the function and effect of each option, rather than recommending which option should be used to create a desired outcome. Many options create different effects depending on different circumstances. The shear amount of information presented may seem daunting at first, but remember games based on Real Virtuality engine are more complex than many other games, and there is always more than one way to create the desired effect.

Keyboard Shortcuts
Function Arma: CWA Arma Arma 2 TKOH
Units F1
Groups F2
Triggers F3
Waypoints F4
Synchronization F5
Markers F6
Modules F7
New R Ctrl + N
Load Ctrl + O
Save Ctrl + S
Save As S Ctrl + Shift + S
Merge M Ctrl + M
Show IDs Ctrl + I
Show Textures T Ctrl + T
Preview Enter
Continue
Intel
Exit Escape
Debug Console Ctrl + D
Functions Ctrl + F
Config Viewer Ctrl + G


Starting the Editor

Editor is accessable from main menu by button labelled "Mission Editor" or just "Editor". In Arma 2 and Take On Helicopters, this button can be found in Singleplayer subcategory.


Map

  • Clicking and holding the RMB anywhere on the map allows the user to pan around the map by moving the mouse.
  • The mouse wheel and numpad +/- keys control the map zoom level.
  • LMB on an entity selects it. Selected entities are opaque, non selected entities are slightly transparent.
  • 2xLMB on an entity generally opens the entity's editing menu. In Waypoint mode, double left clicking on a object will create a waypoint for the selected group that is attached to the clicked object.
  • 2xLMB on empty space will create a new entity, if it is possible in the current editing mode.
  • Clicking and holding LMB on an entity allows it to be dragged around the map. It is not possible to move units in group mode or move waypoints in synchronize mode.
  • Clicking and holding LMB on empty space allows a drag box to be created for selecting multiple entities.
  • Holding Ctrl allows the user to select more than one entity using the drag box or individually by left clicking on them.
  • Shift + LMB on an unit or waypoint will select all entities associated with that unit's group.
  • Shift + Holding LMB on a selected entity rotates the selected entities.
  • Shift + LMB on an object with a waypoint attached to it selects the underlaying object.
  • Shift + 2xLMB entity with a waypoint on it opens the appropriate entity's menu (rather than the waypoints).
  • Delete will erase the entity under the mouse cursor.
  • Ctrl + X will cut the selected entities to the clipboard.
  • Ctrl + C will copy the selected entities to the clipboard.
  • Ctrl + V will paste a copy of entities from the clipboard. Copy and pasted named entities automatically have a number appended to their names to avoid conflicts.
  • Ctrl + Shift + V will paste a copy of entities on their original position (useful when copying units between missions).

Status Bar

Template:Versions Status bar on the bottom of a screen displays current map grid and cursor's XYZ coordinates.


Mission Modes

This drop down list allows you to choose which component of a mission you are currently editing. A single mission stores all objects and mission parameters for the intro and outro cutscenes completely separately from the gameplay component of a mission. It is not essential to use any of these other than the mission component. While each component requires a player unit if it is to be used, the player will only have control of the unit in the Mission component. In the Intro and Outros, AI will control the player's unit. The Intro and Outros will not end when the player unit dies, but must be ended using a trigger.

  • Mission is the default. This defines the interactive component of a mission. It is the only essential part of a mission.
  • Intro plays before the briefing screen.
  • Outro - Win will play after the debriefing screen in the case of a Win 1-6 trigger being activated.
  • Outro - Loose will play after the debriefing screen in the case of a Lose trigger being activated.


Editing Modes

The mission editor is always in one of these seven modes. Each different mode allows the creation and manipulation of different types of map entities. The required mode can be set by either clicking on the modes name/icon or pressing the associated function key. The modes are set out in the basic order they would be used while creating a mission.

icon editor units.png Units

Main article: Mission Editor: Units

Unit mode is used to add individual units, vehicles and objects on the map. To do so, double click on the empty space where you would like to add a unit. This will open the Unit Menu. You can also open the unit menu of an existing unit while in any editing mode other than waypoints by double clicking on the unit. Note that if there is no player unit on the map, the unit menu will only allow valid player units may be placed.

icon editor groups.png Groups

Main article: Mission Editor: Groups

Group editing mode can be used in several ways. The primary use is to join previously placed individual entities together into groups. Joining individual units together into groups can greatly improve their combat abilities. A group will move together, share information about enemy units and can bring greater firepower to bare on a target. Each individual unit on the map that has no visible group links is actually in a group of it's own. When a unit is created near another unit of the same side, it will automatically be placed in the other unit's group. To join a unit into an existing group, simply left click and hold on the unit, then drag a line to any unit of the group you wish to add it too. Release the button to join the unit into that group. Group links are displayed by light blue line drawn from the leader to each other unit in the group. Removing a unit from a group is done by left clicking and holding on the unit and dragging the group link line into empty space, then releasing. The highest ranking unit in a group will generally be the leader. While it is possible to create extremely large groups, huge formations of AI units create path finding issues and can be very hard to manage for a human leader.

icon editor triggers.png Triggers

Main article: Mission Editor: Triggers

A trigger is an abstract game entity that will wait until it's condition block returns true, then carry out the On Activation string. When used effectively, they can make your mission seem much more dynamic and realistic. For example, you can use a trigger to set off a siren and call reinforcements when the player is spotted near an enemy base, or to start a convoy moving when the player gives a radio command.

Triggers are represented in the mission editor by a dark blue ellipse or rectangle with a small blue flag in the centre. Triggers may be linked to an object in Groups Mode (F2), which generally means that only that object or group can activate the trigger. Triggers can be used in various ways, for example the location and dimensions of a trigger are not always used as part of it's conditions, and triggers do not necessarily require an On Activation block, instead being used to return a list of objects that satisfy it's conditions. Each trigger's Condition block will be checked approximately twice every second for the duration of the mission. To add a new trigger to your mission, double left click in some empty map space. The Trigger Menu will open.

icon editor waypoint.png Waypoints

Main article: Mission Editor: Waypoints

Waypoints are used to define the route and behaviour of a group during the mission. At any point in time a group will have one active waypoint (generally the waypoint they are to move towards). Once a waypoint's conditions have been met, it will become complete and the group's next waypoint automatically becomes active. Some of a waypoint's settings will take place as the waypoint becomes active, others when the waypoint is complete.

icon editor synchro.png Synchronization

Main article: Mission Editor: Synchronization

Synchronization mode is used to make different groups carry out their waypoint orders at the same time, and optionally only under specific circumstances. Synchronization can seem a hard concept to understand at first, but it is a very powerful and easy to use tool. For example, synchronization can be used to organize friendly forces to wait until everyone is in position before launching a mass attack, or wait in ambush until an enemy convoy is in the perfect location before opening fire. Synchronizing links can be made between any of a group's waypoints and any number of other group's waypoints, and any number of triggers. A synchronized waypoint will not complete until all waypoints it is linked with are ready to complete, and all synchronized triggers are activated. Synchronizing links are displayed by a dark blue line connecting the entities.

To create a synchronized link between a waypoint and another group's waypoint or a trigger, simply left click and hold on the waypoint, move the mouse to the desired waypoint/trigger then release. To remove synchronization lines from a waypoint or trigger, left click on it, hold and drag a line into empty space. Note this will remove all synchronizing lines from that entity, so be careful.

icon editor marker.png Markers

Main article: Mission Editor: Markers

Marker mode is primarily used to place visual map icons and zones on the mission map. Markers are only visible while the mission editor is in marker mode, but can still be manipulated while in other modes. To do so, hover the mouse cursor over a marker's position to display it's name. The second use of markers is to define a possible starting position for any number of objects. To do this, create a group link between the marker and the object. The object will begin the mission at any one of the markers it is grouped with or at it's original position, chosen at random. This offers another way to create some randomness in a mission, with more precise control compared to using the object's Placement radius option. Note that any marker used in this way will still be drawn on the mission map (although setting the axis sizes to 0 can be used to hide a marker). Markers can not be attached to objects. To create a map marker, double left click in empty space.

icon editor module.png Modules

Template:Versions

Main article: Mission Editor: Modules

Modules offers complex scripted solutions

Basic Operations

icon editor clear.png New

Remove all map entities such as units, waypoints, markers and triggers. Settings such as those defined in the Intel are retained. Be warned that there is no undo function in the mission editor.

icon editor load.png Load

Allows you to load a previously saved mission. Only uncompressed mission folders in your current profiles missions folder can be loaded.

icon editor saveas.png Save As

You can save your current mission with this menu.

  • User missions - These missions are only available through the mission editor while using the current user profile. Note that if you save your mission under a new name, only the Mission.sqm file will be written in the new folder. Saving a already named User mission also reloads any mission support files that are in the chosen mission folder, such as Description.ext and Init.sqs.
  • Export to single missions/multiplayer missions - You can also choose to export your mission to either the single mission or multiplayer mission folders. This process creates a pbo file of the current mission folder (includes all files) and moves it to the global "Mission" or "MPmissions" folder. These can be accessed from the ArmA main menu by any user profile.
  • Send by e-mail - This option will create a pbo file of the mission folder and load your default email program using it as an attachment.

icon editor save.png Save

Template:Versions

Saves a currently edited mission without opening any menu, unless mission wasn't saved previously.

icon editor merge.png Merge

Merge will import all map data (units, groups, waypoints, triggers, etc) from one mission into the currently loaded mission. Other settings such as those set in the Intel Display are not imported.

icon editor id.png Show IDs

Every object defined in the terrain you are using has an assigned ID number that can be used to refer to the object in script code. These IDs are normally hidden for clarity, and this button toggles them on or off. IDs are only visible at high zoom levels.

icon editor textures.png Show Textures

Clicking on this option will backfill the map with the satellite map texture rather than the default white. This gives the user an idea of the type of terrain found in an area, although the satellite map does not always correspond exactly with the ground detail textures as seen at close range.

icon editor preview.png Preview

Preview will start the mission from within the editor so that you can test the results of your labour. A player unit must be on the map for the preview button to be visible. If shift is held down while clicking on the preview button, the mission preview will include the mission briefing and debriefing. Note that in preview mode, some aspects of a mission may not always behave in the same way as they would if the mission was played as a single mission. It is wise to check your mission in "single mission mode" (outside of the mission editor) before considering release.

icon editor continue.png Continue

After you have exited from the preview mode, clicking 'Continue' will allow you resume the mission from the point you left it. Note that any changes made in the editor since you exited the preview will not be shown. You must click 'Preview' again to restart with the updated version of your mission.

Intel

Main article: Mission Editor: Intel

Intel display allows you to name your mission, give it a brief description, set the mission starting date and time, the current and forecast weather and which sides resistance forces are friendly to. Clicking on the Intel box will bring up the Intel menu.

Easy / Advanced

Template:Versions The mission editor has two modes, easy and advanced. The easy mode simply hides aspects of the mission editor and takes away a lot of the control you have as a skilled designer, but could distract you when new to the editing.

icon editor exit.png Exit

Will exit the mission editor and return to the main menu. Any unsaved work will be lost. A confirmation menu is shown.


Advanced Operations

icon editor functions.png Functions

Template:Versions

Main article: Functions

Functions Viewer show list of scripting functions, both official and community made.

icon editor config.png Config Viewer

Template:Versions

Config Viewer allows to explore games' config files, including list of vehicles, weapons, displays etc.

icon editor debug.png Debug Console

Template:Versions

Main article: Mission Editor: Debug Console

Debug Console allows designer to watch desired values and execute custom codes.


External Editing

Main article: Mission Editor: External

Mission editor provides majority of tools required for designing a mission, but finishing touches are usually made outside of it. Briefings, debriefings, multiplayer settings or final packing are only handled by separate files programs.