Hitman Tool Quick Start
| English | Português | Español | 日本語 |
This guide shows how to install Hitman Tool on Windows or Linux.
Requirements
Install the .NET 8 runtime for your operating system. The runtime is enough.
Download Hitman Tool from SNEStorage and extract the entire package.
Prepare your resources
PIXI sprites
Copy each sprite package to the matching PIXI folder. Keep its files and subfolders together.
sprites/for Normal sprites.cluster/for Cluster sprites.extended/for Extended sprites.
Add the sprite to the PIXI list. If its ASM links files with ;#inchbi or ;#inchmprop, keep those files at the paths specified in the ASM.
UberASMTool resources
Copy each resource to the appropriate folder, such as level/, overworld/, or gamemode/, and add it to the UberASMTool list. If its ASM links a .hitboxinfo file with ;#inchbi, keep that file where the resource expects it.
Traditional folders
If a resource tells you to put its files in the Hitman Tool folder, use these paths.
| File | Folder |
|---|---|
.hitboxinfo file |
HitboxInfo/
|
| Per-sprite property JSON | CustomProperties/PerSprite/
|
Install Hitman Tool
Make a copy of your project's ROM to use as the output. That file must already exist when you run Hitman Tool.
Open a terminal in the Hitman Tool folder. Run .\ht.exe on Windows or ./ht on Linux and answer the prompts.
| Prompt | Example |
|---|---|
| Input ROM | C:\MyHack\MyHack.smc
|
| Output ROM | C:\MyHack\MyHack_Hitman.smc
|
| PIXI folder | C:\MyHack\PIXI
|
| PIXI list | C:\MyHack\PIXI\list.txt
|
| UberASMTool folder (optional) | C:\MyHack\UberASMTool. Press Enter to skip it.
|
| UberASMTool list (if you entered the folder) | list.txt if it is inside that folder. Press Enter to install only the Hitman Tool defines.
|
Paths are saved in Json/Settings.json. Add -use-settings to the command to use them again. To change or disable the UberASMTool integration, run without that argument and answer the prompts again.
Finish the installation
Run PIXI on the output ROM using the same sprite list. If you configured UberASMTool, run it on that ROM too.
When you change hitbox files or properties that Hitman Tool reads, run Hitman Tool again before PIXI and, if you use it, UberASMTool.