Cannot build on three different Linux distros

[SM64User]

I used the 'Manual Building Guide' yesterday (March 12th) and, in short, it does not finish building on Linux (on Windows it builds the Windows version like usual, but has the issue described on issue #130 ). I tried three different Linux distros (in a QEMU/KVM VM (Virtual Machine)) and all failed to build with the same basic error, which is...

make: *** [Makefile:868: build/us_pc/src/pc/gfx/gfx_opengl.o] Error 1

the three distros I tried are... LMDE7 (Debian 13), Kubuntu 25.10, Manjaro (Arch based (manjaro-xfce-26.0.2-260206-linux618.iso)). for more details (which I copied from terminal text (from my attempt on Kubuntu 25.10 but it's all basically the same across all three)) see terminal text below...

~~~~
Compiling: src/pc/gfx/gfx_opengl.c -> build/us_pc/src/pc/gfx/gfx_opengl.o
src/pc/gfx/gfx_opengl.c: In function ‘create_framebuffer’:
src/pc/gfx/gfx_opengl.c:150:9: error: implicit declaration of function ‘glTexImage2DMultisample’; did you mean ‘glTexStorage3DMultisampleOES’? [-Wimplicit-function-declaration]
  150 |         glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, configAntiAliasing, GL_RGBA8, width, height, GL_TRUE);
      |         ^~~~~~~~~~~~~~~~~~~~~~~
      |         glTexStorage3DMultisampleOES
src/pc/gfx/gfx_opengl.c:150:80: error: ‘GL_RGBA8’ undeclared (first use in this function); did you mean ‘GL_RGBA’?
  150 |         glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, configAntiAliasing, GL_RGBA8, width, height, GL_TRUE);
      |                                                                                ^~~~~~~~
      |                                                                                GL_RGBA
src/pc/gfx/gfx_opengl.c:150:80: note: each undeclared identifier is reported only once for each function it appears in
src/pc/gfx/gfx_opengl.c:165:13: error: implicit declaration of function ‘glRenderbufferStorageMultisample’; did you mean ‘glRenderbufferStorageMultisampleNV’? [-Wimplicit-function-declaration]
  165 |             glRenderbufferStorageMultisample(GL_RENDERBUFFER, configAntiAliasing, GL_DEPTH_COMPONENT24, width, height);
      |             ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      |             glRenderbufferStorageMultisampleNV
src/pc/gfx/gfx_opengl.c:165:83: error: ‘GL_DEPTH_COMPONENT24’ undeclared (first use in this function); did you mean ‘GL_DEPTH_COMPONENT16’?
  165 |             glRenderbufferStorageMultisample(GL_RENDERBUFFER, configAntiAliasing, GL_DEPTH_COMPONENT24, width, height);
      |                                                                                   ^~~~~~~~~~~~~~~~~~~~
      |                                                                                   GL_DEPTH_COMPONENT16
src/pc/gfx/gfx_opengl.c: In function ‘blit_internal_framebuffer’:
src/pc/gfx/gfx_opengl.c:353:27: error: ‘GL_READ_FRAMEBUFFER’ undeclared (first use in this function); did you mean ‘GL_READ_FRAMEBUFFER_NV’?
  353 |         glBindFramebuffer(GL_READ_FRAMEBUFFER, internal_framebuffer);
      |                           ^~~~~~~~~~~~~~~~~~~
      |                           GL_READ_FRAMEBUFFER_NV
src/pc/gfx/gfx_opengl.c:354:27: error: ‘GL_DRAW_FRAMEBUFFER’ undeclared (first use in this function); did you mean ‘GL_DRAW_FRAMEBUFFER_NV’?
  354 |         glBindFramebuffer(GL_DRAW_FRAMEBUFFER, resolved_framebuffer);
      |                           ^~~~~~~~~~~~~~~~~~~
      |                           GL_DRAW_FRAMEBUFFER_NV
src/pc/gfx/gfx_opengl.c:355:9: error: implicit declaration of function ‘glBlitFramebuffer’; did you mean ‘glBlitFramebufferNV’? [-Wimplicit-function-declaration]
  355 |         glBlitFramebuffer(0, 0, internal_width, internal_height, 0, 0, internal_width, internal_height, GL_COLOR_BUFFER_BIT, GL_NEAREST);
      |         ^~~~~~~~~~~~~~~~~
      |         glBlitFramebufferNV
src/pc/gfx/gfx_opengl.c: In function ‘gfx_opengl_init’:
src/pc/gfx/gfx_opengl.c:953:18: error: ‘GL_MULTISAMPLE’ undeclared (first use in this function); did you mean ‘GL_MULTISAMPLES_NV’?
  953 |         glEnable(GL_MULTISAMPLE);
      |                  ^~~~~~~~~~~~~~
      |                  GL_MULTISAMPLES_NV
src/pc/gfx/gfx_opengl.c: In function ‘gfx_opengl_end_frame’:
src/pc/gfx/gfx_opengl.c:1035:31: error: ‘GL_READ_FRAMEBUFFER’ undeclared (first use in this function); did you mean ‘GL_READ_FRAMEBUFFER_NV’?
 1035 |             glBindFramebuffer(GL_READ_FRAMEBUFFER, internal_framebuffer);
      |                               ^~~~~~~~~~~~~~~~~~~
      |                               GL_READ_FRAMEBUFFER_NV
src/pc/gfx/gfx_opengl.c:1036:31: error: ‘GL_DRAW_FRAMEBUFFER’ undeclared (first use in this function); did you mean ‘GL_DRAW_FRAMEBUFFER_NV’?
 1036 |             glBindFramebuffer(GL_DRAW_FRAMEBUFFER, resolved_framebuffer);
      |                               ^~~~~~~~~~~~~~~~~~~
      |                               GL_DRAW_FRAMEBUFFER_NV
make: *** [Makefile:868: build/us_pc/src/pc/gfx/gfx_opengl.o] Error 1

p.s. I can get it to build on Linux if I do 'git checkout 7231d27' before I run the 'make' command as then it's using a game version (July 2025) before all of the major changes from Jan 2026 to date as recently is when there are bigger issues (building on Linux don't work and issue 130). I am actually playing the game on Mint 22.3-Xfce (Ubuntu 24.04 LTS based) but I built it on other distro's in a VM (even when I tried building the July 2025 working version on Manjaro, it complained about missing dependencies (when I copied it out of the VM to run on my main Mint 22.3-Xfce distro), but I just switched over to LMDE7 and built it there and no more problem).

