Model Replacement Guide


Armchair Developer
Movie Battles II Team
Hi folks!

Many people have asked how to make replacements and such, Lou posted an outdated tutorial a couple of years ago and there's a much easier way to do replacements nowadays, I'll be updating this post soon with a written tutorial but for now this video tutorial by @Shenghai pretty much covers the whole thing:

Feel free to ask questions related to the topic, I'll pin this brand new thread, off topic messages will be deleted to keep everything on topic.

For now I'll also put the outdated written tutorial, but I highly recommend to use the method that I always use, which Shenghai clearly explains on his video tutorial:

Things you'll need:

Notepad (the basic texteditor that comes with windows)
Winrar, Winzip, WinAce or Pakscape (i recommend having WinRar and Pakscape - but this guide will not use Pakscape)
A Non-MB-Model of your Choice (Commander Neyo as an example) [I will refer to this as MyNewModel from now on]

Unpacking the Model:

When you download a model from, it usually comes as a .zip-file that contains the .pk3.

First off - Put the on your desktop and unpack it into a folder. (The name of the folder is up to you, it has no importance)

Open the folder and locate the MyNewModel.pk3-file in there. Open it with Winrar (or Winzip, WinAce). In case Windows pops up a dialog asking you which Application you want to use to open this file, pick the option that allows you to select the program by yourself and choose Winrar (or Winzip, Winace).

Now that you opened the .pk3 - Unpack it into a folder. (you can name it zzzMyNewModel if you want to, but you can also rename it later)

you'll now see a few of the following folders (Note: in most cases not all of these will be there):

- botfiles (that's for bot-support)
- ext_data (that's for npc-support and hilt-references)
- models (that's the most important one)
- scripts (also for bot-support)
- shaders (well, that's for the shader...)
- sound (here are the taunts, etc...)

Editing the files:

First off - you'll delete the folders \"botfiles\", \"ext_data\" and \"scripts\" (if your model doesn't have them, be happy, less work for you).

Now double-click the \"models\"-folder, you'll find a \"players\"-folder inside. double-click that too. Now you're almost there, you will see a folder now that is called \"MyNewModel\" - Before you double-click it, you have to know what MB-Model you want to replace. We wont take the red clone, because that wont work (all clones use the same model.glm - so either you replace them all, or leave it) - Let's take a hero for now. Lando for instance.

Now that you know what to replace your file with, open the MBAssets.pk3, MBModel1.pk3 and MBModel3.pk3, go into \"/models/players/\" of each of these 3 pk.3's and look for the name of the folder that Lando is using. In this case it's \"lando\" (case-sensitive - only on Linux machines tho). Now rename your \"MyNewModel\" to \"lando\" and open that folder.

Ok, you made it into the heart of the model, now you see a bunch of .jpg's, .tga's, .skin's and a .glm-file.

Double-click the \"\"-file with Notepad. (Again, if windows gives you a dialogue, chose the option to select the program manually and pick Notepad). Now you'll see some text that'll look something like this:


(i just add colors here to make this clear, it's important that you know what i mean at this point)

What you have to do now to make the replacement work is to change the word \"MyNewModel\" into \"lando\". This will tell the game that it has to look for the textures for your model in the \"lando\"-folder. Make sure to rename every single reference that points to \"MyNewFolder\" into \"lando\". (I personally use the search-funtion [shortcut: CTRL+F] to find all the references i need to replace and just paste [shortcut: CTRL+V] the new reference)

it should look like this now:


If you also see lines like this:


leave them as they are, all lines that point to the /stormtrooper/-folder are just for the caps. (the caps are what tells the game where to dismember a limb if it's cut off by a saber. you see them too when you f.i. cut somebody's arm off, they are the burnt wound you see at the end of the stump)

Once you're done, save the file. (Keep it's exact name - \"\")

Now delete everything from the folder that you don't use. That means if your model comes with teamsupport, it will have .jpg's, .tga's and .skin-files for a red and a blue skin. If you don't use these skins, you should delete the files that belong to them. (If you delete these unused skins here you should remove their reference in the shader too, it's your choice, i personally do it because having too many shaders can cause a variety of bugs)

Now rename the file \"icon_default\" to \"mb2_icon_default\". Now the icon of your MyNewModel will be seen instead of the icon of the model you wish to replace.

Once you're done, move up two folders until you see the directory called \"shaders\". (If your model doesn't have it, skip this)

You'll see a file in there that is most likely called \"MyNewModel.shader\". Open the file with Notepad (again, if Windows comes up with a dialogue, well, you should know by now...).

Again there is only text in there. What you need to do is similar to the job at the \"\"-file. Find and replace every reference that has the name \"MyNewModel\" in it and replace it with \"lando\" (or whatever the folder-name of the model you wish to replace is). Also, delete all entries that refer to the blue or red skins of your model (Note that the entires are separated by paragraphs, you have to delete the whole paragraph if it refers to the blue or red skin). Once you're done, save the file.

Finishing it off:

Ok, you're almost done. Now move up one folder, so that you can see the following:


Select all three of them and create a .zip-file called \"\". Rename this file to \"zzzMyNewModel.pk3\".

Now put it into your \"MBII\"-folder, delete everything you have on your Desktop from making this replacement and play. ;)
Last edited:
Hello, It is possible to add a custom skeleton (_humanoid)?, I rigged a model some years ago but it seems I need to rig it again for the standard MBII _humanoid, the model isn't loading at all and it's textures replace the ones of the model I'm trying to replace.