PMC Editing Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== OFP to ArmA 2 Port Tutorial ======

[[https://www.pmctactical.org/forum/viewforum.php?f=50|ArmA 2 Forum]], [[:arma2|ArmA 2 Home]], [[arma2:config|ArmA 2 Config]], [[arma2:file_formats|ArmA 2 File Formats]], [[arma2:missions|ArmA 2 Missions]], [[arma2:modeling|ArmA 2 3D Modeling]], [[arma2:scripting|ArmA 2 Scripting]], [[arma2:terrain|ArmA 2 Terrain]], [[arma2:texturing|ArmA 2 Texturing]], [[arma2:tools|ArmA 2 Tools]]

This tutorial shows you how to port your addon from OFP to ArmA 2. Also know as how to convert OFP addon / mod. See also [[arma2:port_arma|port ArmA addon]].

This tutorial will not help you to optimize your addon, it just tells you what to do to get your addon working in-game.


====== Unpack PBOs ======

First take the OFP addons in pbo format and unpack them into your work directory (up to you where this is, it might be the ArmA 2 tools directory in P: or any temp dir). Use Kegetys's cpbo or Mikero's ExtractPbo tools to unpack pbos. Easy way to unpack all pbo's in the dir is to call extractpbo from runme.bat file like this:
<code dos>
for %%x in (*.pbo) do (\path\to\extractpbo %%x)
</code>
Which would unpack all found pbo's in the current dir.


====== Convert ODOL -> MLOD ======

We proceed by converting the P3D models to MLOD format (we assume they are binarized ODOL format at start). Do this by using [[ofp:tools:odol_explorer|ODOL Explorer]] (OdEx). Load up the model, click Save MLOD and overwrite the existing model. Exit OdEx and choose next model.

Its not certain would OdEx save the models properly if you did not restart it between models, but at least it gives you piece of mind that there was nothing faulty going on in the conversion process of models.


====== Preparing MLOD models ======

Before ArmA 2 can read the OdEx saved MLOD models, you need to load them up in [[arma2:tools:oxygen2|O2]] and save again. It does not matter if its ArmA or ArmA 2 O2 you will be using, both of them saves the proper format.


====== Missing Textures ======

Most likely you end up with few to many missing textures from OFP dirs like "data" or "o" and its sub dirs. You simply have to track down all these texture names, use Mikero's MoveObject to change the paths in P3D's and finally copy all the OFP textures into the specified dir on your ported addon.

This is example batch file to go through all P3D's and map "data" dir into myAddon\data\t\ directory:
<code dos>
for %%x in (*.p3d) do (\path\to\moveobject.exe "%%x" data\ myAddon\data\t\ >>log.txt)
</code>
Notice the "log.txt" at the end, it is very useful for you to track down what MoveObject did, in fact you can use this log text file to scan the replaced textures.


====== Prepare Configs ======

To prepare OFP config.cpp files for ArmA 2 use, one could say that in the first lines what you encounter is the requiredVersion. In OFP you usually have this:
<code cpp>
requiredVersion = 1.96;
</code>

But for ArmA 2 you need to set it to:
<code cpp>
requiredVersion = 1;
</code>
There is really no point of setting it to specific version number, as you always (trust me; Always) get some user to come whine that why this addon doesn't work in v?.? etc.


===== WRP =====

Regarding WRP terrains, this is one simple example how to port OFP config:

**OFP:**
<code cpp>
 	class DefaultWorld{};
	class Eden: DefaultWorld{};
	class myTerrain: DefaultWorld
</code>
This needs to be replaced simply with:

**ArmA 2:**
<code cpp>
	class Utes;
	class myTerrain: Utes
</code>

Comment out all **class CfgSurfaces** because it most likely causes problems.


====== Prepare WRP ======

Load WRP in [[ofp:tools:wrptool|WrpTool]]. Go to texture mode, select all CTRL-A and then use CTRL-T to bring up texture browser. Alick Add New, then choose for example o\b1.pac texture, use Add to Browser button. Then choose the new texture from the browser, then press SHIFT-LMB somewhere on the selected red cells on map view. Now this new o\b1.pac texture is set as ground texture. Save WRP.

Start your favorite hex editor, load up the WRP and change the o\b1.pac texture to whatever rvmat you wish to use in your terrain for ground texture. More of the WRP single texture details can be found on the PMC WRP tutorial.


====== Errors from RPT file ======

[[arma2:arma2.rpt|ArmA2.rpt]] file is very good to track down why your addon is not working. Usually it gives you clear indication of the cause of a crash. When you test your addon, open up RPT file to search for clues what models/textures/configs might cause problems.