ArmA 3 Mission Creating

From Wiki

Jump to: navigation, search

Contents


About

So you want to create an ArmA3 mission, then the following sections will help you with some basic script examples.

Minimum Tools

The best tool to edit all of the files you need to use Notepad++ with the plugin Notepad++ SQF syntax highlight added to your installation.

To install Notepad++ SQF syntax highlight copy the included xml file into the main notepad++ folder:

WINDOWS 7: C:\program files(x86)\notepadd++

Open Notepad++ go to > Language > Define your own Language > Import > included xml file

Restart Notepad++ and then go to > Language > ArmA3

So what you end up with is something like:


File:notepad++1.jpg‎ A2:OA image will update at some point


The reason is fairly obvious (I hope) but let's list a few:

  • Line numbers so you can see where errors respond to
  • Project manager so you can select any file wihtin that project easily
  • Remarks either using // or /* */ can be seen easily in green
  • Open and close brackets can be seen in red when you select next to one
  • Other syntax is colour so you can easily see what is going on

Format

Some basic missions will be provided which cover some areas that are useful for missions, along with some basic guidelines on each one.

Additional startline parameter

You should also use the custom argument box (if using AddonSync) to add the startline parameter -showscripterrors which when you preview your mission you will see any errors appear on screen.


File:showscripterrors.jpg‎ A2:OA image will update at some point

Important file to check

One of the most important files that you need to ceck when testing is the arma3.rpt file which will show all errors.

There should be no errors in your RPT file when you test the mission ready for release.

This can be found in these default locations (may be hidden):

WINDOWS 7: C:\users\{username}\AppData\Local\ArmA 3 Alpha

An example of an RPT file with some errors (A2:OA rpt will update at some point):

=====================================================================
== C:\Program files\Bohemia Interactive\ArmA 2\expansion\beta\Arma2OA.exe
== "C:\Program files\Bohemia Interactive\ArmA 2\expansion\beta\Arma2OA.exe"  "-connect=" -port=2302 -nosplash -world=empty  -nopause "-name=[RIP]BearBison" -showscripterrors
=====================================================================
Exe timestamp: 2010/10/29 19:19:06
Current time:  2010/10/31 12:02:45

Version 1.54.74630
Item str_disp_server_control listed twice
File description.ext, line 9: '.onloadmission': Missing ';' at the end of line
File description.ext, line 21: '/Weapons/M16A4_ACG.count': Missing ';' at the end of line
File description.ext, line 7: '.respawn': Missing ';' at the end of line
File description.ext, line 0: '.disabledAI': Missing ';' at the end of line
File Res\Spectating.hpp, line 11: '/rscSpectate/controls/mouseHandler.onMouseZChanged': Missing ';' at the end of line

|=============================   CO16_TIFOR_1_BAF_v0-1   =============================|

Error in expression <kistan\scripts\WheelChange.sqf"
if (isDedicated) exitWith {};
canSee >
  Error position: <if (isDedicated) exitWith {};
canSee >
  Error Missing ;
File C:\Users\Rich\Documents\ArmA 2 Other Profiles\[RIP]BearBison\mpmissions\CO16_TIFOR_1_BAF_v0-1.Takistan\scripts\WheelChange.sqf, line 9
Creating debriefing

This shows:

  • Some of the missions in my MPMissions folder or cache have errors in them, all are Missing ';' at the end of line
  • Shows where my mission starts
  • The mission I am testing has an issue where it is missing a ; on line 9 (note that sometimes the error may be caused by whatever calls the script having an error.

Useful links and resources

OLD ArmA2 links still very valid

Creating Image files for use in missions

For any images in game the file format should be .paa to stop any problems occuring.

The file resolution is 256x256 for flag and sign images and 512x256 for loadscreen images.

To convert into .paa format the easiest tool is TexView 2 which can be downloaded here. To prevent issues it is normally better to import from .png into TexView 2 and then save as .paa.

A full manual for TexView 2 can be found here.

Templates

Using these templates on another island (or with other templates) is fairly easy, what you do is (always start with the Basic Mission Template):

  • select Merge from the menu
  • select the Island
  • select the Template
  • select OK to add to your mission
  • Then copy the relevant script files and any other config changes to your mission.


File:merge.jpg‎ A2:OA image will update at some point

Basic Mission Template

This is a basic mission template which if used will ensure your mission is compatible with multiplayer (MP) and join in progress (JIP) clients.

ArmA 3 Mission Creating - Basic Mission Template

Player Marker Template

This template adds individual markers to players and a group marker to the leader.

ArmA 3 Mission Creating - Player Marker Template

Player Gear Template

This template removes all player weapons, magazines, items and clothing and allows you to specify a new loadout.

ArmA 3 Mission Creating - Player Gear Template

RV Template

This template adds the ability to use an object as a mobile rendez-vous (RV) point for players spawning into the game placed by the group leader.

ArmA 3 Mission Creating - RV Template

Ammobox Loadout Template

This template covers replacing the contents of an ammobox with a custom loadout.

ArmA 3 Mission Creating - Ammobox Loadout Template

Compass Heading Template

This template adds the ability to have a digital compass heading (bearing) in a hint box.

ArmA 3 Mission Creating - Compass Heading Template

=BTC= Revive Template

This template which will show you how to place and setup the excellent =BTC= Revive script.

ArmA 3 Mission Creating - =BTC= Revive Template

Refuel Object Template

This template which adds the ability to use an object for refueling vehicles.

ArmA 3 Mission Creating - Refuel Object Template

Repair Object Template

This template which adds the ability to use an object for repairing vehicles.

ArmA 3 Mission Creating - Repair Object Template

Increased Fuel Consumption Template

This template which adds the ability to set all vehicles for a higher fuel consumption rate.

ArmA 3 Mission Creating - Increased Fuel Consumption Template


NOTE:
This page will be WIP for a long time.
Any links in RED mean the page is planned just not released yet.

Building Positions Template

This is a template which will allow you to place your units in an exact position within a building.

ArmA 3 Mission Creating - Building Positions Template

Improved Patrol Task Template

This is a template which will allow the AI the use of an improved task patrol script.

ArmA 3 Mission Creating - Improved Patrol Task Template

Building Patrol Template

This is a template which will add the ability for enemy AI to patrol a building.

ArmA 3 Mission Creating - Building Patrol Template

ATV Flip Template

This is a template which will add an action to an ATV if it is not upright to allow you to flip it over and continue driving.

ArmA 3 Mission Creating - ATV Flip

Wheel Changing Template

This is a template that will allow an action to be added to repair damaged wheels.

ArmA 3 Mission Creating - Wheel Changing Template

Flags and Signs Template

This is a template that shows you how to add custom graphics to flags and signs.

ArmA 3 Mission Creating - Flags and Signs Template

Halo and Parachute attach/pack Template

This is a template that shows you how to add Halo to the C130 in a static location (to aid JIP, also prevents use of the Eject feature), also a little script to add a parachute to a box to simulate it being dropped and having landed with the option to pack the chute.

ArmA 3 Mission Creating - Halo and Parachute Template

Vehicle Service Areas Template

This is a template that places fully working service and rearm areas.

ArmA 3 Mission Creating - Vehicle Service Areas Template

Static Reload Template

This is a template that allows you to use ammo boxes to rearm static weapons once and then the box disapears.

ArmA 3 Mission Creating - Static Reload Template

IED Template

This is a template that shows a couple of different options to use any object as an IED with various options.

ArmA 3 Mission Creating - IED Template

Personal tools