Mission Export: Difference between revisions
mNo edit summary |
Lou Montana (talk | contribs) m (Text replacement - "{{ExternalLink|" to "{{Link|") |
||
(30 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
Two export methods are available, both with certain pros and cons. | {{TOC|side}} | ||
Two export methods are available, both with certain pros and cons. | |||
== Mission Format == | == Mission Format == | ||
Multiplayer missions are sent by server to every connected user, occasionally leading to increased bandwidth. | Older export variant working since [[Arma: Cold War Assault]]. Mission [[PBO]] contains only mission folder itself and additional options are limited, e.g. you cannot have multiple missions in one file and in case you need mission specific addon, it has to be created separately. | ||
Multiplayer missions are sent by server to every connected user, occasionally leading to increased bandwidth. It's recommended not to use any large files (pictures, sounds, ...) to prevent it. | |||
File itself is always named in following format | File itself is always named in following format | ||
{{Color|green|<mission name>}}.{{Color|green|<world name>}}.pbo | |||
Examples: | Examples: | ||
TopGun.abel.pbo | TopGun.abel.pbo | ||
Line 14: | Line 17: | ||
World name matches the class in ''CfgWorlds''.pbo | World name matches the class in ''CfgWorlds''.pbo | ||
=== Installation === | |||
Put missions/campaigns in following folders or in folders of the same names in [[Arma: Mod Folders|mod subfolders]]. | |||
==== Singleplayer Missions ==== | ==== Singleplayer Missions ==== | ||
{{Color|green|%ROOT%}}\Missions | |||
==== Multiplayer Missions ==== | ==== Multiplayer Missions ==== | ||
{{Color|green|%ROOT%}}\MPMissions | |||
==== Campaigns ==== | ==== Campaigns ==== | ||
{{Color|green|%ROOT%}}\Campaigns | |||
=== Export === | |||
==== Ingame ==== | ==== Ingame ==== | ||
# When in mission editor, click on [[Mission_Editor#Save_As|Save]] button. | # When in mission editor, click on [[Mission_Editor#Save_As|Save]] button. | ||
# Select 'Export to single-missions' or 'Export to multiplayer missions', depending on type of your mission | # Select 'Export to single-missions' or 'Export to multiplayer missions', depending on type of your mission | ||
Mission [[PBO]] was created in Missions or MPMissions folder in the game's root. | Mission [[PBO]] was created in Missions or MPMissions folder in the game's root. | ||
* You can publish the mission directly from Editor in [Arma 3] to {{Link|link= http://steamcommunity.com/workshop/browse?appid=107410|text= Steam Workshop}} . Click on the Steam icon and provide necessary data: name, description, tags and image. | |||
==== External ==== | |||
#Pack [[Mission_Editor:_External#Mission_Folder|mission folder]] using [[BinPBO]] or other preferred packing tool. | |||
{{ArgTitle|2|Addon Format|| | |||
{{GVI|arma1|1.00}} | |||
{{GVI|arma2|1.00}} | |||
{{GVI|arma2oa|1.50}} | |||
{{GVI|arma3|0.50}} | |||
{{GVI|tkoh|1.00}}}} | |||
[[:Category:ArmA: Armed Assault|{{arma1}}]] introduced mission export based on addon structure, giving designers more control of PBO structure. | |||
Missions or campaigns can be grouped in single PBO (like official missions) or with other supporting addons like new objects or functions. | |||
[[ | |||
| | |||
Multiplayer missions has to be installed before the game is run. | Multiplayer missions has to be installed before the game is run. No file size limitations exists. | ||
=== Installation === | === Installation === | ||
Put missions/campaigns in following folder or in folder of the same names in [[Arma: Mod Folders|mod subfolders]]. | |||
{{Color|green|%ROOT%}}\Addons | |||
=== Export === | === Export === | ||
[[File:BinPBO.jpg|thumb|BinPBO]] | [[File:BinPBO.jpg|thumb|BinPBO]] | ||
<ol> | <ol> | ||
<li>Create folder with name of the addon (example: ''MyMission'')</li> | <li>Create folder with name of the addon (example: ''MyMission'')</li> | ||
<li>Copy [[Mission_Editor:_External#Mission_Folder|mission folder]] into the addon folder (example: ''MyMission\MissionFolder.World'')</li> | <li>Copy [[Mission_Editor:_External#Mission_Folder|mission folder]] into the addon folder (example: ''MyMission\MissionFolder.World'')</li> | ||
<li>Create [[Config.cpp]] in addon folder with [[CfgMissions]] | <li>Create [[Config.cpp]] in addon folder with [[CfgPatches]] and [[CfgMissions]] classes (example: ''MyMission\config.cpp'') | ||
< | <syntaxhighlight lang="cpp"> | ||
class CfgPatches | |||
{ | |||
class MyAddonClass | |||
{ | |||
units[] = {}; | |||
weapons[] = {}; | |||
requiredVersion = 1.0; | |||
requiredAddons[] = {}; | |||
}; | |||
}; | |||
class CfgMissions | |||
{ | { | ||
class Missions | class Missions | ||
Line 68: | Line 86: | ||
}; | }; | ||
}; | }; | ||
};</ | }; | ||
<li>Pack addon folder using [[BinPBO]] or other | </syntaxhighlight></li> | ||
<li>Pack addon folder using [[BinPBO]] or other preferred packing tool. It's recommended '''not''' to binarize it.</li> | |||
</ol> | </ol> | ||
Line 75: | Line 94: | ||
== Format Comparison == | == Format Comparison == | ||
{| class="wikitable" | {| class="wikitable" style="text-align: center" | ||
! Feature | ! style="min-width: 20em" | Feature | ||
! Mission Format | ! Mission Format | ||
! Addon Format | ! Addon Format | ||
|- | |- | ||
| style="text-align: left" | Ingame Export | |||
| style="text-align: | | {{Icon|checked}} | ||
| {{Icon|unchecked}} | |||
|- | |- | ||
| style="text-align: left" | External Export | |||
| style="text-align: | | {{Icon|checked}} | ||
| {{Icon|checked}} | |||
|- | |- | ||
| style="text-align: left" | Multiple missions in one file | |||
| style="text-align: | | {{Icon|unchecked}} | ||
| {{Icon|checked}} | |||
|- | |- | ||
| style="text-align: left" | Custom addon in mission file | |||
| style="text-align: | | {{Icon|unchecked}} | ||
|{{Icon|checked}} | |||
|- | |- | ||
| style="text-align: left" | Localized mission name | |||
| style="text-align: | | {{Icon|unchecked}} | ||
| {{Icon|checked}} | |||
|- | |- | ||
| style="text-align: left" | Designer controlled subfolders | |||
| style="text-align: | | {{Icon|unchecked}} | ||
| {{Icon|checked}} | |||
|- | |- | ||
| style="text-align: left" | User controlled subfolders | |||
| style="text-align: | | {{Icon|checked}} | ||
| {{Icon|unchecked}} | |||
|- | |- | ||
| style="text-align: left" | Ingame download of MP mission | |||
| style="text-align: | | {{Icon|checked}} | ||
| {{Icon|unchecked}} | |||
|} | |||
[[Category: | [[Category: 2D Editor]] | ||
Latest revision as of 16:22, 4 January 2023
Two export methods are available, both with certain pros and cons.
Mission Format
Older export variant working since Arma: Cold War Assault. Mission PBO contains only mission folder itself and additional options are limited, e.g. you cannot have multiple missions in one file and in case you need mission specific addon, it has to be created separately.
Multiplayer missions are sent by server to every connected user, occasionally leading to increased bandwidth. It's recommended not to use any large files (pictures, sounds, ...) to prevent it.
File itself is always named in following format
<mission name>.<world name>.pbo
Examples:
TopGun.abel.pbo SpyGame.Chernarus.pbo Domino.ProvingGrounds_PMC.pbo
World name matches the class in CfgWorlds.pbo
Installation
Put missions/campaigns in following folders or in folders of the same names in mod subfolders.
Singleplayer Missions
%ROOT%\Missions
Multiplayer Missions
%ROOT%\MPMissions
Campaigns
%ROOT%\Campaigns
Export
Ingame
- When in mission editor, click on Save button.
- Select 'Export to single-missions' or 'Export to multiplayer missions', depending on type of your mission
Mission PBO was created in Missions or MPMissions folder in the game's root.
- You can publish the mission directly from Editor in [Arma 3] to Steam Workshop . Click on the Steam icon and provide necessary data: name, description, tags and image.
External
- Pack mission folder using BinPBO or other preferred packing tool.
Armed Assault introduced mission export based on addon structure, giving designers more control of PBO structure. Missions or campaigns can be grouped in single PBO (like official missions) or with other supporting addons like new objects or functions.
Multiplayer missions has to be installed before the game is run. No file size limitations exists.
Installation
Put missions/campaigns in following folder or in folder of the same names in mod subfolders.
%ROOT%\Addons
Export
- Create folder with name of the addon (example: MyMission)
- Copy mission folder into the addon folder (example: MyMission\MissionFolder.World)
- Create Config.cpp in addon folder with CfgPatches and CfgMissions classes (example: MyMission\config.cpp)
class CfgPatches { class MyAddonClass { units[] = {}; weapons[] = {}; requiredVersion = 1.0; requiredAddons[] = {}; }; }; class CfgMissions { class Missions { class MyMissionClass { directory = "MyMission\MissionFolder.World"; }; }; };
- Pack addon folder using BinPBO or other preferred packing tool. It's recommended not to binarize it.
Format Comparison
Feature | Mission Format | Addon Format |
---|---|---|
Ingame Export | ||
External Export | ||
Multiple missions in one file | ||
Custom addon in mission file | ||
Localized mission name | ||
Designer controlled subfolders | ||
User controlled subfolders | ||
Ingame download of MP mission |