Game-Decompilation/sotn-decomp
1
0
Fork 0
mirror of https://github.com/Xeeynamo/sotn-decomp.git synced 2024-11-26 22:40:33 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
Decompilation of Castlevania: Symphony of the Night (PSX+Saturn)
2,741 Commits 18 Branches 1 Tag 62 MiB
C 87.3%
Python 3.6%
C++ 3.3%
Go 3.2%
Rust 1.4%
Other 1.2%
319eed124b
Go to file
Josh Schreuder 319eed124b
Some checks are pending
Format code / format (push) Waiting to run
Details
Build C code / extract-assets (push) Waiting to run
Details
Build C code / build-linux (i686, Debug, clang, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, Debug, clang, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, Debug, gcc, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, Debug, gcc, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, RelWithDebInfo, clang, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, RelWithDebInfo, clang, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, RelWithDebInfo, gcc, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (i686, RelWithDebInfo, gcc, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, Debug, clang, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, Debug, clang, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, Debug, gcc, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, Debug, gcc, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, RelWithDebInfo, clang, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, RelWithDebInfo, clang, lle) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, RelWithDebInfo, gcc, custom) (push) Blocked by required conditions
Details
Build C code / build-linux (x86_64, RelWithDebInfo, gcc, lle) (push) Blocked by required conditions
Details
Build C code / build-macos (Debug, custom) (push) Blocked by required conditions
Details
Build C code / build-macos (Debug, lle) (push) Blocked by required conditions
Details
Build C code / build-macos (RelWithDebInfo, custom) (push) Blocked by required conditions
Details
Build C code / build-macos (RelWithDebInfo, lle) (push) Blocked by required conditions
Details
Build C code / build-windows (Debug, custom) (push) Blocked by required conditions
Details
Build C code / build-windows (Debug, lle) (push) Blocked by required conditions
Details
Build C code / build-windows (RelWithDebInfo, custom) (push) Blocked by required conditions
Details
Build C code / build-windows (RelWithDebInfo, lle) (push) Blocked by required conditions
Details
Build Saturn version / build-and-test-saturn (push) Waiting to run
Details
Build Saturn version / function-finder-saturn (push) Waiting to run
Details
Build PSX and PSP version / build-and-test (pspeu, hd) (push) Waiting to run
Details
Build PSX and PSP version / build-and-test (pspeu, pspeu) (push) Waiting to run
Details
Build PSX and PSP version / build-and-test (us, us) (push) Waiting to run
Details
Build PSX and PSP version / generate-progress-report (pspeu, hd) (push) Blocked by required conditions
Details
Build PSX and PSP version / generate-progress-report (pspeu, pspeu) (push) Blocked by required conditions
Details
Build PSX and PSP version / generate-progress-report (us, us) (push) Blocked by required conditions
Details
Build PSX and PSP version / generate-duplicates-report (us, us) (push) Blocked by required conditions
Details
Build PSX and PSP version / generate-duplicates-report-psp (pspeu, pspeu) (push) Blocked by required conditions
Details
Split no0 Diplocephalus / Plate Lord / Skelerang entities (#1891) 
Researched this via debugger

I think splitting these out in advance should hopefully make the
decompilation efforts more straightforward later wrt naming / working
out what code is doing
2024-11-10 21:48:37 +00:00
.github/workflows Remove PR bot (#1890) 2024-11-09 17:42:24 +00:00
.vscode Custom debugging module (#108) 2023-08-10 18:55:24 +01:00
bin Use allegrex assembler for PSP (#1424) 2024-07-22 15:36:28 -04:00
cmake Texture render support (#934) 2024-01-01 23:31:56 +00:00
config Split no0 Diplocephalus / Plate Lord / Skelerang entities (#1891) 2024-11-10 21:48:37 +00:00
disks Change how game assets are managed 2023-02-21 23:25:31 +00:00
docs Use built-in abs function (#1151) 2024-05-19 19:16:56 +01:00
include Decompile no0 func_us_801D8150 (#1888) 2024-11-10 10:50:08 +01:00
src Split no0 Diplocephalus / Plate Lord / Skelerang entities (#1891) 2024-11-10 21:48:37 +00:00
tools Remove PR bot (#1890) 2024-11-09 17:42:24 +00:00
.clang-format Update clang-format as self-contained binary (#1257) 2024-06-04 21:07:50 +01:00
.gitignore Asset cutscene two stages (#1738) 2024-10-06 13:10:06 +01:00
.gitmodules Update splat to 0.24.4 (#1112) 2024-06-12 18:50:32 +01:00
CMakeLists.txt NZ0 cohabitation (#1871) 2024-11-06 19:51:31 +00:00
CNAME Create CNAME 2022-10-18 23:52:54 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md (#721) 2023-10-31 20:34:50 +00:00
diff_settings.py MAR duplicates (#1618) 2024-09-16 18:19:29 +01:00
Dockerfile Add bsdmainutils to requirements (#1667) 2024-09-24 16:54:32 -07:00
go.work New asset manager (#1343) 2024-07-02 21:38:36 +01:00
go.work.sum Asset tool refactor (#1844) 2024-10-29 08:38:05 +00:00
LICENSE Add AGPL license (#1565) 2024-09-06 16:14:55 -04:00
Makefile Fix VERSION Warning When Generating Context (#1887) 2024-11-09 12:18:08 +00:00
Makefile.psp.mk Decompile PSP version of func_801024DC (#1886) 2024-11-08 20:11:45 +00:00
Makefile.psx.mk Decompile PSP DRA file 63C90.c (#1861) 2024-11-01 20:20:37 +00:00
Makefile.saturn.mk Rewrite Saturn make rules (#660) 2023-10-03 21:42:08 +01:00
README.md Adding tt_002 (Faerie) overlay (#1801) 2024-10-17 14:02:53 -07:00
weapon0.ld Import w_037 data and normalize weapon palette (#1777) 2024-10-11 18:36:59 +01:00
weapon1.ld Enhance Makefile for WEAPON0.BIN (#466) 2023-08-14 02:03:54 +01:00

README.md

Castlevania: Symphony of the Night Decompilation

A work-in-progress decompilation of Castlevania Symphony of the Night for Sony PlayStation 1, Sony PlayStation Portable and Sega Saturn. It aims to recreate the source code from the existing binaries using static and/or dynamic analysis. The code compiles byte-for-byte to the same binaries of the game, effectively being a matching decompilation.

It currently supports the following versions of the game:

  • us the reference build with the serial number SLUS-00067
  • hd an unreleased PS1 Japanese build found in Castlevania: Dracula X Chronicles game data
  • pspeu European build from Castlevania: Dracula X Chronicles
  • saturn the port created by an external development team

This repo does not include any assets or assembly code necessary for compiling the binaries. A prior copy of the game is required to extract the required assets.

Bins decomp progress

File name Code coverage Decomp functions Description
SLUS_000.67 code coverage SLUS_000.67 decompiled functions Shared libraries
DRA.BIN code coverage DRA.BIN decompiled functions Game engine
BIN/RIC.BIN code coverage RIC.BIN decompiled functions Playable Richter
BIN/WEAPON0.BIN code coverage WEAPON0.BIN decompiled functions Equippables
ST/CEN/CEN.BIN code coverage CEN.BIN decompiled functions Center
ST/DRE/DRE.BIN code coverage DRE.BIN decompiled functions Nightmare
ST/MAD/MAD.BIN code coverage MAD.BIN decompiled functions Debug Room
ST/NO0/NO0.BIN code coverage NO0.BIN decompiled functions Marble Gallery
ST/NO3/NO3.BIN code coverage NO3.BIN decompiled functions Entrance (first visit)
ST/NP3/NP3.BIN code coverage NP3.BIN decompiled functions Entrance
ST/NZ0/NZ0.BIN code coverage NZ0.BIN decompiled functions Alchemy Laboratory
ST/SEL/SEL.BIN code coverage SEL.BIN decompiled functions Title screen
ST/ST0/ST0.BIN code coverage ST0.BIN decompiled functions Final Stage: Bloodlines
ST/WRP/WRP.BIN code coverage WRP.BIN decompiled functions Warp Room
ST/RWRP/RWRP.BIN code coverage RWRP.BIN decompiled functions Warp Room (reverse)
BOSS/MAR/MAR.BIN code coverage MAR.BIN decompiled functions Maria cutscene
BOSS/RBO3/RBO3.BIN code coverage RBO3.BIN decompiled functions Medusa boss
SERVANT/TT_000.BIN code coverage TT_000.BIN decompiled functions Bat Familiar
SERVANT/TT_001.BIN code coverage TT_001.BIN decompiled functions Ghost Familiar
SERVANT/TT_002.BIN code coverage TT_002.BIN decompiled functions Faerie Familiar

Code coverage means how many bytes of code have been successfully converted from assembly into C code, while decomp function is how many functions have been successfully decompiled.

Useful links

Decompiling a game is a mastodontic task. If you have some basic programming skills, please join us in this journey. Any contribution will be very appreciated!

Join to our Discord server

Special thanks

This project is possible thanks to the hard work of tools provided by the Decompilation community:

  • mips2c from @matt-kempster to decompile MIPS assembly into C. This has proven to be more accurate than Hexrays IDA and Ghidra.
  • splat from @ethteck to disassemble code and extract data with a symbol map. This tool provides the fundamentals of the SOTN decomp.
  • asm-differ from @simonlindholm to know how the decompiled code compares to the original binary.
  • decomp-permuter from @simonlindholm to pick different versions of the same code that better matches the original binary.
  • maspsx by @mkst to replicate the customized assembler used in the official PSX SDK.
  • decomp.me by @ethteck, @nanaian and @mkst to provide a collaborative decompilation site to share and contribute to work-in-progress decompiled functions.
  • frogress by @ethteck to store and retrieve progression data.
  • esa-new by @mkst as an inspiration on how to set-up a PS1 decompilation project.
  • oot as an inspiration of what it is possible to achieve with a complete decompiled video game.