home | tutorials > BISoldier Configuration


I am assuming that readers of this tutorial have a basic knowledge of computers, how to create and rename files and folders, how to copy and paste etc.

The tutorial will start with me assuming the following criteria have been carried out by the reader:


I have seen so many people post images of thier pure white models half burried in the ground asking "how do I fix this?"

I had exactly the same problem when BI first released the BIModels.zip containing the soldier model. I was patient and followed the various forum threads and kept track of who had made progress and how close they were to getting the soldier model to work in-game.

I decided to write a tutorial based on what I read and what I did to get my units ingame.

I am going to use default names for ease of use, More advanced readers may want to change model names and config entry`s etc. The tutorial is not a complete guide on how to get a model to work in-game, it simply informs the reader how to get the BISoldier model to run around like he should in Armed Assault.

Let's begin...

  • Open up 2 instances of O2
  • In one instance open up the BISkeleton.p3d file from the BISkeleton folder on your desktop.
  • In the other open the BISoldier.p3d from the BISoldier folder on your desktop
  • Go to the BISkelton.p3d instance of O2.
  • Locate the LoD`s window (usually top right)
  • Double Click on the memory LoD to access its named selections.

  • Beneath the LoD window you can now see the named selection of the memory LoD showing in the named selection window.

  • With the memory LoD selected, select ALL the named points by using CTRL+A. *
  • Copy (CTRL+C) the highlighted points.
  • Go back to the other instance of O2 where you have the BISoldier.p3d model loaded.
  • Just like the above steps, locate the LoD window and double-click on the memory LoD
  • What we do then is Paste (CTRL+V) the contents of our clipboard from the BISkeleton.p3d into this named selection window.
  • You should see in the 3D views that extra vertices have been added.

* NOTE:There is another way of selecting the named points by dragging your mouse over them and copying them that way. For some reason this method only selects 83 points. Using the CTRL+A method as described above ensures all 84 are selected.

  • You can now save the model using the same name (BISoldier.p3d) and close down both instances of O2

The configuration

To get your BISoldier model to work in-game you will need a config.cpp file

There is no point me going into great depth here showing you what each part of the script does, that is not the purpose of this tutorial.

All we are going to do at this stage is add a very basic configuration file that will add an M107 Sniper rifle, a few magazines, a couple of grenades and a pair of binoculars to our Soldier.

If you wish you can visit the BI wiki page on weapons and add your own custom setup but I recommend for the newbie that you use the config provided.

  • Download the config.cpp HERE (Right-click & Save Link as..)
  • Place the downloaded config.cpp file into your BISoldier folder.
  • The contents of your BISoldier folder should now look like this:

Decisions, Decisions..

You now have two choices.

You can either pack your .pbo file now, and test the config and make sure everything works OK Or you can continue with the tutorial and fix the texture paths.

If you pack the files now there is obviously going to be a problem with the textures as we have not yet correctly defined their paths but at least you can test your the model ingame and make sure its not half buried!

If you wish to pack and test your model now skip the next section and go straight to the Packing the Files part of this tutorial.

If not, read on..

Fixing the texture and material paths

We are now going to fix the texture paths for your model. Remember when you make your own model you will be using different file, folder and path names so you have to make sure Armed Assault knows where to look for them, otherwise you will get the dreaded white soldier showing up in-game!

I could have avoided this section by keeping strictly to the paths of the data folder (BIModels\BISoldier\data\xxx ) that were created when we extracted the BISoldier model from the BIModels.zip but I think it will be good practice to learn how to rename the texture paths.

OK, here we go..

  • Start O2 and open up our saved BISoldier.p3d
  • Go straight to Tools> Mass Texture & Material renaming..

This will open up a window showing a list of all texture and material names used on our model. The .paa files are the textures and the .rvmat files are the materials.

You can see that the texture and material path is bimodels\bisoldier\data\xxx, This is wrong because the model is no longer located within the BIModels folder so we need to remove the reference to it from the path.

To do this is in O2 PE is very simple:

  • Click on one (preferable the first) texture or material from the list

  • You will see its path has appeared in the Name to rename section below

  • In the New name section we can remove reference to the BIModels folder by just typing bisoldier\data\hhl_22_co.paa

  • Hit the rename button and you will see the texture now has a correct path to our folder

By following the above steps you now need to rename all the textures and materials listed in the window. Below is a list of what should need renaming on the BISoldier model.


Once you have done that your texture and material paths should now look similar to this

Now you have done this we can now save the model and move onto the next stage.

Material editor.

So far we have changed the material paths in O2 but we also need to do it via the Material Editor.

This again is a pretty simple process

  • Open up the Material Editor. If you have installed the BI Tools in the default location it will be located in your O2 folder (e.g \Program Files\Bohemia Interactive\Tools\Oxygen 2 Personal Edition\MatEditor.exe)
  • Go to File> Open and point the browser to the Data folder within our BISoldier folder.
  • Only .rvmat files should show so you should see something like this:

Choose the first one on the list - us_hhl.rvmat

On opening up the selected .rvmat file you will see the settings for the material file are now visible.

Certain settings (Diffuse, Forced Diffuse, Emissive, Specular, Specular Power, Default Texture) can be ignored for this tutorial.

You will see however that some settings have a path name assigned to them (Stage Config). You will also see that the path is again incorrect for our model and still has reference to the BIModels folder:

  • What we do now is edit the text in the Source Name box to show the correct path to our model.
The paths currently read:




  • We need to delete the BIModels\ part effectively renaming the paths to read:




  • Once you have edited all paths then go to File> Save And save the amended .rvmat
  • Open up the remaining .rvmat files in order and go through the same process of renaming the paths with them all.

There are only 4 in total for the BISoldier model so it should take no more than 5 minutes

Once this is done close down the Material Editor.

We have now configured our model and corrected the path to our texture and material folder, all that remains is to pack the files and place them in our addons folder.

Packing the Files

All we need to do now to complete the tutorial is to pack the BISoldier folder and its contents into a .PBO.

  • Go to the BISoldier folder we created and have been working from on the desktop
  • Right-click on it and select create PBO (this option is listed because you installed cpbo v2.03 a PBO extractor/repacker included with Kegetys ArmA tools)
  • Give it a few seconds and the created BISoldier.pbo file will appear on your desktop.
  • Place the BISoldier.pbo file in your ArmA addons folder (typically Program Files\Bohemia Interactive\ArmA\addons\)

That's it for the editing part, all that is left now is to cross your fingers and test it in Armed Assault!

Testing the final product

On loading Armed Assault and going into the editor you should be able to locate the BISoldier from the dropdown menu under BLUEFOR.

Starting the game should give you no errors. If you do get errors take note of the error message it will give you a clue as to how to fix the problem. Usually it is a texture that is not found due to bad renaming of the paths somewhere either in the config.cpp, O2 or MatEditor.

Hopefully though, you will see a fully working model for you to enjoy.

If you want to take it a step further you can now start editing the model in O2 and an art package such as Adobe Photoshop to create unique load outs and textures for your units.


The method described in this tutorial was discoverd by hard work done by members of the Bohemia Interactive Studios community. All I did was write the tutorial.

Members I would especially like to thank (usually because one of their post played a key part in this tutorial) are, in no particular order:

Synide, RavenDK, ADOGMC, Pantiflex, CameronMcDonald, dbobrick, Jackal326 and danelectro_dc.

- JB™

about us | contact us | ©2007 ambient occlusion studios