Change rats for cockroaches addon

Manhunt2.PluginMH2 (Also almost sure that it's vital as well to set "ENABLE_RATS 1" on an uncompressed resource 1.glg file of the desired level. Setting e.g. "SetMaxNumberOfRats(9);" on an uncompressed .mls of a level to more than 0 as it's set to 9 on the example may increase their amount)

Before modifying files concerning any game, remember that it's advised to backup it or them, in case you want in the future to recover anything, another option of course being to manually modify the name of the file/s you don't want to be replaced before adding mods.

To use, locate Manhunt's installation folder (or the folder from which Manhunt is launched).

There are various methods to achieve installing each "section" of this mod, and they have been numbered below, ranging from the simplest to the most complicated way.

0. The difference between the two CJ_RAT dff's included is that the CJ_RAT1.dff model seems to do the animation (originally the "rat animation") more "linearly" while CJ_RAT2.dff follows a more "zigzaged" trajectory that i've also seen the original rats' model do, so either way you shouldn't be disappointed or surprised, but personally i prefer the firstly mentioned trajectory.

The folder titled "ermaccer method" is included in case you prefer using any method user @ermaccer, beforehand I in this tutorial, has suggested or expressed.

1. One of the "ermaccer methods" is the Manhunt Model Cooker method. To replace the rat model for the cockroach one, simply go to the location raw\Animals\ and replace the file CJ_RAT.dff with one of the two dff's included as mentioned earlier, in the "ermaccer method" folder. Now double click, as ermaccer points out in his instructions, "cook_modelspc.bat", and replace the default gmodelspc.dff located on the installation folder, then Manhunt\levels\GLOBAL\PAK, with the gmodelspc.dff created after "cook_modelspc.bat". Save and proceed to section 4. below.

P.S.: If you want that file to be compatible with for example, any Project Carcer Mod's included gmodelspc.dff file, the easiest way is to create a copy of the gmodelspc.dff file, and opening it with RW Analyze 0.4 beta, delete every "clump" equivalent to the dff's in the folders inside the "raw" one, as triangle.dff, CJ_CROW, CJ_RAT, etc, basically up to fist_poly_hunter (to identify each "clump", it's convenient to notice the "Frame Name" on the box to the right by clicking the first "Frame" below each "Clump" in the hierarchy as also pointed out in number 3.). After saving the file, just paste it inside the raw\custom\ folder, and from now on, you won't need RW Analyze the next time you add a dff, cause you' simply need to paste it inside that folder obviously.

Another point is that if you intend or prefer to just add the model in question, without also replacing an existing one, you need to modify the name of the root bone from whichever of the models, also referred to in number 2. and 3. respectively as "Strings" or "Frame Names". So check the instructions there to find out what to do. Also you'll need to follow the step in 5. below.

2. The other "ermaccer method" is the hex method, you can check it here. You also need HxD (or a hex editor of your choice).

The only additional information regarding this, i shall add, is that after adding one of the dff's information to the gmodelspc.dff file, you need to search since the begining of gmodelspc.dff for the first string that reads "CJ_RAT" (make sure it's above and close to the string CJ_RAT_L0) and change it to whatever you want (e.g. CJ_COC) as long as the new characters don't exceed the ones from this string or "fits" in it, and as well as being careful to not add or remove any character or "space" in the document as HxD by default will warn you about. Save and proceed to 4. bellow.

P.S.: If you intend or prefer to just add the model, without also replacing an existing one, you simply have to do the same, but except of editing the first CJ_RAT string, you'll edit the second one which is related to the dff you added attached in this download, so just search for the tag "CJ_RAT" various times until you find a second CJ_RAT coincidence, that as well as the first one, is referenced or distinguished by being above and close to the string CJ_RAT_L0, and next is to modify this one following the instructions and cautions mentioned above regarding the first one. Also you'll need to follow the step in 5. below.

3. For this option, you'll need RW Analyze 0.4 beta. Extract the files included in this download to a familiar location in your pc. Then using RW Analyze, open the file "gmodelspc.dff" located inside the "levels" folder, and then in GLOBAL\PAK\. Now, right click the first "clump" inside the file and choose "copy section". After doing this, the program itself should take you to the bottom while selecting the just created copy (if not, go to the bottom of the file by yourself) and you shall recognize this (the copy) by selecting below, inside the hierarchy, the first "frame", then you should be able to read in the box to the right the "Frame Name" which is "triangle".

Next thing to do is replace this clump hierarchy for the one of the cockroach's dff, so right clicking the clump, choose "import section data..." and select one of the two dff files included in the download, but make sure its one of the two found outside of the folder named "ermaccer method". What follows is identifying and renaming the first "Frame" of the original rat model's clump, which is located almost at the start of the file, find it by helping yourself with the keyboard shortcut for "search", key F3 (RW Analyze automatically searches for sections of the same type as the one selected), so select the first "Frame" on the file and press F3 until you read as the "Frame Name" "CJ_RAT" (instead of renaming as the following text says, you can simply remove the original rat's clump which contains this frame of course, and that's it), then right click "Frame", and after choosing "Edit String", change CJ_RAT to whatever other name you want (e.g. CJ_COC) as long as it's not the same as another model on the game. Save and proceed to 4. bellow.

P.S.: -pending-

4. Almost done. You have to download TXD Workshop 5.0 (another option is Magic TXD 1.1). To add the texture launch TXD Workshop, open the file "gmodelspc.txd" located in the same place than "gmodelspc.dff", in the above menu select Image\New\, choose "32bit", and double click the created slot. Then it's very important to mark "compressed" and name the file "cockroach". Finally, import the cockroach texture included in this download on this slot using the button import. Save the file and that's it. Enjoy!

5. You'll need HxD (or a hex editor of your choice). Open the file Manhunt.exe using HxD, next by typing ctrl+f search for the string "CJ_RAT" and edit it to "CJ_COC" (or whatever you chose to name it earlier) making sure to not erase or add any new character space than the one you started editing with as HxD by default warns about and save it. That's all, enjoy!

The cockroaches are harder to notice than rats, obviously because of their size, they may seem sneakier just like James Earl Cash himself whom you may even find under a rock hahaha quoting that skinz member, of course.

Tools used and special thanks: RW Analyze 0.4 beta, TXD Workshop 5.0, Magic TXD 1.1, TEX/TXD Editor, Manhunt2 MDL IO, 3ds Max 2011, Manhunt Model Cooker.