News: 11 March 2016 - Forum Rules
Current Moderators - DarkSol, KingMike, MathOnNapkins, Azkadellia, Danke

Author Topic: Star Fox Object Dumper  (Read 349 times)


  • Newbie
  • *
  • Posts: 3
    • View Profile
Star Fox Object Dumper
« on: June 19, 2018, 05:17:51 am »
Okay, so after a few years of off and on tinkering, along with a lot of wayback machine, I've managed to contact a few authors of older code (dyson and stef), and couldn't contact VL-Tone (Metroid Cubed, I think I read he died) who were working on RE the Star Fox data so they could implement their own engine. Those projects got reasonably far, and looked very good. However, much of that code was lost.

The Shockwave file by VL-Tone definitely purported to output the objects in obj format, but for whatever reason could not. Not only that, the interface had some major issues on every system I managed to get it running on. It looked great, but was barely a demo for practical uses.

Stef's code was great in that it gave access to the actual mesh data. However, it was unable to directly export to a model file. I could massage the original data it output to be useful, but this was labor intensive. Eventually I was able to reach out to Stef, who was able to provide me with his Java code that could probe down into the Star Fox objects. That was very good code. Once I had the java code, modifying it to not only output triangle and vertex data for be in stanford ply format was a breeze. However, the triangles were only used for the normals, as far as I could tell (each object also contains proper polygon face data in addition to the triangle list (!), and most objects, if reconstructed from the Tri List, would usually wind up missing a portion of a face somewhere (typically a square that had been triangulated in the tri list). Since I needed the regular face data (which also had the normals and textures), I needed to one up this.

Fortunately, he gave me permission to re-publish his code under GPL 3, and I was able to use portions of his code to create my own object dumper. Why? Well, partly because I could, partly because I know C/C++ and prefer it, and I wanted to reduce framework dependencies and improve portability. For now, this outputs the bare vertex and face data in Wavefront Obj format, suitable for use in Blender or any other model program you like. It outputs animated objects as filename_nn.obj, where nn is the frame number. You can use these as shape keys, with 00 being the base shape. I have successfully done exactly that with a few objects, just to see how they look (they would look much better with texturing).

You only need to know a few things: The actual addresses of the vertex data and facedata in the rom (and they are not required to be contiguous, some vertex lists are referred to by multiple different face data lists (essentially the same object, but in wireframe, different textures, etc, e.g. the arwing, the shadow arwing, the wireframe "shielded" arwing).

Future additions to the output will be the normals (which are per-face, so I need to see how this will pan out if I use different vn's on each face which shares vertices). For now, blender seems to compute the normals reasonably nicely. I would also like to implement scaling, since the game itself does scale these models. As part of that, I'd like to fix the models between -1 and 1, rather than the -127 to 127 they use now (not sure if anything used -128. I could probably add a test for that.) Further along, will be the textures and face colors. See my next note about this.

I'm still working on ripping textures. This will probably be a new object, since each palette is referred to by multiple objects, and each has multiple entries. If anyone wants to contribute to this project, let me know. My preference is to keep everything as clean as possible, while involving a minimal number of external dependencies.

Another thing I may try to do is implement a bare test that allows testing if the vertex list is valid separately from the face data. That might allow one to iterate through a rom specifically looking for model data. The changes to the object should be minimal, and the driver code can do the iterating.

You can pull my code from

So to summarize, I have posted the code. It works. I'm not making any guarantees. If you know where the model data is in other argonaut software games (various versions of star fox, star fox 2, vortex, stunt race fx, more?), please feel free to post your results using this dumper on them. Even better, please post your discoveries, data addresses, notes etc so I can try to incorporate them. The information I found seemed to indicate star fox 2 at least used the same format (the object headers used 30 bytes instead of 28 bytes {I found my rom used in the header list mostly 28 bytes, several 33 byte headers, and one 38 byte header. I'm working on that now})

Let me know what yall think!

Edit: Here are some objects to try out. AFAIK they're only valid on the headered 1.0 rom. You may want to paste them into libreoffice calc. All values are in hex.

Object Name   Object ID   Object ID (Std Hex)   Vertex Data Rom Address   Face Data Rom Address   Palette Rom Address   Scale (*2^n)
Shadow small high poly arwing   98BC   BC98   66201   66242   1827C   0
Small high poly arwing   B4BC   BCB4   66201   66242   18413   0
Big high poly arwing   D0BC   BCD0   66201   66242   18413   1
Helicopter   C4CD   CDC4   7B393   7B415   18413   0
Phantron (Transformation)   88C7   C788   75B16   76142   18413   2
Phantron (closed)   A4C7   C7A4   76324   7635C   18413   2
Andross Face morph   44D1   D144   7E49E   7EA86   18794   4
Andross Face morph 2   60D1   D160   7ED81   7F25B   18794   4
Andross 2 Evil Face   B4E6   E6B4   8E3FE   8EC22   18794   4
« Last Edit: June 19, 2018, 03:31:45 pm by MarchHare »


  • Newbie
  • *
  • Posts: 3
    • View Profile
Re: Star Fox Object Dumper
« Reply #1 on: July 04, 2018, 12:44:52 am »
So, more progress on this project. I've successfully extracted the textures, as well, based on information provided by VL-Tone and Dyson ( This isn't set up as a proper object just yet, but it's not particularly hard task.

I'm not sure if there are other texture lumps like this elsewhere in the 1.0 rom. Probably? Does anyone else know anything about these?

Does anyone know how one can make an animated material from static image frames? I am at loathe to collate multiple frames into a gif or video for blender or something. Especially for simple animated texs like flashing colors.

How does one attach a file to these posts? I would like to attach the real palette in gimp format (the palettes from the original VL-Tone gifs was jumbled around (colors seemed fine, but the color indices were different. Maybe they were from the 1.2 version?)

Edit: No, the 1.2 version has exactly the same texture data in the same place. I'm thinking that perhaps VL-Tone jumbled the palette when he created the gifs.
« Last Edit: July 04, 2018, 02:23:53 am by MarchHare »


  • Newbie
  • *
  • Posts: 1
    • View Profile
Re: Star Fox Object Dumper
« Reply #2 on: July 13, 2018, 01:39:13 am »
Interesting that you started experimenting with Star Fox models around the same time I decided to give it a try myself. Thanks for gathering information about the format!

You might be interested in my JavaScript-based viewer at . It's very unfinished, so it only displays one model. The source code is here: