Teraria Launcher v1.11.2: A tModLoader Instance Manager

Huge thanks to the iTerm team! iTerm2 is a vital part of this launcher's MacOS compatibility. Support George Nachman (iTerm2 Creator) on Patreon

• It sits as an executable in your folder
• It automatically determines the tmodloader instance through folder name
• It can launch both Base Terraria and any tmodloader instances
• It caches loaded mods in each instance
• It currently supports MacOS
• It also supports Windows¹
• It can change active mods in an instance
• It can delete instances
• It can launch multiple instances²

1. Download the app from Releases

2. Obtain a tmodloader PREVIEW instance from their Github

3. Setup your folders like this:

   NOTE: Your folder names must be in camelCase

   Don't be alarmed if iTerm.app gets deleted after the first run. That is normal and it doesn't need to be replaced

   1. MacOS:

   ~/Applications/
   └── Terraria/
       ├── TerrariaLauncher.app
       ├── iTerm.app
       ├── Terraria.app
       ├── calamityMod/
       │   ├── start-tmodloader.sh
       │   ├── LaunchUtils/
       │   │   ├── ScriptCaller.sh
       │   │   └── ...
       │   ├── icon.png
       │   └── ...
       ├── thoriumMod/
       │   ├── start-tmodloader.sh
       │   ├── LaunchUtils/
       │   │   ├── ScriptCaller.sh
       │   │   └── ...
       │   ├── icon.png
       │   ├── enabled.json
       │   └── ...
       └── ...

   2. Windows:

   C:/Users/{YOUR USERNAME}/Documents/
   └── Terraria/
       ├── TerrariaLauncher.exe
       ├── runtime/
       │    └── ...
       ├── app/
       │    └── ...
       ├── Terraria.exe
       ├── calamityMod/
       │   ├── start-tmodloader.bat
       │   ├── LaunchUtils/
       │   │   ├── ScriptCaller.bat
       │   │   └── ...
       │   ├── icon.png
       │   └── ...
       ├── thoriumMod/
       │   ├── start-tmodloader.bat
       │   ├── LaunchUtils/
       │   │   ├── ScriptCaller.bat
       │   │   └── ...
       │   ├── icon.png
       │   ├── enabled.json
       │   └── ...
       └── ...

4. Add an icon.png to every folder (base Terraria already has one)

5. Delete steam_api.dll on Windows

6. Add ALL of your mods to the local folder

   1. MacOS ~/Library/Application Support/Terraria/tModLoader-preview/Mods
   2. Windows C:\Users\{YOUR USERNAME}\Documents\My Games\Terraria\tModLoader\Mods

7. In each instance, enable the mods you want. (Enabled mods will be managed by the app)

8. Run the app and click launch on the instance!

1. git clone https://github.com/amathew4538/TerrariaLauncher.git

2. cd TerrariaLauncher

3. mkdir app_build app_jar

4. ./gradlew shadowJar

5. cp app/build/libs/app-all.jar app_jar/TerrariaLauncher.jar

6. Copy this (change the version number if you want), then run it

   jpackage --type app-image \
    --dest app_build \
    --name "TerrariaLauncher" \
    --app-version 1.0.0 \
    --input app_jar/ \
    --main-jar TerrariaLauncher.jar \
    --main-class TerrariaLauncher.TerrariaLauncher \
    --icon package-resources/icon.icns

7. Move your app to the folder with your Terraria instances

8. Open the app!

1. git clone https://github.com/amathew4538/TerrariaLauncher.git

2. cd TerrariaLauncher

3. mkdir app_build app_jar

4. Compile the jar

   1. In PowerShell: .\gradlew shadowJar
   2. In Cmd Prompt: gradlew shadowJar

5. copy app\build\libs\app-all.jar app_jar\TerrariaLauncher.jar

6. Copy this (change the version number if you want), then run it

   jpackage --type app-image `
   --dest app_build `
   --name "TerrariaLauncher" `
   --app-version 1.0.0 \
   --input app_jar/ `
   --main-jar TerrariaLauncher.jar `
   --main-class TerrariaLauncher.TerrariaLauncher `
   --icon package-resources/icon.ico `
   --win-shortcut `
   --win-menu

Contributor panel made with contrib.rocks.

¹ Can't edit mods yet. Can't cache mod list yet. ² tModLoader is NOT happy if you try though. The app is fine, however.