Model extraction with NinjaRipper

Porting copyrighted material for fun and no profit

Dave Newson - May 1st 2016
Give a man a ripped model, and that's copyright infringement.
Teach a man to rip models ..


The HTC Vive finally arrived, and along with this new awesome toy came the desire to see all the things in Virtual Reality.

What things? Well, I've always wanted to be thrown off the end of an aircraft carrier in an F/A-18 Super Hornet, strafe a convoy in an A-10, or just razz around in an M1 Abrams tank and wreck up the place. There are a lot of options.

These lofty goals are easier to accomplish than you might think.

The Unreal Engine 4 is now free (mostly) and natively supports the HTC Vive, among others. I already have modelling tools and enough knowledge to be dangerous, so all I need are some high-quality models to throw into the environment.

Face Punch

The goons over at FacePunch have been doing this shit for years.

If there's a game you want the models from, chances are there's a thread for it. Ask nicely and someone might even go and extract the specific thing you're looking for. They're just a nice bunch like that.

There are, of course, a few threads for Battlefield models:

I found a few problems, however, in trying to use the models I found on FacePunch:

  • Not all the vehicles I wanted to play around with were available (at the time).
  • The normal maps were missing from a lot of the models.
  • Some of the textures were a bit.. weird, or the UVs looked a bit off. Some manual intervention had been required.

As per always, this is the point where I diverged from my original goal, and go down the rabbit hole of trying for perfection.

Do it yourself

I tried a few different tools, and eventually settled on the dodgiest-looking one; NinjaRipper.

NinjaRipper has several advantages over things like Intel GPA, like it would actually extract all the UV channels and have the normals orientated correctly.

The workflow for NinjaRipper was also a whole lot less awkward, with an immediate dump of all assets being made, leaving you to sift through the rubble at a later date.

Where NinjaRipper kind of sucked however, was the MaxScript used to convert the .rip files into 3D Studio Max.

  • Extracting multiple rip files was very slow.
  • A single texture and UV map was extracted, even if multiple maps/textures were visible in the source of the .rip.
  • UVs were often flipped.
  • Dodgy UV map co-ords could result in 3D Studio crashing.

I found a slightly improved by Mark Ludwig, and this fixed a handful of the problems:

  • Added an option to flip the UVs
  • Added bulk imports
  • Sped up the import by 50-70%

But this still left lots of serious problems, with the biggest being that inability to extract both the diffuse texture map, and the normal map, in a single pass.


A poor tool blames its workman

Conveniently I'm a programmer by trade, so I decided to lift the lid off this thing and make my own improvements.

  • Prevented bad UV map coordinate selection from cashing 3D Studio.
  • Added support to extract multiple UV channels at the same time.
  • Added ability to save materials as multi/sub-map.
  • Tweaked debug messaging, improved speed, split and restructured the code.

Now that the ripper is capable of getting what I'm after, let's put together a workflow that allows us to get the exact model we want, without lots of unpleasant cocking about.

Rippin' stuff

You need to use the correct binary (x64 or x86) for the game binary you're going to run.

In this example we're going to be using Battlefield 4, so let's go with the x64/NinjaRipper.exe binary.

Attaching NinjaRipper to a game

Ninja Ripper

Firstly, use the Exe [...] button to pick the executable you want to run, such as bf4.exe.

If you need to, you can specify optional arguments for the executable. This is necessary for Battlefield 4.

Secondly, pick where you want the Output files to be dumped using the Dir [...] button.

Thirdly, select the D3D wrapper DLL you wish to use. Intruder inject is the normal default, but I've had mixed experiences making that work.

Lastly, you can click the Settings button for some extended configuration options.

Ninja Ripper extended settings

It's not usually necessary to save the shaders, unless you really want to see how something works and intend to reproduce it completely.

Once you're all configured, hit Run to fire up the game, wrapped with NinjaRipper.

If you can't make the game run through NinjaRipper (eg. Battlefield likes to use the web UI), it sometimes still works provided you use the Run button, then launched the game through another mechanism. I believe this is to do with just ensuring the D3D Wrapper DLL was installed correctly.

Ripping a model