for the record (just a general compliment to MorsGames to keep up the good work)... I consider this MorsGames version to be the best version of this game available as even the recent 'Ghostship', while solid overall, does not have the improved camera movement (and has some visual glitches of it's own (to state a obvious one, Mario's shadow flickers a lot where as your MorsGames works great)) yours does which makes yours superior as Ghostship's is still using it like the original games is as the right analog stick acts like the N64's yellow C buttons where you got to always move stick left or right back to center area, so it's essentially acting like the N64's setup (with tapping buttons) where as yours, which is improved, I can just press and hold left or right to spin the camera which is superior with modern control setups. so your control setup is basically perfect.

[okey]

This appears to be because newer changes don't import OpenGL extensions on linux. Try my changes from #134

[SM64User]

This appears to be because newer changes don't import OpenGL extensions on linux. Try my changes from #134

In short, that appears to work. I only tested it on my Mint 22.3-Xfce (Ubuntu 24.04 LTS). but if it works here it very likely will work in the VM's (on LMDE7/Kubuntu/Manjaro) since they all got that same basic error before using your fix here.

I am confident your stuff is working because when starting the game on my Linux PC with this fixed built Linux version I have the known bug (issue number 130) where if anti-aliasing is enabled, which it is by default, it has that graphics glitch (see issue number 130 as there is a video of it and it's obvious glitching in the background). but I fixed that by setting the Linux versions 'settings.ini' (i.e. located at "~/.config/SM64Plus/") on the "anti_aliasing = "8"" (games default setting on this new stuff) back to "anti_aliasing = "0"" and that fixes that issue (as using even '1' the issue returns). additionally, I can even tell the 'settings.ini' is different as there used to be different stuff on my previous one that's no longer there (like on my 'Display' section etc). because basically before that I was using Dec 2025 or July 2025 (or older) stuff I never had to mess with that anti-aliasing stuff for the game to work normally.

so thanks a lot ;)

