The wiki has been upgraded to MediaWiki 1.43. The wiki's theme is still being adapted to work with the new version, and may appear broken for the time being. --RanAS

Hitman Tool Quick Start

From SnesLab
Jump to: navigation, search
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.