Linux

This guide will walk you through installing and setting up Railyard on Linux.

Step 1 - Downloading Railyard#

To install Railyard on Linux, navigate to the download page. You should see a button with the auto-detected download for your operating system.

Install Flatpak if you do not have it already. You can find instructions for doing so here.

Once you have Flatpak installed, run the following command:

flatpak --user install <Railyard Flatpak Path>

Important

If this command fails, flatpak may not be properly searching for the runtime dependencies. In this case, run flatpak install <Railyard Flatpak Path> if you have access to system-wide installs. Otherwise, run the following before flatpak --user install <Railyard Flatpak Path>:

flatpak --user install org.gnome.Platform//47 org.gnome.Sdk//47 org.freedesktop.Sdk.Extension.golang//24.08 org.freedesktop.Sdk.Extension.node24//24.08

This will install Railyard on your system.

Step 2 - Setting Up Railyard#

When you first launch Railyard, you will be asked to select your metro-maker4 folder.

If you did not manually modify this, click "Auto-Detect". Otherwise, select the location of this folder. Railyard will automatically validate it.

After, you will be asked to select your game executable. Once again, click "Auto-Detect" if you have not modified this. Otherwise, select the location of your game executable.

The next prompt will ask you to input your GitHub token. This is optional, but recommended to avoid hitting GitHub's API rate limits when using Railyard. If you do not have a token or do not wish to use one, simply click "Next" to continue with the setup process. You can always add a token later via the settings menu. To set up a GitHub token, see the GitHub Token guide.

The final prompt will ask you whether you want to enable automatic updates. This will allow Railyard to prompt you every time a new version is released, allowing you to easily stay up to date with the latest features and bug fixes.

Note

It is recommended to keep this enabled to ensure you have the latest features and bug fixes. This can be toggled at any time via the settings menu.

Step 3 - Launching Subway Builder#

Once you install content through Railyard, you must launch the game through Railyard for the content to work properly. To do this, simply click the "Launch" button located on the Railyard navbar.

Important

If you launch the game executable directly, the game will still launch and some mods may even work. However, maps will load without the necessary data needed to load in-game and any custom command-line arguments set through Railyard will not be applied.

When the game is launched, open Settings in-game. Scroll until you see "Mod Manager".

In that menu, enable the Railyard Map Loader mod.

Danger

This is required to load maps installed through Railyard. If you do not enable this mod, maps will fail to load data properly in-game.

After that, you're ready to play! If you have any questions or run into any issues, feel free to ask questions in the Discord or raise an issue on GitHub.