Super Mario 64 OpenGL port for PC. Mirror of https://github.com/sm64pc/sm64pc https://github.com/sm64pc/sm64pc
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
vanfanel fd02d88b59 Fix for GLES on windowed rendering contexts (X11) 3 years ago
.github/ISSUE_TEMPLATE Update issue templates 3 years ago
actors Refresh 7 3 years ago
asm Refresh 8 3 years ago
assets Refresh 3 3 years ago
bin merge PC port onto the decompile 3 years ago
data Refresh 8 3 years ago
doxygen init2 3 years ago
enhancements Delete fps.patch 3 years ago
include merge PC port onto the decompile 3 years ago
levels Update script.c 3 years ago
lib merge PC port onto the decompile 3 years ago
sound merge PC port onto the decompile 3 years ago
src Fix for GLES on windowed rendering contexts (X11) 3 years ago
text refresh 6 3 years ago
tools merge PC port onto the decompile 3 years ago
.clang-format Refresh 1 3 years ago
.clang-tidy Refresh 1 3 years ago
.gitattributes Refresh 1 3 years ago
.gitignore Update .gitignore to remove patch/wiggle residue 3 years ago
CHANGES Refresh 8 3 years ago
Dockerfile Add libSDL and emsdk to support building linux and web in container 3 years ago
Doxyfile refresh 4 3 years ago
Jenkinsfile refresh 6 3 years ago
Makefile Port fixes from fdsfgsfds' fork 3 years ago
Makefile.split Refresh 7 3 years ago
README.md Nothing to see here 3 years ago
asmdiff.jp.sh merge PC port onto the decompile 3 years ago
asmdiff.us.sh init2 3 years ago
assets.json Refresh 8 3 years ago
charmap.txt refresh 5 3 years ago
charmap_menu.txt refresh 5 3 years ago
diff.py Refresh 8 3 years ago
diff_settings.py Refresh 8 3 years ago
extract_assets.py merge PC port onto the decompile 3 years ago
first-diff.py Refresh 8 3 years ago
format.sh init2 3 years ago
rename_sym.sh Refresh 7 3 years ago
sm64.eu.sha1 init2 3 years ago
sm64.jp.sha1 init2 3 years ago
sm64.ld Refresh 8 3 years ago
sm64.sh.sha1 Refresh 7 3 years ago
sm64.us.sha1 init2 3 years ago
undefined_syms.txt Refresh 8 3 years ago

README.md

sm64pc

OpenGL adaptation of n64decomp/sm64.

Feel free to report bugs and contribute, but remember, there must be no upload of any copyrighted asset. Run ./extract-assets.py --clean && make clean or make distclean to remove ROM-originated content.

Features

  • Native rendering. You can now play SM64 without the need of an emulator.
  • Variable aspect ratio and resolution. The game can now correctly render at basically any window size.
  • Native xinput controller support. On Linux, DualShock 4 has been confirmed to work plug-and-play.
  • True analog camera control is now available on our testing branch.

Building

On Linux

1. Copy baserom(s) for asset extraction

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

2. Install build dependencies

The build system has the following package requirements:

  • python3 >= 3.6
  • libsdl2-dev
  • audiofile
  • libglew-dev
  • git

Debian / Ubuntu - targeting 32 bits

sudo apt install build-essential git python3 libaudiofile-dev libglew-dev:i386 libsdl2-dev:i386

Debian / Ubuntu - targeting 64 bits

sudo apt install build-essential git python3 libaudiofile-dev libglew-dev libsdl2-dev

Arch Linux

sudo pacman -S base-devel python audiofile sdl2 glew

Void Linux - targeting 64 bits

sudo xbps-install -S base-devel python3 audiofile-devel SDL2-devel glew-devel

Void Linux - targeting 32 bits

sudo xbps-install -S base-devel python3 audiofile-devel-32bit SDL2-devel-32bit glew-devel-32bit

3. Build the executable.

Run make to build (defaults to VERSION=us)

make VERSION=jp -j6                 # build (J) version with 6 jobs
make VERSION=us WINDOWS_BUILD=1     # builds a (U) Windows executable 
make TARGET_RPI=1                   # targets an executable for a Raspberry Pi

On Windows

1. Set up MSYS2, following this guide.

2. Install dependencies

pacman -S mingw-w64-i686-glew mingw-w64-x86_64-glew mingw-w64-i686-SDL2 mingw-w64-x86_64-SDL2 python3

3. Copy baserom(s) for asset extraction

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

4. On MSYS2, navigate to the sm64pc folder and then enter ./tools/audiofile-0.3.6/. Inside this directory, run

autoreconf -i

Only leave this directory on step 9.

5. Run the configure script

PATH=/mingw64/bin:/mingw32/bin:$PATH LIBS=-lstdc++ ./configure --disable-docs

6. Run the make script

PATH=/mingw64/bin:/mingw32/bin:$PATH make

7. Create a lib directory in tools/

mkdir ../lib

8. Copy the compiled libaudiofile to tools/lib/

cp libaudiofile/.libs/libaudiofile.a ../lib/
cp libaudiofile/.libs/libaudiofile.la ../lib/

9. Navigate back to tools/, then alter the Makefile and add -lstdc++ on the following line

tabledesign_CFLAGS := -Wno-uninitialized -laudiofile -lstdc++

10. Run make

PATH=/mingw64/bin:/mingw32/bin:$PATH make

11. Navigate back to the sm64pc root directory.

12. Finally, run make once more.

(Note that mingw32 and mingw64 have been swapped. This is so you can build the 32bit application successfully.)

PATH=/mingw32/bin:/mingw64/bin:$PATH make

For the web

The game can be compiled for web browsers that support WebGL using Emscripten. To do so, install emsdk and run make TARGET_WEB=1.

Optional enhancements

On the ./enhancements folder, you'll find several .patch files, which can be applied in the following manner:

 git apply fps.patch --ignore-whitespace --reject

If any rejections occur, you can search for them with find | grep .rej. Try to solve rejections through wiggle.

wiggle rejection.rej --replace

Current issues

  • Support for the EU version is still experimental.
  • There seems to be savedata-related problems on some 64-bits builds.
  • Camera controls are also bugged for some.