====== ArmA 2 Beginner Editing Guide ====== [[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]] **ArmA 2 Beginner Editing Guide** by PMC This guide //should// get a complete newbie into ArmA 2 editing. While it might not do Newbie -> Hardcore conversion, it is still vital for anyone getting into editing. While this is not a tutorial to get some specific task done, its the core essence of editing, if you don't know absolutely anything, this will get you started. If anyone wants to join PMC team to work on some of our addons/mods, we would teach beginners each step of addon making, it would be great learning experience. You could then use these learned skills to make your own addons/mods. If you are interested, get in touch with us [[https://www.pmctactical.org/|PMC Tactical]]. ====== PBO's what are these? ====== PBO files are addons in a packet. PBO files are located in the \addons\ directory, or in any directory you specify to be used with the -mod parameter. More info in [[arma:startup_parameters|startup parameters]] and in [[arma:moddirs|mod folders]] pages. Don't confuse the pbo files to the .pbo.bi.bisign as those are the signature key files for multiplayer purposes. ====== Config.cpp (or .bin) what is it? ====== Config.cpp is the games configuration file for the given addon. Config.cpp can be also found in the \bin\ directory which is the games main configuration file. Config.cpp is what makes the addon work. If config.cpp file is binarized it will become "config.bin" and cannot be read with text editor. You can create text format config.cpp file from the .bin file with deRapify tool. You really don't have to worry about creating bin out of cpp file right now. Config.cpp file can be (usually) found on each addon's PBO root directory. ====== P3D's what are they? ====== P3D files are the 3D models. P3D files can be found really in any dir, in BIS addons they are //usually// in the root of the PBO file. ====== Textures? ====== Textures are in .paa or .pac file name extensions. Also .rvmat files are sort of textures, as they control many things related to the materials and stuff, while these aren't specifically textures, they are absolutely related to textures. Textures can be found in any dir but in BIS addons they are under data\ directory. ====== Terrains? ====== Terrains are always in WRP files, like chernarus.wrp for Chernarus. Terrains are edited in Visitor 3. You need to create elevation's for your terrain, this can be done either in [[:tools:wilbur|Wilbur]] or in gray scale image on your favorite image editor. Then you import this elevation into [[arma2:tools:visitor3|Visitor 3]] (v3), place your objects and finally import big satellite mask and satellite texture images. Just before you bring your terrain into in-game, you need to export the actual WRP file out of v3, then pack all to pbo and you're done. ====== Missions? ====== Missions can be unpacked in their directory format or as in PBO files. Do not confuse mission pbo into addon pbo. Also to confuse you... mission dir can be included in addon pbo... :) Missions will be on two locations, in \Missions\ and \MPMissions\ directories, its quite self explanatory but single player missions go to "Missions" dir and multiplayer missions go to "MPMissions" dir. These dirs can have sub directories if you wish to sort your many missions. Also these dirs can have mission directories or pbo's. //Please read below for Mission Editing for additional details.// ====== Campaigns? ====== Campaigns are 2 missions or more, //campaign is never ever 1 mission//. The missions are prepared in certain directory format which is then read by the game from description.ext file in the campaign root directory. Campaign just like missions can be in unpacked format as in directory or in a PBO file. Campaigns can be found under \campaigns\ directory or in any directory which is used with -mod parameter, as well as in pbo file in normal addons dir. ArmA 2 has various methods of running a campaign file. Take a note, campaign directories do work from -mod dir while mission directories DO NOT. ====== arma2.RPT file? ====== arma2.RPT file (RPT) found in your ArmA 2 root directory is very important when you want to debug your work, just run the addon / mission in-game for a moment (even few seconds should be enough) and then exit game, then open the RPT file with any text editor and look for warning / error lines in there which are related to your addon. //Take a note that the .RPT file is the file name of your ArmA 2 executable, usually and default its "arma2" but it can be anything else too for example Operation Arrowhead it is "arma2oa".// For more details check out [[arma2:arma2.rpt|arma2.RPT]] page for some errors we have found. ====== Tools and Utils? ====== [[arma2:tools:extractpbo|ExtractPbo]] util unpacks / opens PBO files.\\ [[arma2:tools:makepbo|MakePbo]] util packs PBO files.\\ BinPBO official BIS tools to pack PBO files, also binarizes addons.\\ Visitor 3 (V3) edits and saves WRP terrain files.\\ Oxygen 2 (o2) edits and saves MLOD format P3D 3d model files.\\ TexView 2 loads tga images and saves paa/pac texture files.\\ unRap unpacks the binary config.bin and .rvmat files. You can use your favorite text editor to edit config.cpp and non binary .rvmat files. For text file editing (scripts sqs, sqf, mission.sqm, rvmat's and config.cpp) we highly recommend using good editor like [[:editing_tools#text_editing|EditPadPro or Notepad++]] so it will highlight the syntax for you and most importantly formats the text properly, notepad is NOT suitable for script/config editing. Graphical editing tools beyond ArmA 2 are PaintShop Pro and Adobe PhotoShop. There is also GIMP which is free for download. Please refer to our [[:editing_tools|editing tools]] section for more information about other tools. ====== What you want to do? ====== When you start to edit, you must know what you want to do first. As you are beginner, naturally we would instruct to start small, if you immediately start a massive mod you might get overwhelmed by the task ahead. When you start small, you can have a good feeling if editing is what you really want to do. It would be shameful if you start a mod, post news/topics about it and one week later realize that you are not capable of editing everything that are required for mod making and then posting again to announce the mod is dead. For beginners it would be really good to start edit a one config to modify how certain addon is working, from there you can then proceed into texture and model editing. As for mission making, its really not "mod making", its just mission editing. When you make missions, you just use the content available, if you edit in mod making way, you create new content or modify the existing one. ====== What you should NOT do! ====== Many times it happens that beginners start to edit the original ArmA 2 files. This is not necessary or "allowed". If you mess around with original files you only harm your ArmA 2 installation. **Do not edit files in \addons\ directory!** You can copy the pbo's from there, put them in \x\addons\ and launch ArmA 2 with parameter -mod=x to see your edits ingame. ====== Config Editing ====== Its quite easy to make config edits, just open the cpp and edit away. Heh well almost. Some parts of the config are rather self explanatory, like the magazines for example, its easy to tweak your soldier config to have three magazines and three grenades instead of three magazines and four smoke shells. You can start by editing the existing configs so in fact you are not creating any new addon pbo's to be used, this is very easy. Just unpack lets say addons\weapons.pbo, then unRap the config.bin and now you are ready to load the cpp into text editor. Then just edit what you like, for example M16A2 fire rates or dispersion values for the weapons. When you're done, just pack the "weapons" directory into pbo packet again and you are ready to try the edited config / weapons.pbo in-game. This is the beginner way, when you learn more we will guide you NOT to edit the actual BIS addon pbo itself, but to create your own "replacement config" for example (but this indeed is for more advanced level). ====== Modeling ====== With O2 you can load and edit the MLOD format p3d models (also known as P3DM format). You cannot open any default BIS p3d model files are they are binarized which makes them ODOL format. Some uneducated individuals talk about binarizing and think its some sort of "encryption", well rest assured **it is NOT any encryption**, just optimization of the p3d file. ArmA 2 engine itself loads MLOD and ODOL formats just fine. ^ P3D Format ^ Description ^ | MLOD/P3DM | Unoptimized / unbinarized format, can be loaded with O2 | | ODOL | Optimized / binarized format, not working in O2 | So where to get MLOD models!? Well for example from the [[arma2:modeling:bismodels|BIS example models]] which include example soldier model. Then you can search around for user made addons. At the moment of writing this tutorial (late 2009) you cannot "unbinarize" or convert ODOL to MLOD as there is no such tools released to the public. ====== Texturing ====== Just open TexView2, load up existing paa/pac texture and see how it is done. When you are ready to modify the texture, save it to TGA so you can load it to your favorite image editing program. Also it would be good idea to get the [[arma2:tools:paaplugin|PAAPlugin]] for Photoshop so you can directly load, edit and save paa/pac files with it. However it is very much recommended you stick with Texview 2 as its far better than the Photoshop plugin. The basic textures are in _CO.paa/pac file name, then the normal maps are in _NOHQ.paa/pac filename and the specular map is _SMDI.paa/pac file name. For more details check out [[arma2:texturing:texture_naming_rules|Texture Naming Rules]]. At start you should do just fine editing the _CO texture and later on when you are ready to make normal/specular maps, you'll use for example the NVIDIA plug-in for Photoshop to create normal map and TexView2 to create specular map. If you create brand new textures, keep resolutions in specific size like 512x256, 1024x512 and so on. Do not use 350x993 or other such strange resolutions. Quick help is that unit/character textures can be found from the characters.pbo under the data\ directory. Helicopter textures can be found from air.pbo under the data\ directory. Vehicle textures can be found from wheeled or tracked .pbo files under the data\ directory. And finally weapon textures can be found from weapons.pbo under the data\ directory. ====== Terrain Editing ====== You need to create elevation's for your terrain, this can be done either in Wilbur or in gray scale image on your favorite image editor. Then you import this elevation into Visitor 3 (v3), place your objects and finally import big satellite mask and satellite texture images. Just before you bring your terrain into in-game, you need to export the actual WRP file out of v3, then pack all to pbo and you're done. ====== Mission Editing ====== Mission editing is really easy, in game just open mission editor and off you go. As long as you have one unit selected as "Player" you can use the preview button to play your mission normally. When you save a mission, the drop down menu gives you choices for export to Missions directory or MPMissions directory, this creates the pbo file out of the mission and placed it to the proper dir for you. If you just choose the directory name, it just saves the mission into the Users\\Missions\ directory. This users dir is controlled through -profiles parameter. When you play multiplayer (MP), any played missions are downloaded from the server and placed on MPMissionsCache directory. If you want to edit or play these missions on your computer, you need to unpack the pbo and move the created directory into Users\\Missions\ directory. If you want to host MP session with these missions, copy them into MPMissions directory. Of course when you get more deeper into mission editing there is all kinds of trickery with scripts and stuff. ====== Campaign Editing ====== Editing campaigns is quite much same as missions, except this time you create one root directory where you put your single missions, you then connect those missions together in the description.ext file. This is the directory / file structure. campaign_root\description.ext campaign_root\Missions\ You place all your single missions into the Missions\ directory. ====== Notes ====== As you see this guide is //very// beginner stuff in attempt to just orientate the newbie into the basic concepts, so feel free to ask more specific questions in our forums [[https://www.pmctactical.org/forum/viewforum.php?f=53|ArmA 2 Editing]] area. We would like to write a bit more advanced tutorial next, to go through few specific things, your questions in the forum would really help us to focus on what is important. //In PMC Tactical no newbie is looked down upon, we were all newbies once. Its our goal to build this wiki so it will help even the complete beginner guys to learn how to edit.//