Template Setup - Theseus-Aegis/MissionTemplate GitHub Wiki
This page will guide you on making your first mission with Theseus.
Working with External Files
To open any files with the following extensions:
.cpp
.ext
.hpp
.sqf
.sqm
Regular Notepad shall not be used! There are multiple alternatives and two of the most common are Visual Studio Code (with SQF extension) and Notepad++ (older and slimmer).
These can help by utilising Syntax highlighting and code formatting features.
The Template
Navigate to the Template release and download the Zip file.
Once it has been downloaded keep it somewhere easily accessible until a new release. Unzip the file and inside you will see the following:
/Images/MissionSetup/TemplateFolder.png
Mission File
To actually utilise the template you first need to have saved a mission. Then open the Editor on the map you wish to make your mission on, then CTRL+S
and make sure you save it to MPMissions
not just Missions
to avoid confusion in the Wiki.
The next step is to Navigate again to your profile folder in your documents.
My Documents
> Arma 3 - Other Profiles
> Your%20Name
> MPMissions
> YourMissionName.MapName
And inside the Mission Template folder you downloaded open the template
folder. Here you will see a list of files:
/Images/MissionSetup/ContractTemplate.png
Note: The file layout may change but the method will remain the same.
Copy every file and folder from inside here into your MPMissions
> YourMissionName.MapName
folder. The folder should only contain one file named mission.sqm
before you paste the template, Do NOT delete the mission.sqm
file.
Compositions
The first folder inside the template is "compositions", these make placing Theseus based assets easy to achieve. There are 2 sub-folders which are named
contract
(Contract Compositions)extra
(Extra Compositions)sog
(S.O.G CDLC Compositions)
The "Contract Compositions" are the necessary ones, "Extra Compositions" are potentially useful tools.
/Images/MissionSetup/CompositionsFolder.png
Note: Over time the amount of compositions may change, but the steps will not.
To be able to access these compositions in-game, Copy everything inside the contract
(Contract Compositions) folder and navigate to
My Documents
> Arma 3 - Other Profiles
> Your%20Name
> Compositions
Paste the files into here.
Binarizing and Layering
The game automatically binarizes the mission.sqm
file upon saving. This shall be disabled, as removing mods from the modpack could result in you being unable to load your mission without redownloading and enabling the removed mods. Additionally it allows quick fixes to be made without opening the Editor.
Update 2.0 for Arma also added another setting named "Automatic Composition Layering" when placing the template this always messes up the role select by having some of the playable units in a layer and leaving the others out of it.
There are 2 methods of turning both settings off.
Editor Method: When in the editor, navigate to the top bar > Settings > Preferences (Or CTRL+K) and uncheck "Binarize New Scenario Files" (Note: this will not unbinarize any currently saved missions.) and "Automatic Composition Layering"
To unbinarize a currently made mission file navigate to the top bar > Attributes > General > Uncheck "Binarize the Scenario File" then save the mission again.
Profile Method:
Navigate to your profile
My Documents > Arma 3 - Other Profiles > Your%20Name >
If you have been working with the editor before you will have a file named: Your%20Name.3den.Arma3Profile
Open this with a text editor, inside if you already have a class EngineAttributes
line you can overwrite it with the code snippet below.
class EngineAttributes
{
saveBinarized=0;
placeCompositionInLayer=0;
};