wackman/README.md
2025-11-06 22:52:56 +01:00

2.5 KiB

wackman

Bunch of scripts to assist in running WACCA on linux WARNING: I made these scripts for personal use. Use with your own discretion. ANOTHER WARNING: The data for WACCA S (1.50) from archive.org is corrupted. The game will not work with this version.

Requirements

  • vhditools (Build from git, otherwise vhdimount will complain about missing VHDI subsystem)
  • umu-launcher
  • fsdecrypt
  • aria2c
  • udisks2
  • MercuryModder (Optional: only required for injecting charts into the game)
  • metra (Optional: Only required for injecting english translations into the game)
  • mangohud (Optional: Only required if you want to have a FPS counter)

Configuration

Configuration is done with the .config file, an example can be found in .config.example

Folder structure

  • imagestore:
    • index.csv: File containing all versions of the game with their respective archive.org links
    • app: Folder containing source .app files
    • vhd: Folder containing decrypted .vhd files
    • misc:
      • customcharts: Folder containing custom charts for MercuryModder to inject
      • translations: Folder containing .toml files like this that contain translations for the game
      • ICF1: File that is required by the game
      • segatools.zip: File that is required by the game

What do the scripts do?

./init.sh

  • check_prereqs: Check if requirements are installed
  • get_required_app: Get a list of required .app files
  • import_from_ins: Check for the presence of a SEGA_INS drive and pulls game files from it
  • extract_apps:
    • Download .app from archive.org with aria2c (Only if AIRGAP=false in .config)
    • Extract the .vhd from the .app with fsdecrypt
  • patchbin: Normalize the parent filename of the .vhd so that vhdimount wont freak out
  • mount:
    • Make required folders in $WORKDIR/$VERSION
    • Mount the blockdevice that vhdimount presents in $WORKDIR/$VERSION/dev
    • Mount the NTFS partition from the mounted blockdevice in $WORKDIR/$VERSION/lower
    • Mount an overlayfs consisting of the $WORKDIR/$VERSION/lower at $WORKDIR/$VERSION/game
  • apply_patches: Apply scripts from the ./patches dir that configure the game to work

./launch.sh

  • Launches the game

./unmount.sh

  • Unmounts the game files