Game-Decompilation/perfect_dark
1
0
Fork 0
mirror of https://github.com/n64decomp/perfect_dark.git synced 2024-11-23 13:59:42 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
A decompilation of Perfect Dark. (MIRROR of https://gitlab.com/ryandwyer/perfect-dark)
3,197 Commits 5 Branches 0 Tags 122 MiB
C 91.3%
Python 4.2%
Assembly 3.5%
C++ 0.8%
Makefile 0.2%
46deaccf96
Go to file
Ryan Dwyer 46deaccf96 Decompile objectiveInsert
2020-11-29 16:54:22 +10:00
docs Update filenames in AI list documentation 2020-02-02 23:36:03 +10:00
ld Rename game_113220.c to bondview.c 2020-11-23 23:19:52 +10:00
src Decompile objectiveInsert 2020-11-29 16:54:22 +10:00
tools Fix build errors on Debian 2020-11-02 18:05:10 +10:00
.gitignore Restructure files 2019-10-07 17:50:26 +10:00
checksums.jap-final.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
checksums.ntsc-1.0.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
checksums.ntsc-beta.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
checksums.ntsc-final.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
checksums.pal-beta.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
checksums.pal-final.md5 Convert unknown1 segment to C and rename to textureconfig 2020-10-11 15:24:19 +10:00
macros.inc Start decompiling rarezip binary 2019-09-18 22:27:03 +10:00
Makefile Fix build errors on Debian 2020-11-02 18:05:10 +10:00
README.md Restructure build workflow 2020-08-25 20:40:35 +10:00
stagetable.txt Initial commit 2019-09-06 08:09:40 +10:00

README.md

Perfect Dark Decompilation (WIP)

This repository contains a work-in-progress decompilation of Perfect Dark for the Nintendo 64.

Status

See the Perfect Dark Decompilation Status Page.

Installation Requirements

  • make
  • mips build tools (Debian/Ubuntu: binutils-mips-linux-gnu, Arch: mips64-elf-binutils from AUR)
  • Python 3

ROM Versions

Perfect Dark has six known versions:

ROM ID Description
ntsc-final NTSC 8.7 final - fully supported
ntsc-1.0 NTSC 8.7 final (the initial, buggy release) - fully supported
ntsc-beta NTSC 6.4 beta - can extract assets only
pal-final PAL 8.7 final - can extract assets only
pal-beta PAL 28.7 beta - can extract assets only
jap-final Japanese 8.7 final - can extract assets only

Currently only the ntsc-final and ntsc-1.0 versions are fully supported. The NTSC beta, PAL and JAP versions can have their assets extracted from the base ROM but no effort has been made to build those versions back into a ROM.

The project uses the $ROMID environment variable to know which version to work with. If not set, it defaults to ntsc-final. You can change it by running something like export ROMID=ntsc-1.0.

Extracting the base ROM

Before you do anything you need an existing ROM to extract assets from.

  1. Save your existing ROM file into the root of the repository with the name pd.ntsc-final.z64. It should not be byteswapped (the first four bytes should be 0x80371240).
  2. Run make extract. This will create an extracted/ntsc-final directory containing assets from your ROM.

Compiling

  • Run make rom to build the ROM. The ROM will be written to build/ntsc-final/pd.z64.

How do I know the built files are matching?

Run make followed by make test. If make test produces no output then all compiled segments are matching.

You can also md5sum your base ROM with the built ROM and check they have the same hash: md5sum pd.ntsc-final.z64 build/ntsc-final/pd.z64.