Here are the important files and folders in a Paper Mario DX mod.
- README.md
Directoryassets
Directorydx Assets provided by DX (do not edit)
- …
Directoryus Assets dumped from the baserom (do not edit)
- …
Directoryinclude C headers
- …
Directorysrc Your mod's code and assets
Directorydx
- config.h Mod configuration
- …
- … Other files/folders are internal to DX
The assets folder
The assets folder contains the game content (not engine code) that DX and the base game provide: assets/dx/ holds DX's changes, and assets/us/ the base game's content, split from your copy of the game.
Your mod's content goes in src, alongside its code. Content is layered: src/ takes priority over assets/dx/, which takes priority over assets/us/. For example, the file assets/us/msg/0C_Chapter1.msg can be overridden by creating a file at src/msg/0C_Chapter1.msg. You can create the msg folder if it doesn't exist.
Because the layers share one layout, this manual writes paths relative to them. For example, battle/actor/gloomba.c means the file at that path in src/, assets/dx/, or assets/us/, and dx/config.h means src/dx/config.h. When the manual asks you to create a file, create it under src/.
The src and include folders
These folders contain C code for the game engine. You can edit it freely, just note that you may get merge conflicts when updating to a new version of DX.
The dx/config.h file
This is where you configure mod settings like the mod name and new game start, the debug menu, and more. You don't need to understand C code to use these options — just edit the file.