p.s. it took me a while to get stuff going as I am very new to this 'building' stuff. so I used the 'Manual Building Guide' but manually copied over your changes (additions and subtractions) to that file (gfx_opengl.c) and replaced the one 'Step 3' automatically imports. but when trying to do "git cherry-pick 37af8d3 c2ddcf1 aefd569" (imports some changes from 'sonicer105' from Dec 2025 as that '37af8d3' in particular seems to be required otherwise it will fail to build on Ubuntu based distro's as I likely could compile without that on LMDE7(Debian 13 based)) it was complaining about overwriting or disregarding the manual tweaked 'gfx_opengl.c' file etc (or something like that), which I assume is a issue since I need your changes. but using some chat AI stuff I just winged it from the info it gave me and did 'git stash', then did the importing of those cherry-picked commits, then did 'git stash pop' and then ran the usual 'make' command and no more errors during building on my Ubuntu 24.04 LTS based distro (Mint 22.3-Xfce). or another way to put it... if I was building with LMDE7, I could have just manually swapped the 'gfx_opengl.c' file (from src/pc/gfx/ (before building the ready to use game)) after doing 'Step 3' and all would be good. but once MorsGames imports all of this stuff (i.e. sonicer105's Ubuntu fix and your stuff etc to the main 'master' branch), then we won't have to, as they say, 'jump through hoops' to get it going ;)

if there is anything I did out of the ordinary in the 'git' stuff in my "p.s" section above feel free to correct me.

on a side note... I was using my usual HD textures (currently using the ones for 'sm64ex' (from GhostlyDark) which are '.png' files) and I thought all was good on a quick test but I noticed when I spun the camera around at the very start in the background you could tell there was a big missing texture in the background behind you when you are at very start. but I ended up fixing that by doing what I previously did (which I did not think we had to on current stuff but apparently that's not the case) in that in the ready-to-use build directory I renamed 'gfx' to 'gfx_orig' and then copied in the new 'gfx' folder (the HD ones from GhostlyDark) and if you start the game at this point it will have the missing texture behind you (like when you initially run up hill at start and then spin camera (with right analog stick) so you can see back towards where you started from in background it's blatantly obvious as it's a big dark missing section). but what I did to fix was go back to where the game runs from and copy the contents of 'gfx_orig' (official/original textures) to 'gfx' (where HD textures are) but DO NOT overwrite when it asks, then start the game and all is good. no more missing texture in background and it seems okay to with proper HD as you can tell visually it looks HD as to further test that I was still getting HD textures (on the background in particular) I then exited the game, went back to the 'us_pc' folder (i.e. the ready-to-use game) and renamed 'gfx' to 'gfx_HD' and 'gfx_orig' to 'gfx', so essentially it's back to games official/default textures and then started the game, and sure enough, you can tell background is all blurry as expected with the default textures. so then I just renamed it back to what I usually do so I get HD textures and all is good (I am assuming that is okay as I pretty much got all 120 stars earlier last year using that 'gfx' 'gfx_orig' stuff and had no obvious issues with the game as hud/text is sharp and texture quality is better).

[okey]

if there is anything I did out of the ordinary in the 'git' stuff in my "p.s" section above feel free to correct me.

What you did is fine but a little clunky. Using git stash was a much better choice than manually copying files around.

I would have checked out an new branch doing anything else (e.g. git checkout -b build/sm64user), then cherry-picked the changes you want from dev, then fetched my changes (git fetch origin pull/134/head:pr134) into another new branch (pr134), then cherry-picked 2d1041c as well.

I was using my usual HD textures...

That sounds like your HD texture pack is missing a texture.

[SM64User]

I was using my usual HD textures...

That sounds like your HD texture pack is missing a texture.

EDIT (March 18th 2026): Yeah, but I was doing a bit of digging with HD textures on the game compared to MorsGames default SD textures and here is basically what I did, which is probably as good as it's going to get (which I think while there is technically some negative it's probably next to nothing overall)...

The official default textures on MorsGames total this... '2076 items (1905 files, 171 folders)' based on properties of 'gfx' folder. doing a check on the other two HD textures packs I used have excess files/folders which the MorsGames would not use. so I created a Linux '.sh' script (using AI) that scans the official/default MorsGames 'gfx' textures folder and then scans the HD 'gfx' folder and only copies the files from the HD 'gfx' folder that are listed in the default 'gfx' folder to a fresh location which gives me '1829 files, 169 folders' (from the HD textures). then at that point I just manually copied the contents of the official 'gfx' texture folder to the new HD 'gfx' texture folder but DO NOT overwrite when it asks. after doing this the total file folder count mirrors the official one (i.e. 1905 files and 171 folders). so apparently there is 76 files missing on the HD 'gfx' folder (and two folders), but I suspect it won't have much effect on the game visually in a negative way since I suspect everything that matters is in HD.

I figure that's a bit more proper since the HD texture packs include many excess textures that this MorsGames version of the game would not use.

NOTE: I setup the HD textures folder like the following (before running the Linux script I mentioned above). I used this as the primary source of textures (since it's a bit smaller in size vs the 'public archive' v2.5.1 and I doubt has any noticeable visual differences)...

1)https://github.com/GhostlyDark/SM64-Reloaded/releases/download/v2.6.0/sm64-reloaded-v2.6.0-sm64ex-hd.zip ; extract this 'gfx' folder.

2)https://github.com/GhostlyDark/SM64-Reloaded-PC/releases/download/v2.5.1/sm64-reloaded-v2.5.1-pc-hd.zip ; extract this 'gfx' folder to the 'gfx' folder in 'Step 1' but DO NOT overwrite.

3)Lastly, assuming a person does not want to run the Linux '.sh' file I made (from AI) you would just copy the official 'gfx' textures to your 'HD' location but DO NOT overwrite. that's it, it will work. but without doing the '.sh' thing I did, while it will be okay (like as far as the game is concerned it will function the same as what I did), will have plenty of excess textures the game does not even use.

but basically ONLY the HD textures (between both combined as mentioned above) are missing 76 texture files (and two folders) (i.e. 1829 files vs official textures 1905). so copying the rest from the official 'gfx' folder makes up the rest.

if someone wants the script I used which copies only the files the game needs (from HD folder to a fresh location etc), you can use this...

#!/bin/bash

# Get the directory where the script is located
SCRIPT_DIR=$(dirname "$0")

# Define the directories relative to the script location
SOURCE_FOLDER_1="$SCRIPT_DIR/gfx_orig"
SOURCE_FOLDER_2="$SCRIPT_DIR/gfx"
DESTINATION_FOLDER="$SCRIPT_DIR/gfx_HDcorrected"

# Create the destination folder if it does not exist
mkdir -p "$DESTINATION_FOLDER"

# Loop through each file in the first source folder recursively
find "$SOURCE_FOLDER_1" -type f | while read -r file; do
    # Get the relative path from the source folder
    relative_path="${file#$SOURCE_FOLDER_1/}"
    # Construct the corresponding file path in the second source folder
    second_folder_file="$SOURCE_FOLDER_2/$relative_path"
    
    # Check if the file exists in the second source folder
    if [ -e "$second_folder_file" ]; then
        # Copy the file to the destination folder while keeping the structure
        mkdir -p "$DESTINATION_FOLDER/$(dirname "$relative_path")"
        cp "$second_folder_file" "$DESTINATION_FOLDER/$relative_path"
    fi
done

to use this you basically put the '.sh' file you make from that into it's own folder and then copy over the 'gfx' from the ORIGINAL MorsGames textures and rename it to 'gfx_orig' and then after setting up the 'HD' textures (like I mentioned above in the NOTE section in Step's 1 and 2) you have that named 'gfx' and put it into the same temp folder as your script (so in it's own temp folder you will have 'gfx_orig' folder, 'gfx' folder (which is the HD stuff) and the '.sh' file). then at that point when you run the script from that temp folder it will ONLY copy the files the game uses into a new folder at that same location called 'gfx_HDcorrected'. then at that point afterwards, you can then manually copy the CONTENTS of the 'gfx_orig' folder to that 'gfx_HDcorrected' folder but DO NOT overwrite. after that finishes you should have exactly "2076 items (1905 files, 171 folders)" (which is all HD stuff lacking 76 files which you took from default textures). then at that point you simply go to the game directory where the game runs from and rename it's original 'gfx' folder to 'gfx_orig' (if you want to keep it, if not you can delete it) and then copy in that 'gfx_HDcorrected' folder there and rename it to 'gfx'. that's it, the game should work with HD textures now without having a excess amount of unnecessary textures the game won't use. but if you don't care about the excess amount of textures you can just do t he basic Step 1 and Step 2 stuff along with copying in the original 'gfx' contents to it as the end result will be the same to the game (you will just have many excess textures the game does not use is all).

anyways, thanks again for your time.

p.s. but thanks for the info on 'git'. although to be honest, it sounds fairly complicated to me as like I said I am 'very' new to this (but I guess we all got to start somewhere ;) ). so even what I was doing was something I was recently messing around with for the first time. but I may play around with this git stuff soon and see what I can figure out as I suspect your method will be more time efficient from the looks of things (so probably a good idea I learn it).

[Clara81221]

Easiest fix is "git checkout 7231d27," solved the issue for me. This needs to be addressed.

[okey]

Easiest fix is "git checkout 7231d27," solved the issue for me. This needs to be addressed.

As noted by SM64User, that works but only helps if you don't care about any of the changes on master since then

[Clara81221]

Naturally, like I said it needs to be addressed, it does work if youre just trying to get it built

[Majoraslayer]

Just chiming in to confirm this is still an issue on Linux Mint 22.3 and Debian 13.