About
Super Mario 64 is Nintendo's 1996 3D platform game for the Nintendo 64, in which Mario explores painting-based worlds to collect Power Stars and rescue Princess Peach from Bowser. This is a heavily modified fork of the community Super Mario 64 decompilation that retargets the game from the Nintendo 64 to the original PlayStation (with a PC build for debugging only), reworking the renderer around fixed-point math, a custom low-bit texture encoder, and polygon tessellation to fit PSX hardware. Only the US ROM version can currently be built, and the project is archived and described as unplayable due to unresolved crashes.
How it differs from the original
Beyond the platform switch, it adds genuine DualShock rumble support, driving both of the controller's motors to mimic the original Rumble Pak graphic, and replaces the original's translucent texture shadows with subtractive hexagonal shadows, since the PSX doesn't support arbitrary translucency.
Getting started
Building it requires supplying your own US Super Mario 64 ROM for asset extraction and a Linux-based toolchain, for which a ready-made Docker container is provided; running the build produces a bootable PlayStation disc image, though the project remains unfinished.
Known limitations
- feature: Some of Mario's animations do not play and may crash the game.
- feature: Music cannot be generated at build time without manually obtaining tracks.
- compatibility: Camera cannot be controlled in many levels due to unfinished camera control implementation.
- compatibility: Crashes when entering certain levels due to insufficient memory.
- feature: Ending sequence crashes on load.
- feature: Pause menu does not work.
- graphics: Textures are loaded individually, causing long stutters and loading times.
- graphics: Some textures are rendered incorrectly due to RSP JIT issues.
Additional notes
- Migration
- Development has since moved to a new repository on Codeberg; this GitHub repo is no longer the actively updated version.