Skip to main content

Setting up NSMBe5 on Linux

Regardless of a personal choice, a need offor freedomfreedom, or no choice at all, many people are using or switching to Linux. It has great advantages, but when it comes to NSMB modding, it becomes a little bit harder.


This

Intutorial this tutorial, I will covercovers how to install and run NSMBe5 on a Linux computer.

  • This tutorial has been tested on the following OSes:
     
    - Fedora 
    - Manjaro (Shouldshould work for every Arch-based distribution) 
    - Linux Mint (Shouldshould work for every Debian-based distribution) 
    Help us improve the compatibility list!

Requirements :Requirements:


Step 1: Installing PortProton

Method 1: Via Flathub (recommended)

Follow the Flathub setup guide, then install the app by opening a terminal and typing

typing:

flatpak install flathub ru.linux_gaming.PortProton

If it doesn't work or you need admin rights, check the second method.

Method 2: Manual installation

Go to flathub.org/apps/ru.linux_gaming.PortProton and hit “download”. This will download a .flatpakref file.

The file should appear in your Downloads folder. If your browser asks you where it should save it, choose a location that you will remember.

Capture d’écran du 2025-03-23 12-42-49.png

Go to the file's location, do a right-click on an empty spacespace, and select "Open in a terminal". From there, type the following command:

flatpak install ru.linux_gaming.PortProton.flatpakref

If it doesn't work because admin rights are needed, try the following command instead:

flatpak install --user ru.linux_gaming.PortProton.flatpakref

If this method still doesn't work, ask us in NSMB Central.

Congratulations! You're now ready to open NSMBe!

Step 2: Installing NSMB Editor

PortProton might download some files before starting the first time you launch it. That's normal.

Go to your NSMBe5 folder. Open NSMBe5.exe by double-clicking on it. You should see a window like this:

Copie d'écran_20250330_212505.png

Make sure to change the prefix to "DOTNET"

If you want to add a shortcut to your app menu, click on "Create shortcut". It will ask you where to put it:

Copie d'écran_20250330_212530.png

Once it's done, click on "create shortcut".

Now, to launch the app, you just have to click on the "Launch" button, and there you go!

Capture d’écran du 2025-03-23 12-51-25.png

Congratulations! Now, you are ready to make awesome stuff with Linux!

 

FAQ / Troubleshooting

Some sprites appear weirdly, how can I fix it?

YouWhen might seeopening a windowlevel likein this:the level editor, some elements may seem scaled incorrectly:

Fractionnal scaling issue.png

Some elements are zoomed weirdly, and some others don't. This is because your computer is using fractional scaling. ItThis zooms your screen, but somenot all elements in the app don't.app. To fix that, go into your display settings and select 100% or 200%:

Display.png

Now it's working better!

Now it's working!.png

No better solution has been found yet. If you have one, please tell @rph_nsmb on the NSMB Central server.

It'sIt longtakes a while to navigate with the file explorer. Can't I add a shortcut?

Of course you can! First, you will need to go to the parent folder of the one you want to make a shortcut (for example, I want to add /home/rph/Documents/Template, I'll go to /home/rph/Documents). Right-click on the folder you want to make a shortcut and select "create link". You should see something like this:

Link.png

If you don't see the "Create shortcut" option, take a look at the file explorer's menus or check its settings.

 Right-click on the link and select "cut".

Now, you will need to go to your PortProton setting folder. To do so, go to your home folder and go to PortProton/prefixes/DOTNET/dosdevices. Now paste your linked folder and rename it withto a lowercase letter andfollowed by a :,colon, for example: n:.

Drive.png

Now, if you open the file explorer, you should see youyour drive in "Computer":

Drive 2.png

Congratulations! You have your shortcutshortcut.