falso
/
perfect_dark
mirror of https://github.com/n64decomp/perfect_dark.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A decompilation of Perfect Dark. (MIRROR of https://gitlab.com/ryandwyer/perfect-dark)
657 Commits 5 Branches 0 Tags 133 MiB
C 91.4%
Python 4.2%
Assembly 3.4%
C++ 0.8%
Makefile 0.2%
Go to file
Ryan Dwyer 2f3fd64652 Decompile func0f04ceec 2019-12-21 00:13:35 +10:00
ld Rename rarezip segment to inflate 2019-12-16 17:41:04 +10:00
src Decompile func0f04ceec 2019-12-21 00:13:35 +10:00
tools Rename rarezip segment to inflate 2019-12-16 17:41:04 +10:00
.gitignore Restructure files 2019-10-07 17:50:26 +10:00
Makefile Rename rarezip segment to inflate 2019-12-16 17:41:04 +10:00
README.md Rename rarezip segment to inflate 2019-12-16 17:41:04 +10:00
checksums.md5 Rename rarezip segment to inflate 2019-12-16 17:41:04 +10:00
macros.inc Start decompiling rarezip binary 2019-09-18 22:27:03 +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.

Roadmap

Section Progress
0x40 rspboot Won't disassemble as source is likely ASM
0x1000 boot 22/52 functions done (42.31%)
0x3050 library 27/950 functions done (2.84%)
0x39850 setup About 50% identified
0x4e850 inflate 2/8 functions done (25.00%)
0x4fc40 game 478/4196 functions done (11.39%)
Lang files Done
Setup files Done
Prop files Not started
Character files Not started
Gun files Not started
BG files Not started
Pad files Not started
Tile files Done

If you want to browse the stage setup files, use this table to find the filename:

Stage File
Defection setupame.c
Investigation setupear.c
Extraction setupark.c
Villa setupeld.c
Chicago setuppete.c
G5 Building setupdepo.c
Infiltration setuplue.c
Rescue setuplip.c
Escape setuptra.c
Air Base setupcave.c
Air Force One setuprit.c
Crash Site setupazt.c
Pelagic II setupdam.c
Deep Sea setuppam.c
Defense setupimp.c
Attack Ship setuplee.c
Skedar Ruins setupsho.c
MBR setupwax.c
Maian SOS setupsev.c
WAR! setupstat.c
The Duel setupate.c
CI Training setupdish.c

There is also a stagetable.txt in the repository root which includes multiplayer stages.

Installation Requirements

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

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

The project can do the following:

  • Build individual ucode binaries (boot, library, setup, inflate and game) which match the ones extracted from the base ROM.

  • Build a functioning ROM by splicing the C source and assets into an existing ROM. The built ROM is not byte perfect yet, but is is functionally equivalent.

  • Run make to build the assets that will be included in the ROM. These files will be written to build/ntsc-final and are matching what's in the extracted/ntsc-final folder.

  • 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 everything is matching.