Banjo-Kazooie (100.0000%)

Baserom checksums

• baserom.us.v10.z64: 1fe1632098865f639e22c11b9a81ee8f29c75d7a
• baserom.us.v11.z64: ded6ee166e740ad1bc810fd678a84b48e245ab80
• baserom.jp.z64: 90726d7e7cd5bf6cdfd38f45c9acbf4d45bd9fd8
• baserom.pal.z64: bb359a75941df74bf7290212c89fbc6e2c5601fe

Building

The following instructions should work on the following platforms:

• Ubuntu 18.04 or higher (x86_64)
• Docker only
  • Linux (x86_64, ARM)
  • macOS (x86_64, ARM)

Building Instructions Table Of Contents:

• Local (Linux)
• Local (Docker - Linux/macOS)
• Cloud (GitLab CI))

Local (Linux)

Works with Ubuntu 18.04 or higher.

1. Install dependencies

sudo apt-get update && sudo apt-get install -y $(cat packages.txt)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git submodule update --init --recursive
python3 -m pip install -r requirements.txt

2. Add baserom

Add the file for US v1.0 as baserom.us.v10.z64 in the project folder.

(optional): Check the baserom checksum

sha1sum baserom.us.v10.z64

The output should match the checksum specified above.

3. Build

To extract and build everything simply run:

make

If you want to build a specific module, instead do:

make <module_id>

...where the following are supported values of <module_id>

• core1
• core2
• MM
• TTC
• CC
• BGS
• FP
• lair
• GV
• CCW
• RBB
• MMM
• SM
• fight
• cutscenes

Version Selection

Drop in us.v10 us.v11, jp, or pal as baserom.<version>.z64 e.g. baserom.us.v11.z64

make VERSION=us.v11

Local (Docker - Linux/macOS)

1. Get the Docker image

(if available) you can pull it from GitLab (but you need to be logged in):

docker login registry.gitlab.com
docker pull registry.gitlab.com/banjo.decomp/banjo-kazooie:latest

(otherwise) you can build it yourself:

docker build -t banjo-kazooie .

NOTE for ARM users (Windows ARM, Raspberry Pi and similar, or Apple Silicon): Use this command instead:

docker build --platform linux/amd64 -t banjo-kazooie .

2. Add baserom

Follow the same instructions as Step 3 above in "Local (Linux)".

3. Run the Docker container

docker run -it --rm -v $(pwd):/banjo banjo-kazooie 

NOTE for ARM users: Use this command instead:

docker run --platform linux/amd64 -it --rm -v $(pwd):/banjo banjo-kazooie 

4. Build

Follow the same instructions as Step 4 above in "Local (Linux)".

To exit Docker, simply type exit.

Cloud (GitLab CI)

These are the instructions for building on GitLab CI. This applies to the main repo - if you have a fork, you will need to follow these steps too!

1. Upload the baserom

Upload the file for US v1.0 as baserom.us.v10.enc.z64 to a remote server where it can be downloaded from with wget or curl. The file has to be encrypted with AES-256-CBC, as follows:

openssl enc -aes-256-cbc -salt -in baserom.us.v10.z64 -out baserom.us.v10.enc.z64

Then, upload the encrypted file to a server and get a direct download link.

Sharing services like Google Drive, Dropbox, or OneDrive might not work, as they require manual interaction to download the file.

2. Set up environment variables

In your GitLab project, go to Settings > CI/CD > Variables and add the following variables (for each version):

• BASEROM_<VER>_URL: a direct download URL for the baserom.us.v10.z64 file (see above); this file has to be encrypted with AES-256-CBC
• BASEROM_<VER>_KEY: the AES key used to encrypt the baserom file above
• BASEROM_<VER>_SHA1: the SHA1 checksum of the baserom file; simply use the one mentioned above

Replace <VER> with the version you are using:

• US10
• US11
• JP
• PAL

3. Trigger the pipeline

Push a commit to your repository and you should see a new pipeline starting in the CI/CD > Pipelines section!