Super Mario 64 OpenGL port for PC. Mirror of https://github.com/sm64pc/sm64pc https://github.com/sm64pc/sm64pc
 
 
 
 
 
 
Go to file
HengiFettlich 1cca3ef4ea add Hotkeys for Fullscreen (ALT+Enter) 2020-05-07 20:46:35 +02:00
actors Refresh 7 2020-03-01 22:42:52 -05:00
asm Refresh 8 2020-04-03 14:57:26 -04:00
assets Refresh 3 2019-11-03 14:36:27 -05:00
bin merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
data Refresh 8 2020-04-03 14:57:26 -04:00
doxygen init2 2019-08-25 00:46:40 -04:00
enhancements Refresh 8 2020-04-03 14:57:26 -04:00
include merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
levels merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
lib merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
sound merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
src add Hotkeys for Fullscreen (ALT+Enter) 2020-05-07 20:46:35 +02:00
text refresh 6 2020-02-03 00:51:26 -05:00
tools merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
.clang-format Refresh 1 2019-09-01 15:50:50 -04:00
.clang-tidy Refresh 1 2019-09-01 15:50:50 -04:00
.gitattributes Refresh 1 2019-09-01 15:50:50 -04:00
.gitignore update .gitignore 2020-05-07 20:46:35 +02:00
CHANGES Refresh 8 2020-04-03 14:57:26 -04:00
Dockerfile incorporate streetster's suggestions 2020-04-02 11:00:05 -07:00
Doxyfile refresh 4 2019-12-01 21:52:53 -05:00
Jenkinsfile refresh 6 2020-02-03 00:51:26 -05:00
Makefile merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
Makefile.split Refresh 7 2020-03-01 22:42:52 -05:00
README.md Merge pull request #36 from ahouts/master 2020-04-19 12:06:42 -07:00
asmdiff.jp.sh merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
asmdiff.us.sh init2 2019-08-25 00:46:40 -04:00
assets.json Refresh 8 2020-04-03 14:57:26 -04:00
charmap.txt refresh 5 2020-01-03 10:38:57 -05:00
charmap_menu.txt refresh 5 2020-01-03 10:38:57 -05:00
diff.py Refresh 8 2020-04-03 14:57:26 -04:00
diff_settings.py Refresh 8 2020-04-03 14:57:26 -04:00
extract_assets.py merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
first-diff.py Refresh 8 2020-04-03 14:57:26 -04:00
format.sh init2 2019-08-25 00:46:40 -04:00
readme2.txt merge PC port onto the decompile 2020-05-07 20:21:22 +02:00
rename_sym.sh Refresh 7 2020-03-01 22:42:52 -05:00
sm64.eu.sha1 init2 2019-08-25 00:46:40 -04:00
sm64.jp.sha1 init2 2019-08-25 00:46:40 -04:00
sm64.ld Refresh 8 2020-04-03 14:57:26 -04:00
sm64.sh.sha1 Refresh 7 2020-03-01 22:42:52 -05:00
sm64.us.sha1 init2 2019-08-25 00:46:40 -04:00
undefined_syms.txt Refresh 8 2020-04-03 14:57:26 -04:00

README.md

Super Mario 64

This repo contains a full decompilation of Super Mario 64 (J), (U), and (E). The source and data have been decompiled but complete naming and documentation all of the code and data is still a work in progress. Decompiling the Shindou ROM is also an ongoing effort.

It builds the following ROMs:

  • sm64.jp.z64 sha1: 8a20a5c83d6ceb0f0506cfc9fa20d8f438cafe51
  • sm64.us.z64 sha1: 9bef1128717f958171a4afac3ed78ee2bb4e86ce
  • sm64.eu.z64 sha1: 4ac5721683d0e0b6bbb561b58a71740845dceea9

This repo does not include all assets necessary for compiling the ROMs. A prior copy of the game is required to extract the required assets.

Installation

Docker

1. Copy baserom(s) for asset extraction

For each version (jp/us/eu) that you want to build a ROM for, put an existing ROM at ./baserom.<version>.z64 for asset extraction.

2. Create docker image

docker build -t sm64 .

3. Build

To build we simply have to mount our local filesystem into the docker container and build.

# for example if you have baserom.us.z64 in the project root
docker run --rm --mount type=bind,source="$(pwd)",destination=/sm64 sm64 make VERSION=us -j4

# if your host system is linux you need to tell docker what user should own the output files
docker run --rm --mount type=bind,source="$(pwd)",destination=/sm64 --user $UID:$UID sm64 make VERSION=us -j4

Resulting artifacts can be found in the build directory.

Linux

1. Copy baserom(s) for asset extraction

For each version (jp/us/eu) that you want to build a ROM for, put an existing ROM at ./baserom.<version>.z64 for asset extraction.

2. Install build dependencies

The build system has the following package requirements:

  • binutils-mips >= 2.27
  • python3 >= 3.6
  • libaudiofile
  • qemu-irix

Debian / Ubuntu

sudo apt install build-essential pkg-config git binutils-mips-linux-gnu python3 zlib1g-dev libaudiofile-dev

Download latest package from qemu-irix Releases

sudo dpkg -i qemu-irix-2.11.0-2169-g32ab296eef_amd64.deb

(Optional) Clone https://github.com/n64decomp/qemu-irix and follow the install instructions in the README.

Arch Linux

sudo pacman -S base-devel python audiofile

Install the following AUR packages:

3. Build ROM

Run make to build the ROM (defaults to VERSION=us). Make sure your path to the repo is not too long or else this process will error, as the emulated IDO compiler cannot handle paths longer than 255 characters. Examples:

make VERSION=jp -j4       # build (J) version instead with 4 jobs
make VERSION=eu COMPARE=0 # non-matching EU version still WIP

Windows

For Windows, install WSL and a distro of your choice following Windows Subsystem for Linux Installation Guide for Windows 10 We recommend either Debian or Ubuntu 18.04 Linux distributions under WSL.

Then follow the directions in the Linux installation section above.

macOS

macOS is currently unsupported as qemu-irix is unable to be built for macOS host. The recommended path is installing a Linux distribution under a VM.

Project Structure

sm64
├── actors: object behaviors, geo layout, and display lists
├── asm: handwritten assembly code, rom header
│   └── non_matchings: asm for non-matching sections
├── assets: animation and demo data
│   ├── anims: animation data
│   └── demos: demo data
├── bin: asm files for ordering display lists and textures
├── build: output directory
├── data: behavior scripts, misc. data
├── doxygen: documentation infrastructure
├── enhancements: example source modifications
├── include: header files
├── levels: level scripts, geo layout, and display lists
├── lib: SDK library code
├── sound: sequences, sound samples, and sound banks
├── src: C source code for game
│   ├── audio: audio code
│   ├── buffers: stacks, heaps, and task buffers
│   ├── engine: script processing engines and utils
│   ├── game: behaviors and rest of game source
│   ├── goddard: Mario intro screen
│   └── menu: title screen and file, act, and debug level selection menus
├── text: dialog, level names, act names
├── textures: skybox and generic texture data
└── tools: build tools

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Run clang-format on your code to ensure it meets the project's coding standards.

Official Discord: https://discord.gg/27JtCWs