NinjaRipper dumps whatever is in the Draw Call buffer at the time. If the model you're after is in a low-LOD state, you'll get the low LOD ripped.
This basically means you'll want to get as close as you can to the model you want to extract, with the game in the highest quality settings.

Getting the target dead-center of your view is not necessary, nor of any particular help, so just go for whatever.

Once you're in position, hit the button you configured to the All option, which by default is F10. If that fails to do anything, try F12.

If it worked, you'll probably notice the game freeze and appear to hang. Give it a minute, as it's ripping the buffer.

Repeat this for all the things you want to rip.

What was the rip again?

Your output directory should now be full of rip folders. Each folder will be full of .rip and .dds files.

Ninja Ripper Output

Using a program like XnView, you can quickly skim through the .dds files, and look for the skin of the model you want to extract.

Start from the last file, and press (or hold) Page Up to skim backwards in XnView through the .dds files.
As the files are in the same order as the draw calls were made, you'll find one of the larger files near the end of the Tex_ list is the fully-rendered in-game view.

At worst, you should be able to find a G-buffer of the Ambient Occlusion pass, or similar.

Ambient Occlusion Buffer for Battlefield 4 in XnView

This doesn't help you find any models, but it's useful if you can't remember what it was you were trying to grab in the first place.

Finding the .rip you want

Still using the .dds browsing method, skim through the texture files until you happen across one that looks like it's involved in the model you want to grab.

For instance, I'm after the 40mm Grenade Launcher. Skimming the files it's not long before I find something suspiciously 8-barrel lookin'.

Battlefield 4 40mm Grenade Launcher Specular Map in XnView

Now I have the texture name, I can search the .rip files for the same name, Tex_0388_3.

Shazam. should contain our 40mm fun gun.

Importing to 3d Studio

Once in 3D Studio Max, go to the main menu bar and select Max Script > Run Script.... Browse to wherever your downloaded the modified max scripts, and select it to run the script.

Ninja Ripper Max Script

Using the Input .rip file [...] button, browse to and select the file you wish to import.

To specify the specific UV byte index positions, you'll need to change the mode from Auto to Manual.

Quite a bit of trial-and-error is required for the UV index numbers. You may also need to flip the UV Vertical axis.

Item Diffuse UV Normals UV Flip Vertical Axis
Battlefield 3 Objects u12 / v13 u14 / v15 Yes
Battlefield 3 Vehicles u15 / v16 u17 / v18 Yes
Battlefield 3 Characters u24 / v25 u26 / v27 Yes
Battlefield 3 Heads u20 / v21 u22 / v23 Yes
Battlefield 4 Weapons u20 / v21 u22 / v23 Yes

Once imported, you may end up with something a little like this.

Raw NinjaRipper Import to 3D Studio Max

Even if it's showing with the wrong texture, providing your texture map looks kind of mapped then you've probably picked the right UV numbers.

Manual labour: Materials

Open up the Material Editor, and use the Pick Material from Object tool to obtain the Multi/Sub-Object map on the item.

Raw NinjaRipper Import to 3D Studio Max

This stage requires you to do some manual work; you'll have to set up the actual material and place the correct maps into the correct slots.

Some of the bitmaps won't even apply to the model; some of these are engine bitmaps (single pixel colours) or detail maps. You can discard or replace these as you see fit.

Below is an example of the material-fixing process.

Raw NinjaRipper Import to 3D Studio Max

Manual labour: Fixing the mesh

You may have noticed, but the mesh isn't exactly in a good shape. Some of the pieces are way out of alignment.

Mesh misalignment on import

This is not related to the import; it's just how the mesh was stored for the draw call, and will always be the same.

Before you fix this, you should try using the Edit Mesh > Select Element tool to pick parts of the mesh. The mesh is usually split up by it's smoothing groups, and this gives you an opportunity to rebuild those groups.

Once this is done, you can weld all the vertices together at a very low tolerance (eg. 0.001), and use Select Element to pick and move the various parts of the model around.

Once all that's done, you can start to bone and skin the model, then animate, export to FBX, and bring it into UE4.

That is a lot of work.

Yes, it is.

Still, totally worth it to get flung off an aircraft carrier at 176 miles an hour.


comments powered by Disqus