README.md

carbonizer

A pure swift, easy-to-use Fossil Fighters ROM-hacking tool.

How it works

Point carbonizer towards a file or folder, and it'll automatically pack or unpack whatever input it receives. It determines whether to pack or unpack based on the file extensions and binary magic ids it sees, and if it doesn't recognize any, asks what to do.

Supported file types

• .nds - Nintendo DS ROM files
• MAR/.mar - archives
• DTX/.dtx.json - text
• DMG/.dmg.json - dialog
• DEX/.dex.txt - cutscenes
• DMS/.dms.json - config values
• MM3/.mm3.json - 3D models
• MPM/.mpm.json - images
• RLS/.rls.json - fossils

See this wiki for specific information on Fossil Fighters' proprietary binary formats.

How to use

Drag-and-drop (Windows only)

Simply drag the file or folder you want to pack/unpack onto the executable.

Then, edit the files within using a text editor (I recommend Notepad++)

Commandline

OVERVIEW: A Fossil Fighters ROM-hacking tool.

By default, carbonizer automatically determines whether to pack or unpack each input. It does this by looking at file
extensions, magic bytes, and metadata

USAGE: carbonizer [--pack] [--unpack] [--extract-mars <extract-mars>] [<file-paths> ...]

ARGUMENTS:
  <file-paths>            The files to pack/unpack

OPTIONS:
  -p, --pack/-u, --unpack Manually specify compression mode
  -e, --extract-mars <extract-mars>
                          Whether to extract MAR files. Options are always, never, auto (default: auto)
  -h, --help              Show help information.

Usage notes

The easiest way to use carbonizer is to unpack an entire .nds file into a folder in the same directory, then modifying the contents of that directory and repacking it back into an .nds file. This usage is encouraged, but keep in mind that it will output an .nds file with the same name as the input directory, so consider renaming it after initially unpacking.