Skip to content

README.md

Latest commit

 

History

History
73 lines (50 loc) · 2.64 KB

README.md

File metadata and controls

73 lines (50 loc) · 2.64 KB

✶ memory of alessa ✶

Silent Hill 3 (PS2) matching decompilation project

project goals

sh3 functions sh2 functions sh3 stages

⋆˙⟡ 100% byte-matching decompilation of Silent Hill 3, a survival horror masterpiece.

⋆˙⟡ 100% byte-matching decompilation of Silent Hill 2 engine, the foundation for Silent Hill 3.

⋆˙⟡ Learning & documenting the technical history of Team Silent's PS2 engine.

🔴 This project is in early stages. Things are likely to change and may be wrong.

setup

  1. python3, wget, and essential build packages are prerequisites.

  2. Insert the disc of Silent Hill 3 v1.02 (NTSC-U) for the PlayStation 2 into your computer. It has serial number SLUS_206.22 and its ISO's SHA1 is 0f7b0d5d75fe34ddf72e26aae1b4f5e7891282b0.

  3. Copy the SLUS_206.22 file as well as B0.MFA into the folder at rom/SLUS_206.22 in this repository.

Then proceed below depending on your operating system.

linux (x86-64) & macOS (aarch64)

On first setup, run the following commands in the root directory of this repository. They will set up a virtual environment and install the required Python packages.

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt

Then run make. This will download the toolchain, extract files, and build Silent Hill 3.

make

windows

Untested, but WSL or similar is required.

more on development

See docs/development.md.

credits

Tremendous thanks to the decompals for making this project possible, as well as to each of the following projects below.

✶ silent-hill-decomp
✶ Himuro
✶ mh1j
✶ parappa2
✶ xenogears-decomp
✶ 3s-decomp
✶ rood-reverse
✶ SPPS
✶ recvx-decomp