Custom Texture Support - MorsGames/sm64plus GitHub Wiki
SM64Plus allows you to replace the default in-game textures with your very own ones, and even install custom texture packs.
Using Custom Textures
You can install custom texture packs by copying the texture files to the %LOCALAPPDATA%\SM64Plus\gfx
folder and replacing the existing texture files there.
The folder layout and file names for the textures are mostly the same as what most other PC port forks use. The only difference is that unlike some ports SM64Plus makes use of segmented skybox textures. So if the texture pack you're using doesn't have segmented skybox textures, you won't be able to see any difference in how the skybox looks.
Disabling the Support
While having the option to use custom texture packs is nice, having the custom texture support enabled can introduce stutters on lower-end devices and can occasionally cause minor texture bugs.
The good news is that if you're having issues with it, you can disable it very easily.
-
With the Launcher
-
Without a Prior Build
When you get to the disclaimer screen on your first run press the backspace key. You will get a message that says that custom texture support is disabled. You can then continue the building process as normal.
-
With a Prior Build
On the main menu choose "Update" and "Pull, Clean & Rebuild" while holding the backspace key. This will essentially toggle the custom texture support on and off, so you can also use this method to enable custom texture support back.
-
-
With Manual Building
All you have to do is to pass CUSTOM_TEXTURES=0
as a parameter to the make
command. If you have a prior build make sure to use the make clean
command first!
Other
There is a rare issue that causes the textures to appear as black and purple squares. To fix that hold "left", "right", and "backspace" keys down for 5 seconds in the title screen of the launcher. That should automatically delete the %LOCALAPPDATA%\SM64Plus\gfx
folder and replace the contents of it with the default textures. You can also delete that folder manually, and the launcher will automatically create it again and copy the default textures in.
On non-Windows platforms, you can also try passing the path to the gfx
directory as the first argument to the executable; by default, it's generated at sm64plus/build/us_pc/gfx
.