terraria-modder-linux

A Linux-focused fork of Terraria Modder designed to remove Windows-specific dependencies and make building and installing mods much easier on Linux.

This project ports the original codebase to work natively on Linux while keeping cross-platform compatibility wherever possible.

Features

• Removes Windows-specific build/runtime dependencies.
• Simplified installation and deployment.
• Cross-build support:
  • XNA on Windows
  • FNA on Linux/macOS
• Fixed various Linux runtime issues.
• Updated build scripts and project paths for Linux.
• Easier compilation of Core and mods.
• Easier deployment into the Terraria directory.

Tested Environment

This project has only been tested with:

• Terraria GOG edition
• Arch Linux
• Linux kernel 7.1.5-zen1

Steam has not been tested yet. If you have the Steam version, feel free to test it and report any issues.

Because the project supports cross-building (XNA on Windows / FNA on Linux and macOS), it may work on macOS, but this has not been tested.

Requirements

• Linux
• .NET SDK 6 or newer
• Mono
• Terraria 1.4.5
• GOG version recommended (tested)

Build & Install

Clone the repository:

git clone https://github.com/keyaruga33/terraria-modder-linux
cd terraria-modder-linux

Build and install:

./install.sh /path/to/Terraria

Example:

./install.sh ~/Games/Terraria

The installer will:

1. Build TerrariaInjector.
2. Build Core.
3. Build all mods.
4. Deploy everything into the Terraria directory.

Running (GOG)

For the GOG version:

Copy

start_modded.sh

into the root Terraria directory (the directory containing start.sh).

Then run:

chmod +x start_modded.sh
./start_modded.sh

or

./start_modded.sh --start

depending on your setup.

Manual Build

Build only:

cd terraria-modder
./build.sh

Deploy only:

./deploy.sh

Build the injector:

cd ../TerrariaInjector
dotnet build -c Release

Notes

• Only the GOG version has been tested.
• Steam support is expected but unverified.
• macOS may work thanks to the FNA backend, but it has not been tested.
• Linux is the primary target platform.

License

GPLv3 License.