====== OFP Mission Editor User Interface ======

[[https://www.pmctactical.org/forum/viewforum.php?f=43|OFP Forum]], [[:ofp|OFP Home]], [[ofp:file_formats|OFP File Formats]], [[ofp:tools|OFP Tools]], [[ofp:missions|OFP Missions]], [[ofp:modeling|OFP 3D Modeling]], [[ofp:terrain|OFP Terrain]]

**Operation Flashpoint (OFP)** aka ArmA: Cold War Assault (CWA)

**OFP Mission Editor User Interface**

This section will take you on a tour of the standard OFP mission editor interface, explaining the menus and how to use them.


====== Easy vs Advanced ======

The mission editor has two modes, easy and advanced. Use advanced. The easy mode simply hides aspects of the mission editor and takes away a lot of the control you have as a designer.

Note the word 'Easy' at the top-right corner. Click on it to switch between the two modes.


====== Mission Controls ======

Mission Controls (the bit on the right).


===== Intel =====

Click the small window with the cloud, the time and date to bring up the intel window.

Here you can name the mission, give a brief description of the tasks, set the date and time, the current and forecast weather and who the Resistance is friendly to.

Giving the mission a name is important, otherwise the briefing will display _cur_sp. The description of the mission is only important for multiplayer games, but putting in some information will help to remind you of what the mission is about when you return to it in the future.

In the weather section, the first slider controls the current weather conditions. All the way to the right is fine sunny weather, all the way to the left is a thunderstorm. The slider underneath controls the current fog levels. Fully left is no fog, fully right is almost zero visibility. The two 'forecast' weather sliders work in exactly the same way.

Note that OFP is highly accurate in its rendering of seasonal patterns. Thus the days will be shorter in Winter, the constellations are seasonally correct as are the moon phases. Tides are also simulated.


===== Load/Save =====

Load/Save. This enables you to load a previously created mission or save the current project.


===== Merge =====

Merge. This will allow you to merge the contents of one mission with those of another. When you use merge, the chosen mission will be copy pasted on top of the current mission in the editor. All player slots are lost in the merge process.


===== Clear =====

Clear. This will wipe the map clean. Use with caution!

The drop-down menu beneath the 'Clear' button shows four options - Mission, Intro, Outro Win and Outro Lose (or 'Outro Loose'). Intros and outros combined with cutscenes can give your mission a more cinematic feel, expanding on the storyline and involving the player. More info required here.


===== Show IDs =====

Show IDs. The map where you design a mission on has trees, bushes, houses etc objects, and each of these is assigned an ID number. These are normally hidden for clarity, and the button toggles them on or off.


===== Show Textures =====

Show Textures. Clicking on this will show you an estimation of what the island will look like when textured, and is only really useful when placing things on a runway at an airport.


===== Preview =====

Preview. This will run the mission from within the editor so that you can test the results as you go along.


===== Continue =====

Continue. If you exit the preview mode (ESC -> Abort), clicking 'Continue' will resume the mission which was in progress. Changes made between will not be shown, and you must click 'Preview' to update the mission.


===== Exit =====

Exit. This will exit to the main menu. Remember to save your work.


====== Map controls ======

**Map controls** (the bit along the top).

These are the controls used for placing things and manipulating them on the map. Click on the required option to select it, then double-click on the map to activate the dialog.


===== Units =====

**Side** - There are four 'sides' in OFP which units can be assigned to: West, East, Resistance and Civilian. The last two are usually thought of as the same thing, the Resistance being armed Civilians. West will always fight East, and vice verse. The Resistance fights either West, East or none (see the Intel dialog).

**Class** - This is the kind of unit you are placing. It can be confusing, as tanks are units, ammoboxes are units, even tables are units. However, the Class field is split into categories to make things easier for us mission editors. Soldiers are found in the 'Men' Class.

**Control** - This defines who controls the unit. For now, think of this as either the player or the computer.

**Info Age** - When an enemy unit is reported to a commander an icon appears on the map. The accuracy of this position depends on the Info Age.

**Vehicle Lock** - If the unit is a vehicle, this defines whether the player can use it or not.

**Rank** - This defines how high up the command structure the unit is. Lower ranked units can be grouped to higher ranked units.

**Unit** - This is the type of unit within the Class field that you want to place, for example if the Class is 'Armour' the Unit would be the type of tank, if the Class is 'Men' then the Unit would be the type of soldier.

**Special** - Units will be placed 'In Formation' by default. If you wish to place them independently, choose 'None' from this list. Be aware that if a unit is part of a group, it will try to return to formation when the mission begins. If the unit is an aircraft, selecting "Flying" will put it in the air. If the group which the unit is a part of includes a vehicle with cargo spaces, choosing "In Cargo" will place the unit in one of those cargo spaces. Remember that this control defines the starting position for the units at the very beginning of a mission. They can be manipulated later.

**Name** - This is a very useful field. Whatever you put in this field can be used as a name to reference the unit later on in scripts. Like all variable names, you should make it something meaningful.

**Skill** - At highest skill units will see farther, shoot more accurately and be generally more devious. At lowest skill units will be less observant, poor marksmen and generally stupid. Skill will be automatically set on choosing a unit, but you can tweak the settings for your own purposes.

**Initialization** - This is where you can put script commands to further define the unit's properties. Anything put in this field will take effect at the very beginning of the mission. More on this later.

The next three sliders, **Health/armor, Fuel** and **Ammunition** define how much of each the unit has at the start of the mission. If you put the Health/armor slider to 0, the unit will start the mission dead.

The **Azimuth** setting defines which direction the unit will be facing. You can drag the pointer around the circle, or type in the number of degrees.

**Probability of Presence** (PoP) defines how likely it is that the unit will be present. This can be used to add a bit of randomness to missions. A maximum PoP will ensure the unit is always there. A PoP of 0% means the unit will never appear.

**Condition of presence** relies on some other factor to decide whether or not the unit appears in the mission. By default this reads 'true' which means it will appear, but for example if you wanted to have the unit appear only if the user's benchmark was over 5000, you could insert
<code>
benchmark > 5000;
</code>

Finally, **Placement Radius** defines an area within which the unit's starting position could be, in meters.


===== Groups =====

Instead of placing individual units and grouping them manually, you can create groups intact.

**Side** - again, this declares the side of the group: West, East or Resistance.

**Type** - the type of group, e.g. infantry, armor or mobile infantry.

**Name** - kind of group. For example if you chose an armored group, it could be a group of M1A1 tanks, or a group of M60 tanks.

**Azimuth** - the direction in which the group is facing.


===== Triggers =====

Triggers are used to define the consequences of a certain event depending on the conditions specified, e.g. you want the enemy to raise the alarm when the player is spotted, or you want a convoy to begin moving when the player gives a radio command.

**Axis a/Axis b** - these controls define the size of the trigger in metres. Axis a is West-East, Axis b is North-South.

**Angle** - the angle of the trigger. It can be set within the dialog, but for more control click and hold the trigger on the map and hold down the left Shift key. Then move the mouse around until the trigger is at the correct angle.

**Ellipse/Rectangle** - the shape of the trigger.

**Activation** - this is a list of who or what can activate the trigger, for example a unit of a certain side, or a radio command.

**Once/Repeatedly** - how many times the trigger can be activated.

**Present/Not Present** etc - if the activator is a unit or a side, you can control the condition on which the trigger fires. For example, if you want the trigger to activate when any West unit enters it, select 'West' from the Activation list, and 'Present'.

**Countdown/Timeout** - These can add a degree of randomness to triggers.

Next to the Countdown and Timeout buttons you will see three boxes; Min, Max and Mid. These define the period of trigger activity in seconds between the Min and Max values, gravitating towards the Mid value. If all three were 10, then the period would be 10 seconds, with no randomness. If Min was 5, Max was 15 and Mid 10, the period would be somewhere between 5 and 15 seconds, close to 10.

Choosing Countdown means that once the trigger's conditions are met (the soldier walks into the trigger area) the trigger will wait the specified amount of time before activating the consequences (the alarm is raised).

Choosing Timeout means that the trigger's conditions must be met for the duration of the specified amount of time before the trigger fires. So for example, if the soldier walks into the trigger area, and then leaves the area before the timeout is complete, the trigger will not fire.

**Type** - there are several types of trigger.

  * Guarded by - this creates an area to which the side specified will go when an enemy is detected within them. Units or groups given a Guard waypoint will automatically support these areas.
  * Switch - this is useful for breaking units or groups out of looping waypoints.
  * End # - this type of trigger will end the mission once the conditions are met. There are 6 winning endings plus a losing ending.

**Text** - the text displayed within the editor to identify what the trigger is.

**Name** - a name by which the trigger can be accessed through script.

**Condition** - usually reads 'this', which means the conditions you create within the dialog. The Condition field can contain multiple conditions.

**On Activation** - script that is executed when the trigger conditions are met.

**On Deactivation** - script that is executed when the trigger conditions have been met, but are no longer true, for example when a soldier leaves a 'Present' trigger.


===== Waypoints =====

Waypoints (WP) are what make units and groups move and are one of the most powerful tools within the mission editor. Some (e.g. Move, Cycle, Hold) can be put anywhere, others (e.g. Destroy, Get in) work best when placed on an object or vehicle.

**Select Type** - there are several types of waypoint.

  * Move - unit or group will move to this point.

A note on MOVE (and most other WPs, if not all) WP: If you put the WP on certain buildings (on the map: lighter boxes and select churches) there will be a new box that states what position that unit goes to inside the building. it will be under the "Behavior" box on the "Insert/Edit Waypoint" menu. It is listed as "Position In House" with a drop box next to it. Most positions are next to windows. But use common sense. A tank can't roll upstairs and hide just inside a window, and a UH-60 can't even begin to squeeze through the front door. So it is for personnel-based units.

  * Destroy - unit or group will move to this point and destroy whatever the waypoint is placed upon. Do not expect units to obey this waypoint if they are incapable of destroying the target (rifleman vs. tank). The waypoint will not be complete until the target is destroyed or if the unit refuses the order.
  * Get in - if placed over a vehicle with extra room, the unit will attempt to board it. If synchronized with a vehicle’s waypoint, the vehicle will stop and wait to be boarded.
  * Seek & Destroy - unit or group will move to this point and begin searching for enemies.
  * Join - When synced with another unit’s waypoint, this individual will become part of that unit's group.
  * Join & Lead - Same as above, but the individual becomes that group’s leader.
  * Get out - unit or group controlling vehicle will disembark.
  * Cycle - very useful waypoint; orders the unit to consider the nearest waypoint its next waypoint, creating a waypoint loop. Good for patrols.
  * Load - vehicle will wait for units to board in cargo.
  * Unload - vehicle will wait for units in cargo to leave vehicle.
  * Transport Unload - vehicle will wait for units which began in vehicle to leave cargo.
  * Hold - unit or group will stay at this position. Only a 'switch' trigger or scripting can move the group from this point.
  * Sentry - The unit will hold position until any member spots an enemy. At that point, the unit will proceed to their next waypoint. If the unit is not set to hold fire, they may engage the enemy on the way.
  * Guard - if a 'Guarded By' trigger is located nearby the group will move to and protect it. Additional information on the use of this waypoint can be found here.
  * Talk - Used in combination with the “effects” button on the bottom of the waypoints screen. If you set the sounds:voice section to a voice, the unit leader will say the given phrase. This waypoint is not a destination, and goes to the next waypoint when the phrase is completely spoken.
  * Scripted - executes the script that is in the “script” box on the bottom of the waypoints screen. You can not use individual script commands, you must refer to an external script file. This waypoint is not a destination, and it is considered complete when the external script reaches its EXIT command.
  * Support - A very useful waypoint; any unit given this waypoint will remain here until another unit calls for support. At this time, the waiting unit will proceed to the location where support was called for. Only medics, ambulances, fuel and ammo supply vehicles can use this waypoint. You can tell medics to board vehicles prior to this WP, and they will drive to the support call.


===== Markers =====

Markers appear on the map and are essential for directing the player to mission areas. They can also be changed using script.

**Name** - this will be the marker's unique identifier.

**Icon/Rectangle/Ellipse** - the type or shape of the marker.

**Color** - the colour the icon will be.

**Icon** - if you choose the 'Icon' style of marker, this will offer a choice of icons.

**Axis a/Axis b** - the size of the marker, default is 1.

**Angle** - the angle of the marker.

**Text** - any text you wish to appear next to the marker.