mirror of
https://github.com/MorsGames/sm64plus.git
synced 2025-01-22 15:42:58 -05:00
A fork of sm64-port that focuses on QoL improvements and customizability.
actors | ||
asm | ||
assets | ||
bin | ||
data | ||
doxygen | ||
enhancements | ||
include | ||
levels | ||
lib | ||
rsp | ||
sound | ||
src | ||
text | ||
tools | ||
.clang-format | ||
.clang-tidy | ||
.gitattributes | ||
.gitignore | ||
assets.json | ||
CHANGES | ||
charmap.txt | ||
charmap_menu.txt | ||
diff.py | ||
diff_settings.py | ||
Dockerfile | ||
Doxyfile | ||
extract_assets.py | ||
first-diff.py | ||
format.sh | ||
Jenkinsfile | ||
Makefile | ||
Makefile.split | ||
README.md | ||
rename_sym.sh | ||
sm64.eu.sha1 | ||
sm64.jp.sha1 | ||
sm64.ld | ||
sm64.sh.sha1 | ||
sm64.us.sha1 | ||
undefined_syms.txt |
Super Mario 64 Port Thingy
Stuff from my earlier Super Mario 64 ABE ported to the PC port with a ton of new features. This README file is going to be replaced eventually with something more proper.
This repo does not include all assets necessary for compiling the game. A prior copy of the game is required to extract the assets.
Building native executables
Windows
- Install and update MSYS2, following the directions listed on https://www.msys2.org/.
- Launch MSYS2 MinGW and install required packages depending on your machine (do NOT launch "MSYS2 MSYS"):
- 64-bit: Launch "MSYS2 MinGW 64-bit" and install:
pacman -S git make python3 mingw-w64-x86_64-gcc mingw-w64-x86_64-SDL2 mingw-w64-x86_64-glew
- 32-bit (will also work on 64-bit machines): Launch "MSYS2 MinGW 32-bit" and install:
pacman -S git make python3 mingw-w64-i686-gcc mingw-w64-i686-SDL2 mingw-w64-i686-glew
- Do NOT install
gcc
.
- Clone the repo with
git clone https://github.com/MorsGames/sm64-port.git
, then enter it withcd sm64-port
. - Place a Super Mario 64 ROM called
baserom.us.z64
into the project folder for asset extraction. - Run
make
to build. You can add-j4
to improve build speed (hardware dependent based on the amount of CPU cores available). - The executable binary will be located at
build/us_pc/sm64.us.f3dex2e.exe
.
Linux
- Install prerequisites (Ubuntu) with
sudo apt install -y git build-essential pkg-config libusb-1.0-0-dev libsdl2-dev
. - Clone the repo with
git clone https://github.com/MorsGames/sm64-port.git
. - Place a Super Mario 64 ROM called
baserom.us.z64
into the project folder for asset extraction. - Run
make
to build. You can add-j4
to improve build speed (hardware dependent based on the amount of CPU cores available). - The executable binary will be located at
build/us_pc/sm64.<VERSION>.f3dex2e
.
Additional options
- You can apply the 60FPS patch by using
tools/apply_patch.sh "enhancements/60fps.patch"
. If you get an error, try usingpacman -S patch
first. - You can target OpenGL by using
make ENABLE_OPENGL=1
. CURRENTLY NONFUNCTIONAL! Help is needed to fix this!