Rebuilding a game or application for use with HANS - ihaveamac/3DS-rom-tools GitHub Wiki

This guide explains how you can rebuild a Read-Only Filesystem (RomFS) and use decompressed code for use with smealum's HANS, included with the *hax starter kit.

Requirements

  • A 3DS system with access to *hax 2.5 or later
  • HANS from the homebrew starter pack
  • 3dstool

Rebuilding RomFS

  • Use 3dstool to rebuild the RomFS:

    3dstool -cvtf romfs XXXXXXXX.romfs --romfs-dir romfs
  • Name the filename after the last 8 characters of the title ID, with the extension .romfs.
    Or, if using a text file with HANS (e.g. eshop.txt), use its file name (e.g. eshop.romfs)

  • Place this file in /hans on your SD card.

Using custom, decompressed code

  • If your code.bin is not decompressed, use 3dstool to decompress it:

    3dstool -uvf code.bin --compress-type blz --compress-out code-decompressed.bin
  • Name the filename after the last 8 characters of the title ID, with the extension .code.
    Or, if using a text file with HANS (e.g. eshop.txt), use its file name (e.g. eshop.code)

  • Place this file in /hans on your SD card.

⚠️ **GitHub.com Fallback** ⚠️