Silent Hill 3 Decompilation

<div align="center"> <h3>✶ memory of alessa ✶</h3> <p><em>Silent Hill 3 (PS2) matching decompilation project</em></p> </div>

project goals

⋆˙⟡ 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

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

1. 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.

2. 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

WSL or similar is required. It has been tested by several of our contributors.

If you encounter problems feel free to leave an issue, or submit a pull request to improve these instructions.

more on development

See our documentation:

✶ contributing.md <br> ✶ development.md <br> ✶ guidebook.md <br> ✶ style.md <br> ✶ llm-policy.md <br>

credits

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

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