File Formats

TODO:
- More filetypes
- Double-check course data block names
- Perhaps info on control bytes and slope controllers?

This page lists file formats used by New Super Mario Bros., what they're used for, and their structures.

Do recall that the NDS uses little endian, so values are read starting from the least significant byte.

Tilesets

These files contain information about tilesets.

Tile Object Definition Files

AKA unt files. These define a tileset's tile objects and can be found in the BG_unt/ folder. These are distinct from the unt_hd files.

These consist of an object block, which contain object row blocks, which can contain either a slope controller — a byte greater than or equal to 0x80, or a tile — defined like so:

The end of an object row block is denoted with 0xFE, while the end of an object block is denoted with 0xFF.

Unt_hd Files

Contain supplementary information about a tileset's tile objects. Can be found in the BG_unt/ folder and will be suffixed with "_hd". Each block is defined suchly:

There is a block for each object defined in the tilesets unt file.

Courses

These files contain information about course areas and can be found in the course/ folder.

Course Data Files

Course data files contain all the information about a course area bar tile object layout. Files are named X##_#.bin, where X is a letter corresponding to the world, ## is a number corresponding to the course, and # is the area.

Blocks are counted starting from 1, a la NSMBe. Header:

Course BgDat Files

These files contain information about the placement of tile objects in a course area. Their filenames follow the same convention as the course data files but are suffixed with "_bgdat" Each tile object is defined as such:

Each file is terminated with 0xFFFF.