Help FAQ - Render96/Render96ex GitHub Wiki
==========================================
SM64 COMPILING DOCUMENTATION
==========================================
Written by: YeyoKermit Last revision: 24/01/21
** If it's the first time you compile SM64, refer to https://github.com/Render96/Render96ex/wiki for compiling instructions **
Make sure to check the compatibility list of any of the mods you are installing at the PC port forum http://sm64pc.info/ or at SM64 PC Port central https://discord.gg/cD7cn6enM8.
|| Warning = Purple || || Red = Error ||
Warnings are just notifications of messy code, do not confuse them with errors, they won't cause the compiling to fail. Errors do cause the compiling to fail.
==========================================
64 and 32 BITS COMPUTERS COMPILING ERRORS
| Error | What causes it | Builder Solution | Manual Solution |
|---|---|---|---|
| Segmentation fault: | Custom AIFF file missing data | Compile without clicking at "Clear us_pc Build". | Compile again without deleting the build folder. |
| make cc, no such file or directory: | GCC files are missing/ not installed. | Click "Reinstall dependencies". | Type "pacman -S mingw-w64-x86_64-gcc" in the MSYS2 console. |
| error, target not found: | MSYS package link was misspelled. | Won't happen with the builder | Refer to the following website in order to get the correct name/link for the desired package, https://packages.msys2.org/updates. |
| fatal error, no such file or directory | Missing a file either being a model, script, texture, etc. | Click clear repo. | Git clone a new repo. |
| make *** no targets specified and no makefile found. Stop | It's missing files or you didn't set the repo directory correctly in the MSYS2 console. | Click clear repo. | Make sure you used "cd" to set the repo location. Git clone a new repo if the error persists. |
| cc.exe error: mingw64/include/sdl2, no such file or directory | Missing SDL2 package. | Click Reinstall Dependencies. | Type "pacman -S mingw-w64-x86_64-SDL2" in the MSYS2 console. |
| error: redefinition of " " | Tried to apply the same patch twice to the repo. | Builder handles redefinition of all patches. | Run git reset --hard --quiet; git clean -f -d -x --quiet -e "build/us_pc/dynos/packs" -e "build/us_pc/res/*.zip" -e "build/us_pc/*.sav" -e "build/us_pc/*.bin" -e "build/jp_pc" -e "build/eu_pc" |
| out of memory allocating x bytes | RAM usage exceeded your computer's capability. | Compile again using lower building speed. | Reduce the cores being used when using "make". |
| Failed to create symbolic link | Unknown, perhaps sometimes disabled SymLinkEvaluation | Click the version label and click anywhere next to "That's Awesome!!!" to generate a Debug log and post it in a help channel. Take you builder exe, assets, mods, and repos folder out of your folder that has Unicode characters and/or spaces in its path | — |
| baserom.us.z64 has the wrong hash! | Your ROM is a byteswapped ROM, not a .z64, or it is a ROM hack or extended ROM. | Builder2 should convert your ROM to the proper format. | Convert it to .z64 using the following tool: https://hack64.net/tools/swapper.php. |
| x86_64-w64-mingw32/bin/ld.exe: collect2.exe: error: ld returned 1 exit status: | Your MSYS is most likely very outdated. | Try reinstalling dependencies. If the error persists, reinstall MSYS. | Update binutils typing the following command in the MSYS console, "pacman -S mingw-w64-x86_64-binutils". |
| After compiling successfully, "Assertion failed": | If a condition supposed to hold true does not hold true, the assertion fails. | Delete sm64config.txt located at appdata/roaming/"repo name" and reopen the game. | Same Solution |
| waiting for unfinished jobs... | RAM usage exceeded your computer's capability. | Lower your building speed. | Reduce the number of cores used by the computer if manual compiling is being used. |
| error: mingw32: key "4A6129F4E4B84AE46ED7F635628F528CF3053E04" | Database is corruped. | Reinstall MSYS2 completely. | Same Solution |
| unhandled exception has occurred in your application: | The application code didn't handle exceptions properly. | Install the newest microsoft.net framework found at: https://www.microsoft.com/en-us/download/details.aspx?id=42643. | Same Solution |
| error: failed to init transaction (unable to lock database) | Pacman file already exists | Builder2 has a workaround (removes db.lck) | Remove /var/lib/pacman/db.lck |
If you get any other error not written here, ask for help at the port servers and/or Render96 server
==========================================
32 BITS COMPUTERS COMPILING ERRORS
==========================================
| Error | What causes it | Builder Solution | Manual Solution |
|---|---|---|---|
| 2 [main] python3 5972 child_info_fork::abort: address space needed by '_hashlib.cpython-38-i386-msys.dll' (0x260000) is already occupied: | .dll malfunction exclusively of 32 bits computers | Builder2 has a workaround (runs the two commands in the next column) so this shouldn't happen. If it does anyway, try reinstalling MSYS2. | Run peflags -d1 /usr/lib/python3.8/lib-dynload/_hashlib.cpython-38-i386-msys.dll; rebase /usr/lib/python3.8/lib-dynload/_hashlib.cpython-38-i386-msys.dll |
==========================================
Controller Layout
==========================================
| In Game Value | PS4 | XBOX | Switch Pro |
|---|---|---|---|
| 1000 | Cross | A | B |
| 1001 | Circle | B | A |
| 1002 | Square | X | Y |
| 1003 | Triangle | Y | X |
| 1004 | Select | Select | Select |
| 1006 | Start | Start | Start |
| 1007 | L3 | L3 | L3 |
| 1008 | R3 | R3 | R3 |
| 1009 | L1 | L1 | L1 |
| 100A | R1 | R1 | R1 |
| 100B | Dpad Up | Dpad Up | Dpad Up |
| 100C | Dpad Down | Dpad Down | Dpad Down |
| 100D | Dpad Left | Dpad Left | Dpad Left |
| 100E | Dpad Right | Dpad Right | Dpad Right |
| 101A | L2 | L2 | L2 |
| 101B | R2 | R2 | R2 |
==========================================
Keyboard Layout
==========================================
| In Game Value | Keyboard Key | N64 Button |
|---|---|---|
| (0026) | L | A |
| (0033) | , | B |
| (0039) | SPACE BAR | START BUTTON |
| (0036) | RIGHT SHIFT | R BUTTON |
| (002A) | LEFT SHIFT | L BUTTON |
| (0025) | K | Z BUTTON |
| (0148) | UP ARROW | C UP |
| (0150) | DOWN ARROW | C DOWN |
| (014B) | LEFT ARROW | C LEFT |
| (014D) | RIGHT ARROW | C RIGHT |
| (0011) | W | STICK UP |
| (001F) | S | STICK DOWN |
| (001E) | A | STICK LEFT |
| (0020) | D | STICK RIGHT |
==========================================
BUILD FLAGS
==========================================
Most common build flag:
TEXTURE_FIX=1
(For a complete list of every available build flag, refer to build flags)
==========================================
REPOS LIST
==========================================
In order to get one of these repos, use "git clone". Do not download the .zip from the github, it messes things up. Additionally, you can add a shallow clone to make the cloning way faster/less resource expensive. To add a shallow clone, type "--depth (the number of commits you want to go back, 1 is the newest one) after "git clone".
| Github link | Description | Refresh |
|---|---|---|
| https://github.com/n64decomp/sm64 | ** A full decompilation of Super Mario 64 (J), (U), (E), and (SH). Builds a matching ROM, not an .exe ** | Refresh 15 |
| https://github.com/s4Ys369/CHEATERex | ** Fork of sm64pc/sm64ex with additional patches built-in. ** | Refresh 11 |
| https://github.com/sm64-port/sm64-port | ** Builds native SM64 executables ** | Refresh 14 |
| https://github.com/sm64pc/sm64ex | ** Fork of sm64-port/sm64-port with additional features. ** | Refresh 11 |
| https://github.com/djoslin0/sm64ex-coop | ** A mod for the PC port where two people can play online together. ** | Refresh 12 |
| https://github.com/AloXado320/sm64ex-alo | ** sm64ex updated to the latest Refresh with quality of life fixes and additional features such as PuppyCam 2, Kaze's MOP, console compatibility, and more. ** | Refresh 15 |
| https://github.com/Render96/Render96ex | ** A fork of sm64ex with additional features meant for the Render96 Project ** | Refresh 11 |