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.