|
|
| (15 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| == Creating A Multiplayer Campaign In ArmA 3 ==
| | {{TOC|side}} |
| | Below is the list of vegetation in Arma: Reforger, sorted by where they grow. Use this to help you with your terrain creation. |
|
| |
|
| A multiplayer campaign is a series of interconnected missions that follow a sequential order, creating a storyline that groups of players can enjoy together.
| | {| class="wikitable sortable" |
| | |+ Riparian Zone/Wetlands |
| | |- |
| | ! Species !! Common Name !! Form |
| | |- |
| | | Salix fragilis || Crack Willow || Tree |
| | |- |
| | | Salix cinerea || Grey Willow || Bush |
| | |- |
| | | Phragmites australis || Common Reed || Bush |
| | |- |
| | | Populus nigra || Black Poplar || Tree |
| | |} |
|
| |
|
| Key things that a multiplayer campaign will include:
| | |
| *Interconnected sequential missions
| |
| *Centralized location of common mission files to save on storage space
| |
| *Utilizes {{Link|createMPCampaignDisplay|MPCampaignDisplay}}
| |
| *Missions can be selected in the hosted server mission selection menu
| |
|
| |
|
| == Creating the Missions == | | {| class="wikitable sortable" |
| | |+ Forest/Upland Areas |
| | |- |
| | ! Species !! Common Name !! Form |
| | |- |
| | | Picea abies || Norway Spruce || Tree |
| | |- |
| | | Pinus sylvestris || Scots Pine || Tree |
| | |- |
| | | Betula pendula || Silver Birch || Tree |
| | |- |
| | | Carpinus betulus || European Hornbeam || Tree |
| | |- |
| | | Tilia cordata || Littleleaf Linden || Tree |
| | |- |
| | | Sorbus aucuparia || European Rowan || Tree |
| | |- |
| | | Dryopteris filix-mas || Male Fern || Plant |
| | |- |
| | | Pteridium aquilinum || Bracken Fern || Plant |
| | |- |
| | | Vaccinium myrtillus || Bilberry || Plant |
| | |} |
|
| |
|
| If new to creating missions, it is advised that you ignore concerns about disk space and make each mission independent of the campaign mod. When you get more comfortable with how the file structure works, and have more confidence in your code, you can then move on to centralizing common files. Debugging missions within the mod structure is much more annoying, especially if your code is more prone to bugs/errors.
| | |
|
| |
|
| Be sure you structure your missions with multiplayer {{Link|Multiplayer_Scripting#Locality|locality}} in mind from the start. It is much more time-consuming to convert a single-player mission into a multiplayer mission.
| | {| class="wikitable sortable" |
| | |+ Open/Disturbed Areas |
| | |- |
| | ! Species !! Common Name !! Form |
| | |- |
| | | Rosa canina || Dog Rose || Bush |
| | |- |
| | | Rubus idaeus || Raspberry || Bush |
| | |- |
| | | Corylus avellana || Common Hazel || Bush |
| | |- |
| | | Juniperus communis || Common Juniper || Bush |
| | |- |
| | | Sambucus nigra || European Elder || Bush |
| | |- |
| | | Achillea millefolium || Yarrow || Plant |
| | |- |
| | | Arrhenatherum elatius || Tall Oatgrass || Plant |
| | |- |
| | | Urtica dioica || Stinging Nettle || Plant |
| | |} |
|
| |
|
| == File Structure ==
| | |
|
| |
|
| Now that you have your missions created, we can move on to the mod's file structure.
| | {| class="wikitable sortable" |
| | |+ Coastal/Shoreline Areas |
| | |- |
| | ! Species !! Common Name !! Form |
| | |- |
| | | Fucus vesiculosus || Bladderwrack || Plant |
| | |} |
|
| |
|
| <span style="color: blue;">'''myModName'''</span>
| | |
| |--<span style="color: red;">addons</span>
| |
| |--<span style="color: red;">myCampaignAddon</span>
| |
| |--<span style="color: red;">campaign</span>
| |
| | |--<span style="color: red;">missions</span>
| |
| | | |--myMission01.worldName
| |
| | | |--myMission02.worldName
| |
| | | |--myMission03.worldName
| |
| | |--<span style="color: red;">description.ext</span>
| |
| |--<span style="color: green;">data</span>
| |
| |--<span style="color: green;">functions</span>
| |
| |--<span style="color: red;">$PBOPREFIX$</span>
| |
| |--<span style="color: red;">config.cpp</span>
| |
|
| |
|
| <span style="color: red;">Red</span> highlights indicate required files/folders
| | {| class="wikitable sortable" |
| | | |+ Caption text |
| <span style="color: green;">Green</span> highlights indicate optional organization files/folders for shared campaign files
| | |- |
| | | ! Species !! Common Name !! Form |
| == Campaign Description.ext ==
| | |- |
| | | | Malus domestica || Apple Tree || Tree |
| Location: "\myModName\addons\myCampaignAddon\campaign\description.ext"
| | |- |
| | | | Prunus domestica || European Plum || Tree |
| The campaign description file will dictate how the missions are structured within the campaign menus. Unlike a single-player campaign, we are going to be ignoring the mission flow aspect of the campaign description file so that the multiplayer campaign menu functions correctly.
| | |- |
| | | | Tilia cordata || Littleleaf Linden || Tree |
| <syntaxhighlight lang="cpp">
| | |} |
| /* --------------------------------------------------
| |
| Defining Templates for Inheriting Later
| |
| -------------------------------------------------- */
| |
| | |
| // Setting up no endings, cutscenes, or rewards (stuff for single-player campaigns).
| |
| | |
| class NoEndings // For use in chapter class and class MissionDefault.
| |
| { | |
| endDefault = "";
| |
| };
| |
| | |
| class MissionDefault : NoEndings // For use in individual mission classes. | |
| {
| |
| lives = -1; // Not important with/without "Tickets" respawn template.
| |
| noAward = 1;
| |
| cutscene = "";
| |
| };
| |
| | |
| /* --------------------------------------------------
| |
| Actual Campaign Class
| |
| -------------------------------------------------- */ | |
| | |
| class Campaign // Contained inside CfgMissions - Holds other campaign classes such as "Apex", "Bootcamp", "EastWind".
| |
| {
| |
| firstBattle = "Missions"; // This will point to class Missions below which contains no information on purpose
| |
| // so that the mp campaign menu will load all missions.
| |
| // If info is given, no MPCampaignDisplay will be created.
| |
| name = "$STR_CAMPAIGN_TITLE";
| |
| briefingName = "$STR_CAMPAIGN_TITLE";
| |
| author = "Hypoxic";
| |
| overviewPicture = "myOverViewPicture.jpg";
| |
| overviewText = "$STR_CAMPAIGN_DESCRIPTION";
| |
| disableMP = 0;
| |
| | |
| class MyCampaign : NoEndings // Chapter class - Typically only use one chapter when dealing with MP Campaigns.
| |
| {
| |
| firstMission = "myMission01";
| |
| name = "$STR_CAMPAIGN_TITLE";
| |
| cutscene = "";
| |
| end1 = "";
| |
| | |
| class myMission01 : MissionDefault // Mission class - Inherits default settings from class MissionDefault above.
| |
| {
| |
| end1 = "myMission02"; // Default Ending - "end1" call BIS_fnc_endMission will use this mission as next mission.
| |
| myCustomEnd = "myMission01"; // Custom Ending - Defined in mission's class CfgDebriefing - Can be whatever you want.
| |
| lost = "myMission01"; // You can send the lobby back to current mission on loss using this. Can also be custom.
| |
| template = "myMission01.worldName";
| |
| };
| |
| | |
| class MyMission02 : MissionDefault
| |
| {
| |
| end1 = "MyMission03";
| |
| lost = "MyMission02";
| |
| template = "MyMission02.worldName";
| |
| };
| |
| | |
| class MyMission03 : MissionDefault
| |
| {
| |
| end1 = "";
| |
| lost = "MyMission03";
| |
| template = "MyMission03.worldName";
| |
| };
| |
| };
| |
| | |
| class Missions // This is essentially a class with empty values. Used to invoke MPCampaignDisplay - See firstBattle above.
| |
| {
| |
| name = "$STR_CAMPAIGN_TITLE";
| |
| cutscene = "";
| |
| firstMission = "";
| |
| end1 = "";
| |
| end2 = "";
| |
| end3 = "";
| |
| end4 = "";
| |
| end5 = "";
| |
| end6 = "";
| |
| lost = "";
| |
| };
| |
| };
| |
| </syntaxhighlight>
| |
| | |
| {{Feature|important|An error in Description.ext WILL crash your game!}}
| |
| | |
| == Config.cpp ==
| |
| | |
| Config.cpp will contain all of our top level classes we want our mod to modify in-game. In our campaign's case, this will mainly be CfgPatches and CfgMissions
| |
| | |
| | |
| '''CfgPatches'''
| |
| <syntaxhighlight lang="cpp">
| |
| class CfgPatches
| |
| {
| |
| class MyCampaign
| |
| {
| |
| name = "MyCampaign - A Campaign That Campaigns";
| |
| author = "Hypoxic";
| |
| url = "https://arepublixchickentendersubsonsale.com/";
| |
| | |
| requiredVersion = 2.10;
| |
| requiredAddons[] = { // Insert addons that your mod/campaign requires
| |
| "A3_Functions_F"
| |
| };
| |
| units[] = {};
| |
| weapons[] = {};
| |
| };
| |
| };
| |
| </syntaxhighlight>
| |
| If your campaign addon contains units/weapons/etc, add them to units[] and weapons[], just like you would with a normal mod.
| |
| | |
| | |
| '''CfgMissions'''
| |
| <syntaxhighlight lang="cpp">
| |
| class CfgMissions
| |
| {
| |
| class Campaigns
| |
| {
| |
| class MyCampaign
| |
| {
| |
| directory = "\myModName\myCampaignAddon\campaign";
| |
| };
| |
| };
| |
| class MPMissions
| |
| {
| |
| class MyCampaign // Campaign class from above
| |
| {
| |
| briefingName = "$STR_CAMPAIGN_TITLE";
| |
| | |
| class MyMission01
| |
| {
| |
| briefingName = "$STR_M01_MISSION_TITLE";
| |
| directory = "\myModName\myCampaignAddon\campaign\missions\myMission01.worldName";
| |
| };
| |
| | |
| class MyMission02
| |
| {
| |
| briefingName = "$STR_M02_MISSION_TITLE";
| |
| directory = "\myModName\myCampaignAddon\campaign\missions\myMission02.worldName";
| |
| };
| |
| | |
| class MyMission03
| |
| {
| |
| briefingName = "$STR_M03_MISSION_TITLE";
| |
| directory = "\myModName\myCampaignAddon\campaign\missions\myMission03.worldName";
| |
| };
| |
| };
| |
| };
| |
| };
| |
| </syntaxhighlight>
| |
| | |
| == The MPCampaign Display ==
| |
| | |
| [[File:mpcampaigndisplay example filled.png|frame|right|A filled out MPCampaignDisplay]]
| |
| | |
| ==== Defining Values ====
| |
| | |
| # '''Campaign Name''' - Defined In Either:
| |
| ## CfgMissions.MPMissions.MyCampaign.briefingName
| |
| ## Campaign description.ext: Campaign.briefingName
| |
| # '''Mission Name''' - Defined In Either:
| |
| ## CfgMissions.MPMissions.MyMission01.briefingName
| |
| ## Mission description.ext: briefingName
| |
| # '''See #2'''
| |
| # '''Author''' - Defined In:
| |
| ## Campaign description.ext: Campaign.author
| |
| # '''Mission Overview Picture''' - Defined In:
| |
| ## Mission description.ext: overviewPicture
| |
| # '''Mission Overview Text''' - Defined In:
| |
| ## Mission description.ext: overviewText
| |
| | |
| {{Feature|important|Important: Although child classes will precede their parents, its best to be consistent with your naming}}
| |
