Game-Decompilation/sf64
1
0
Fork 0
mirror of https://github.com/sonicdcer/sf64.git synced 2024-11-23 21:09:56 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Decompilation of Starfox 64
230 Commits 13 Branches 0 Tags 30 MiB
C 98.1%
Python 1.5%
Makefile 0.3%
c068831444
Go to file
Alejandro Javier Asenjo Nitti c068831444 func_8008E5E8
2023-10-13 06:13:30 -03:00
.vscode . 2023-10-06 03:10:31 -03:00
include func_8008E5E8 2023-10-13 06:13:30 -03:00
linker_scripts/us versus menu 2023-10-12 09:28:57 -03:00
src func_8008E5E8 2023-10-13 06:13:30 -03:00
tools python requirements 2023-10-12 14:00:52 -03:00
yamls fix yaml for baserom.uncompressed 2023-10-13 05:53:33 -03:00
.clang-format Add formatter 2023-10-07 04:38:28 -03:00
.clang-tidy Add formatter 2023-10-07 04:38:28 -03:00
.gitignore gitignore update 2023-10-06 06:54:59 -03:00
.gitmodules add asm-processor 2023-09-21 19:26:26 -03:00
diff_settings.py diff settings 2023-10-06 09:38:01 -03:00
Makefile ido_recomp 2023-10-12 13:50:08 -03:00
README.md readme correct 2023-10-12 14:01:43 -03:00
starfox64.us.md5 md5 for the uncompressed rom 2023-10-13 05:34:34 -03:00
symbol_addrs.txt initial setup 2023-09-19 16:14:04 -03:00

README.md

Starfox 64 (US) REV 1.1

This is a WIP decompilation of Starfox 64. The purpose of the project is to recreate a source code base for the game from scratch, using information found inside the game along with static and/or dynamic analysis.

It currently builds the following ROM:

  • starfox64.us.z64 md5: 741a94eee093c4c8684e66b89f8685e8

This repo does not include any assets or assembly code necessary for compiling the ROM. A prior copy of the game is required to extract the required assets.

Installation

Windows

For Windows 10, install WSL and a distribution by following this Windows Subsystem for Linux Installation Guide. We recommend using Debian or Ubuntu 22.04 Linux distributions.

Linux (Native or under WSL / VM)

1. Install build dependencies

The build process has the following package requirements:

  • make
  • git
  • build-essential
  • binutils-mips-linux-gnu
  • python3
  • pip3
  • libpng-dev

Under Debian / Ubuntu (which we recommend using), you can install them with the following commands:

sudo apt update
sudo apt install make git build-essential binutils-mips-linux-gnu python3 python3-pip libpng-dev

2. Clone the repository

Create your own fork of the repository at https://github.com/sonicdcer/sf64. Then clone your fork where you wish to have the project, with the command:

git clone https://github.com/<YOUR_USERNAME>/sf64.git

This will copy the GitHub repository contents into a new folder in the current directory called sf64. Change into this directory before doing anything else:

cd sf64

3. Install python dependencies

The build process has a few python packages required that are located in /tools/requirements-python.txt.

To install them simply run in a terminal:

python3 -m pip install -r ./tools/requirements-python.txt

4. Prepare a base ROM

Copy your ROM to inside the root of this new project directory, and rename the file of the baserom to reflect the version of ROM you are using. ex: baserom.us.z64

5. Make and Build the ROM

To start the extraction/build process, run the following command:

make init

This will create the build folders as well as a new folder with the assembly as well as containing the disassemblies of nearly all the files containing code.

this make target will also build the ROM. If all goes well, a new ROM called "starfox64.us.z64" should be built and the following text should be printed:

741a94eee093c4c8684e66b89f8685e8  build/starfox64.us.z64
./build/starfox64.us.z64: OK

If you instead see the following:

./build/starfox64.us.z64: FAILED
md5sum: WARNING: 1 computed checksum did NOT match

This means that something is wrong with the ROM's contents. Either the base files are incorrect due to a bad ROM, or some of the code is not matching.