JUSToolkit

Romhacking tools for Jump Ultimate Stars! (NDS)

Features

Done ✔️ To test / with issues ⚠️ Not done 🛑

Containers

• Pack .aar ALAR3 ✔️
• Unpack .aar ALAR3 ✔️
• Pack .aar ALAR2 ✔️
• Unpack .aar ALAR2 ✔️

Graphics

• Extract ALMT + DIG ✔️
• Import ALMT + DIG ✔️
• Extract DTX ✔️
• Import DTX 🛑

Texts

• In progress, mostly done 🛑

Batch Features

• Extract every .dig from any .aar (ALAR2/ALAR3) to PNG ✔️
• Import multiple PNGs to an .aar ALAR3 container ✔️

Tinke

You can use Tinke by PleoNex to unpack containers and view .dig files.

Build

The project requires to build .NET 6.0 SDK (Linux and MacOS require also Mono). If you open the project with VS Code and you did install the VS Code Remote Containers extension, you can have an already pre-configured development environment with Docker or Podman.

To build, test and generate artifacts run:

# Only required the first time
dotnet tool restore

# Default target is Stage-Artifacts
dotnet cake

To just build and test quickly, run:

dotnet cake --target=BuildTest

How To Use

./JUS.CLI jus [type] [feature] [args]

• graphics
  • export-dtx
  • export-dig
  • import-dig
• containers
  • export-alar3
  • import-alar3
  • export-alar2
  • import-alar2
• batch
  • export-alar-png
  • import-png-alar3

To get the arguments of a feature you can use: ./JUS.CLI jus [type] [feature] -h

Examples: ./JUS.CLI jus containers export-alar3 --container test.aar --output myDirectory ./JUS.CLI jus containers export-alar3 -h

Documentation

Documents

You can find these documents in our docs/dev folder:

• Alar Specification
• DTX Specification by PleoNex
• DTX Research by PleoNex
• FileFormats by Uknown Hacker

Videos

PleoNex did some research on Streaming:

• DIRECTO ROM Hacking: Triple reto de imágenes
• DIRECTO Domingos de desensamblador: imágenes de Devil Survivor y JUS y ordenar textos de MetalMax 3
• DIRECTO Predomingos de desensamblador: CLYT de 3DS y el complejo caso de los sprites de JUS

Stack

• C# Net Core 6
• YARHL by PleoNex
• PleOps by PleoNex

Credits

Special thanks to PleoNex for his help, for Yarhl and PleOps.Cake. Thanks to TraduSquare for the inspiration and support. Thanks to the Jump Ultimate Stars! devs for this amazing game.