Tools, templates, and information for modding and researching Phantom Dust files. These tools mainly focus on ALR files, but there are also some simple tools for Deck/Arsenal files and SSB menu script files. You can find more info about the game and file formats on the Phantom Dust Modding Wiki.
This is the main program for this repo, a graphical editor for ALR files. It understands (to varying degrees) textures, meshes, animations, and skeleton data found in ALRs. Polaris is designed to replace normal hex editors for ALR modding, without giving up the flexibility. There are mini hex editors in nearly every window, so you can quickly jump to the data you want (and see only that data).
Support status:
| Feature | Viewing | Export | Import |
|---|---|---|---|
| Textures (square) | ✅ | ✅(.dds) |
✅ (.dds, at same resolution & format) |
| Textures (atlas) | ✅ | ✅(.dds) |
❌ |
| Character meshes | ✅ | ✅(.obj) |
❌ |
| Stage meshes | ✅ | ✅ (.obj) |
❌ |
| Animations | ✅ (graph) | ❌ (WIP .anim export) |
❌ |
| Skeleton | ❌ | ✅ (.dae) |
❌ |
Here's what the UI for viewing/editing map files and textures looks like:
And the UI for texture atlases:
Polaris takes a filename as its first argument (which also means you can drag-and-drop
files onto the executable). You can also specify another flag to run a specific
operation in headless mode (no GUI):
polaris [alr filename] [flag]
--dump-textures- Dump all textures to a
texturesfolder in DDS format.
- Dump all textures to a
--validate- Run assertions and consistency checks across the whole file. Doesn't guarantee the file will work in the game, just that nothing looks wrong based on our current knowledge of ALRs.
This program can export/replace textures, and split ALR files apart in a few different ways. It's been mostly obseleted by
Polaris, but is still more reliable for unusual files (like bosses) and uncommon
texture formats (like cubemaps). Here's some typical output:
alr [input file] [flag] [output file (if applicable)]
--dump- Dumps all textures from the file, guessing the best format and size using metadata from 2 parts of the file. Has a bad habit of dumping one file with correct format but wrong size, and one with the wrong format and correct size. Use Polaris instead, except for cubemaps.
--info- Does a "dry run", printing out info but not dumping any files.
--replace- Searches for textures that you dumped earlier, and replaces textures in the ALR with those files. Allows you to dump textures, edit them, then replace them in the ALR.
This is a very simple TUI editor for deck/arsenal files. In the style of a simple batch script menu, you select a menu option by number and type in a new value. The menu updates in-place instead of scrolling.
This is even more barebones than the deck editor, because I don't work with SSBs often. Our resident SSB expert is Vu, who has some Python tools here. For more information on the file format, check out the wiki page. The tool in this repo will only display an SSB's function export table:
