Dynamic Xtreme Quick Start
| English | Português | Español | 日本語 |
Welcome to Dynamic Xtreme.
This guide explains the basic installation process, folder structure, and recommended workflow.
Requirements
Dynamic Xtreme requires the .NET 8 Runtime to be installed.
If the runtime is not installed, the application may fail to start or display a missing framework error.
Download the runtime from the official Microsoft website:
Dynamic Xtreme is a console application and only requires the standard .NET Runtime. The .NET Desktop Runtime is not required.
Folder Structure
Dynamic Xtreme uses several folders to organize its dynamic resources and configuration files.
DynamicInfos
This folder contains files with the following extension:
*.dynamicinfo
These files contain information related to the insertion of dynamic resources into the ROM.
Among other things, they are used to insert dynamic resources such as:
- Graphics.
- Tilemaps.
- Color palettes.
- Generate dynamic sprite tables.
- Provide the information required to upload each dynamic pose into VRAM.
- Register color palettes later used by dynamic sprites.
DrawInfos
This folder contains files with the following extension:
*.drawinfo
These files contain the information required to draw each pose on-screen using OAM. They are used by Dynamic Xtreme's drawing system.
DynamicResources
This folder contains resources used to perform dynamic PPU changes.
Although these files usually use the extension:
*.bin
There is no actual limitation on the file extension.
Common examples include:
- Graphics.
- Tilemaps.
- Color palettes.
- "*.brr" files.
Resources inserted into the ROM through this folder are inserted in uncompressed form.
PaletteEffects
This folder contains files with the following extension:
*.paleffect
These files contain information used to create color palette effects more easily using Dynamic Xtreme.
These effects typically modify:
- RGB channels
- HSL channels
Installation
Before installing, place your files into their corresponding folders.
Dynamic Xtreme can be installed in two different ways.
Method 1: Running dxt.exe
Simply double click "dxt.exe". A console window will open with step-by-step installation instructions.
Required Configuration
Input ROM Path
Path of the ROM you want to modify.
You can:
- Type the path manually.
- Drag and drop the ROM into the console.
Output ROM Path
Path where the modified ROM will be saved.
You can:
- Type the path manually.
- Drag and drop the ROM into the console.
If left empty and the settings are empty, the input ROM path will be reused.
PIXI Executable Path (Optional)
Path to the PIXI executable.
You can:
- Type the path manually.
- Drag and drop the executable into the console.
UberASMTool Executable Path (Optional)
Path to the UberASMTool executable.
You can:
- Type the path manually.
- Drag and drop the executable into the console.
GPS Executable Path (Optional)
Path to the GPS executable.
You can:
- Type the path manually.
- Drag and drop the executable into the console.
System Features
After configuring the paths, Dynamic Xtreme will ask whether you want to enable or disable different system features.
Type "y" to enable a feature or "n" to disable it.
The instructions are shown explicitly in the console during installation.
Method 2: -use-settings
You can also run Dynamic Xtreme using previously saved settings.
Example:
dxt -use-settings
In this mode, Dynamic Xtreme will load the settings from a previous installation stored in Settings/Settings.json. If any setting is invalid or required information is missing, the tool will ask for the full configuration again manually.
This is useful for quickly reinstalling after making changes.
Installing Dynamic Sprites
Once Dynamic Xtreme is installed, you can install dynamic sprites normally using PIXI.
Recommended Workflow
Whenever you add or modify:
- .dynamicinfo
- .drawinfo
- Dynamic Resources
- .paleffect
You must reinstall Dynamic Xtreme and re-run any tools that depend on it:
- PIXI
- UberASMTool
- GPS
If dependent tools are not reinstalled, newly added resources or changes may not be reflected correctly in the ROM.
It is recommended to use a file (such as a *.bat) that runs the dxt -use-settings command when double-clicked and then installs PIXI, UberASMTool, and GPS afterward, as this can save a lot of time.