BIT.TRIP COMPLETE

Decompilation of BIT.TRIP COMPLETE for the Wii, and effectively each individual BIT.TRIP Wiiware entry.

See decomp-toolkit for background on the concept and more information on the tooling used.

This repository does not contain any game assets or assembly whatsoever. An existing copy of the game is required.

The Game ID is SVTEXS, SHA-1 for main.dol is 9aca906b6e11bdf9a95a382095dbe84cbf83c206.

Dependencies

Windows

On Windows, it's highly recommended to use native tooling. WSL or msys2 are not required.
When running under WSL, objdiff is unable to get filesystem notifications for automatic rebuilds.

• Install Python and add it to %PATH%.
  • Also available from the Windows Store.
• Download ninja and add it to %PATH%.
  • Quick install via pip: pip install ninja

Linux

• Install ninja.

wibo, a minimal 32-bit Windows binary wrapper, will be automatically downloaded and used.

Building

• Clone the repository:

  git clone https://github.com/Fatih120/bittrip.git

• Copy your game's disc image to orig/SVTEXS.

  • Supported formats: ISO (GCM), RVZ, WIA, WBFS, CISO, NFS, GCZ, TGC
  • After the initial build, the disc image can be deleted to save space.

• Configure:

  python configure.py

• Build:

  ninja

Documentation

• Dependencies
• Getting Started
• symbols.txt
• splits.txt
• GitHub Actions

General:

• Common BSS
• .comment section

Features

• Feature-rich analyzer: Many time-consuming tasks are automated, allowing you to focus on the decompilation itself. See Analyzer features.
• REL support: RELs each have their own symbols.txt and splits.txt, and will automatically be built and linked against the main binary.
• No manual assembly: decomp-toolkit handles splitting the DOL into relocatable objects based on the configuration. No game assets are committed to the repository.
• Progress calculation and integration with decomp.dev.
• Integration with objdiff for a diffing workflow.
• CI workflow template for GitHub Actions.

Project structure

• configure.py - Project configuration and generator script.
• config/[GAMEID] - Configuration files for each game version.
• config/[GAMEID]/build.sha1 - SHA-1 hashes for each built artifact, for final verification.
• build/ - Build artifacts generated by the the build process. Ignored by .gitignore.
• orig/[GAMEID] - Original game files, extracted from the disc. Ignored by .gitignore.
• orig/[GAMEID]/.gitkeep - Empty checked-in file to ensure the directory is created on clone.
• src/ - C/C++ source files.
• include/ - C/C++ header files.
• tools/ - Scripts shared between projects.