Arma: Mod Folders: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "^=+ *[Ii]ntroduction *=+ * *" to "")
m (Text replacement - "{{Feature|Informative|" to "{{Feature|informative|")
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==
__NOTOC__ {{Feature|arma3|While most of the following information is still valid for {{arma3}}, it is recommended to use the [[Arma 3: Launcher]] for mod management.}}


Custom '''modfolders''' is a concept in Operation Flashpoint that allows addon makers and players to  
Custom '''mod folders''' is a concept that was introduced with {{ofp}}. It allows addon makers and players to completely change most aspects of the game.
completely change most aspects of the game.
They were introduced with the release {{ofpr}}, which also became the first total conversion.
They were introduced with the release of the resistance addon, which also became the first total conversion  
[[modification]].
 
It has become a common practice to start mod folder names with a "@" in front of the name to distinguish them from other files in the Operation Flashpoint directory.


{{Feature|informative|It has become a common practice to start mod folder names with a "@" in front of the name to distinguish them from other files in the {{arma}} directory. However, this is '''optional''.}}
[[File:A3 Adding Mod Folders.jpg|right|150]]
=== Making it Work ===
=== Making it Work ===
 
To load and use a mod folder it has to be added to the game's [[:Category: Startup Parameters| Startup Parameters]] "-mod".  
To load and use a modfolder it has to be added to the games [[:Category:Operation Flashpoint: Startup Parameters|startup parameter]] "-mod".  
This is done by creating a new executable shortcut and editing the startup parameters.
This is easiest done by creating a new executable shortcut and editing the startup parameters.


If for example you are trying to load a mod named @test the startup command might look like this:  
If for example you are trying to load a mod named @test the startup command might look like this:  


"C:\Program Files\Codemasters\OperationFlashpoint\FLASHPOINTRESISTANCE.EXE" -mod=@test
{{hl|c= C:\Program Files\Codemasters\OperationFlashpoint\FLASHPOINTRESISTANCE.EXE" -mod=@test}}


To load several mods separate their names with the "''';'''" character.
To load several mods separate their names with the "''';'''" character.<br>
{{hl|c= C:\Program Files\Codemasters\OperationFlashpoint\FLASHPOINTRESISTANCE.EXE" -mod=@test;@test2}}


=== How it Works ===
=== How it Works ===
The "-mod" parameter defines a path the engine will use to load data files when loading the game.
{{Feature|important|If running {{ofp}}, it is important to remember that the ''RES'' mod will automatically be added first to the list of mod folders.}}


The "-mod" parameter defines a path the engine will use to load data files when loading the game. If running OFP, it is important to remember that the RES mod will automatically be added first to the list of mod folders (OFP only).
A mod folder can contain all the data that your {{arma}} install folder can contain. This includes missions, campaigns, and addons subfolders, etc.
A mod folder can contain all the data that your OFP / ArmA install folder can contain. This includes missions, campaigns, and addons subfolders, etc.
The most common use of mod folders is to organize addon .pbo files.
The most common use of modfolders is to organize addon .pbo files.
 
=== Addon modfolders ===
 
Since most players today have a very large number of extra addons installed it has become a common practice to divide them into addon modfolders.
The benefit of this practice is that the engine only has to load the addons in the modfolders specified by the player, lowering memory usage significantly.
To create an addon modfolder simple pick a name and create the directories "@myname\Addons\" in the Operation Flashpoint directory.
Next place all addons you want in this modfolder into this directory and add "@myname" to your "-mod" list when these addons are needed.
 
To make this easier you might wish to create several shortcuts loading different modfolders.
 
The main drawback of this technique is that it is hard for other players in multiplayer games to know what kind of changes you are playing with as modfolders can be used to make beneficial configuration changes to the game, in other words cheat.
 
=== Conflicting addons / addon load order ===
 
In ArmA, it is possible for addons to modify classes in other addons, including those in the game's core "addons". If the user installs two addons that try to modify the same property of a given class (for example, the model property of the basic soldier class), then obviously both addons can not work as intended (together in the same install, that is).
 
In these cases, there is almost nothing that the user can do to determine which addon takes "priority". Inside of the addons themselves is a property called "RequiredAddons", which determines addon load order, regardless of modfolder order.
 
A more in-depth discussion of this can be found [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?s=92417cb935b097d18493c08cc86a3569;act=ST;f=80;t=71959 here].


=== Resources ===
=== Addon Mod Folders ===
Since most players today have a very large number of extra addons installed it has become a common practice to divide them into addon mod folders.
The benefit of this practice is that the engine only has to load the addons in the mod folders specified by the player, lowering memory usage significantly.
To create an addon mod folder simple pick a name and create the directories "@myname\Addons\" in the game's directory.
Next place all addons you want in this mod folder into this directory and add "@myname" to your "-mod" list when these addons are needed.


Alternatively, you can use [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?act=ST;f=4;t=47702 'OFP Mod Selector'], by Operator of Dissidence.
To make this easier you might wish to create several shortcuts loading different mod folders.


[[User:Kegetys|Kegetys]]' launcher available [http://www.andrew.nf/OFP/Tools/launcher218.zip 'here']
The main drawback of this technique is that it is hard for other players in multiplayer games to know what kind of changes you are playing with as mod folders can be used to make beneficial configuration changes to the game, in other words cheat.  


[http://ofp.gamepark.cz/index.php?special=articles/keepitclean.html&newlang=eng Modfolder Tutorial on OFP.info]
=== Conflicting Addons / Addon Load Order ===
Since {{arma1}}, it is possible for addons to modify classes in other addons, including those in the game's core "addons". If the user installs two addons that try to modify the same property of a given class (for example, the model property of the basic soldier class), then obviously both addons can not work as intended (together in the same install, that is).


[http://www.mapfact.net/forum_ofp/viewtopic.php?t=4715&postdays=0&postorder=asc&start=0 Mod-Ordner: wie und warum] German tutorial from Clausewitz in [[Mapfact]] Forum
In these cases, there is almost nothing that the user can do to determine which addon takes "priority". Inside of the addons themselves is a property called "requiredAddons", which determines addon load order, regardless of mod folder order. See [[CfgPatches]].


{{GameCategory|ofp| Startup Parameters}}
{{GameCategory|arma1|Tips}}
{{GameCategory|arma1| Tips}}
[[Category: Startup Parameters]]
[[Category:_Startup_Parameters]]

Latest revision as of 00:25, 2 February 2024

Arma 3
While most of the following information is still valid for Arma 3, it is recommended to use the Arma 3: Launcher for mod management.

Custom mod folders is a concept that was introduced with Operation Flashpoint. It allows addon makers and players to completely change most aspects of the game. They were introduced with the release Operation Flashpoint: Resistance, which also became the first total conversion.

It has become a common practice to start mod folder names with a "@" in front of the name to distinguish them from other files in the Arma directory. However, this is 'optional.
150

Making it Work

To load and use a mod folder it has to be added to the game's Startup Parameters "-mod". This is done by creating a new executable shortcut and editing the startup parameters.

If for example you are trying to load a mod named @test the startup command might look like this:

C:\Program Files\Codemasters\OperationFlashpoint\FLASHPOINTRESISTANCE.EXE" -mod=@test

To load several mods separate their names with the ";" character.
C:\Program Files\Codemasters\OperationFlashpoint\FLASHPOINTRESISTANCE.EXE" -mod=@test;@test2

How it Works

The "-mod" parameter defines a path the engine will use to load data files when loading the game.

If running Operation Flashpoint, it is important to remember that the RES mod will automatically be added first to the list of mod folders.

A mod folder can contain all the data that your Arma install folder can contain. This includes missions, campaigns, and addons subfolders, etc. The most common use of mod folders is to organize addon .pbo files.

Addon Mod Folders

Since most players today have a very large number of extra addons installed it has become a common practice to divide them into addon mod folders. The benefit of this practice is that the engine only has to load the addons in the mod folders specified by the player, lowering memory usage significantly. To create an addon mod folder simple pick a name and create the directories "@myname\Addons\" in the game's directory. Next place all addons you want in this mod folder into this directory and add "@myname" to your "-mod" list when these addons are needed.

To make this easier you might wish to create several shortcuts loading different mod folders.

The main drawback of this technique is that it is hard for other players in multiplayer games to know what kind of changes you are playing with as mod folders can be used to make beneficial configuration changes to the game, in other words cheat.

Conflicting Addons / Addon Load Order

Since Armed Assault, it is possible for addons to modify classes in other addons, including those in the game's core "addons". If the user installs two addons that try to modify the same property of a given class (for example, the model property of the basic soldier class), then obviously both addons can not work as intended (together in the same install, that is).

In these cases, there is almost nothing that the user can do to determine which addon takes "priority". Inside of the addons themselves is a property called "requiredAddons", which determines addon load order, regardless of mod folder order. See CfgPatches.