Space Station Silicon Valley N64 Decomp
A work-in-progress decompilation of the Space Station Silicon Valley game for the Nintendo 64.
Note: You must legally own a copy of the original game to use this repository.
Check out the wiki for more detailed information.
The instructions below assume that you will be using Ubuntu 22.04; either natively, via WSL2, or via Docker.
Please check the packages.txt and requirements.txt for the prerequisite Linux and Python packages respectively.
Clone the repository; note the --recursive flag to fetch submodules at the same time:
git clone --recursive git@github.com:mkst/sssv.git
Navigate into the freshly cloned repo
cd sssv
Place the US 1.0 SSSV ROM in the root of this repository, name it baserom.us.z64, and then run the first make command to extract the ROM:
make extract
Now build the ROM:
make --jobs
If you did everything correctly, you’ll be greeted with the following:
build/sssv.us.z64: OK
Clone this repository, place the baserom.us.z64 at its root, and then run the Docker image via:
docker run --rm -ti -v $(pwd):/sssv ghcr.io/mkst/sssv:latest
From here you can run the make extract and make --jobs commands.
EU VersionPlace baserom.eu.z64 in the root of the repository, and suffix each make command with VERSION=eu. Note that whilst this will build the EU ROM, minimal effort has been made to decompile this version.
NON_MATCHING VersionA number of functions within the ROM have been decompiled to a state where they are functionally equivalent, but are not a byte-perfect match. Progress is approximately 11% ahead of the fully matching build. In order to build/test the non-matching, pass NON_MATCHING=1 to the make commands.
There are 5 known versions of the ROM:
| Country Code | CRC1/CRC2 | ROM SHA1 | Notes | Version |
|---|---|---|---|---|
| E - North America | BFE23884/EF48EAAF |
e5e09205aa743a9e5043a42df72adc379c746b0b |
US 1.0 | 1.37 |
| J - Japanese | BFE23884/EF48EAAF |
7320f08474c011fc7781093bf1a6818c37ce51e2 |
JP (Unreleased) | 1.37 |
| E - North America | FC70E272/08FFE7AA |
c968bba6a90db9ecbd957e910684a80726b0497d |
US 1.1 | 1.37 |
| P - European | FC70E272/08FFE7AA |
23710541bb3394072740b0f0236a7cb1a7d41531 |
EU | 1.37 |
| ??? | ??? | ??? | NES World | 1.26B |
Only US and EU versions were released to the public. If you are in possession of a beta/prototype ROM, please let me know - mkst#4741.
The layout of the ROM is work-in-progress. Three sections of code have been identified along with a mix of compressed and non-compressed data.
This is the code that is loaded when the ROM first starts up, it is responsible for spawning the various game threads, handling controller input, playing sound effects etc. Also includes the libultra library code.
This is the code for the language select, intro cinematics and not much else.
Note: In the EU ROM this section is compiled without optimisation!
Overlay2 contains the core Space Station Silicon Valley game logic.
Uses RNC for a number of assets.
Compression is almost completely matching; 261/263 files match after compression. rnc_461900 and rnc_63DC20 are still a problem.
In order to decompress the game assets run make decompress after you have performed the make extract step. This will be done automatically when matching compression has been figured out.
asm/ ; assembly files split by splat (not checked in)assets/ ; binary files split by splat (not checked in)build/ ; build folder (not checked in)include/2.0I/ ; libultra 2.0I headerslib/libultra.a ; libultra 2.0I static librarysrc.{us|eu})/core/ ; core codedata/ ; game data e.g. DisplayLists, Vtx + morelibultra/ ; custom libultra codesssv/ ; game codetools/ido5.3_recomp/ ; static recompilation of IDO 5.3 compilersplat_ext ; custom splat extensions
GLOBAL_ASM pragma - replacing assembly inside C files