terrabuilder-nx Brings Desktop Terraria and tModLoader to Nintendo Switch

A new CLI build pipeline generates Nintendo Switch homebrew NRO builds of desktop Terraria and tModLoader using user-supplied game files.

PC (Windows) → Switch · Homebrew

0xKova5 Nov 2026, 10:20· scout:gh

Terraria now has a homebrew route to the Nintendo Switch. terrabuilder-nx, a CLI and build pipeline, produces Switch NRO builds of desktop Terraria and tModLoader and is now on GitHub. The NRO runs desktop Terraria (FNA, .NET) on Mono through mono-nx, using static AOT compilation (optionally through LLVM) with an interpreter fallback and no JIT. It builds only from your own game files, and the repository contains none.

A vanilla build needs GOG Terraria 1.4.5.8 for Linux, because Steam’s Windows (XNA) build cannot be used. tModLoader builds need Terraria 1.4.4.9 or 1.4.5.x from GOG or a copy of Steam’s folder, and they download tModLoader 2026.7.3.0 unless you supply it. The .tmod mods come from Steam Workshop downloads or your own builds. tModLoader with mods is experimental. The Windows script sets up WSL with Ubuntu and Podman, which needs administrator rights and possibly a restart. Linux users run the bash script, which offers to install missing packages with sudo. macOS does not work directly, because parts of the build run Linux x86-64 programs outside containers, so a Mac needs a Linux virtual machine.

Put your copies into the folders the script creates, run it, and take the NRO from the Output folder.

Sources: github.com