Teraria Launcher v1.0.12: 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

Features

• 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 currently supports Windows¹ and MacOS
• It DOES NOT change active mods in an instance²
• It DOES NOT delete instances²

---

How to use

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

   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
       ├── 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. 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

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

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

---

How to build

MacOS

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 and change the version number, then run it

   jpackage --type app-image \
    --dest app_build \
    --name "TerrariaLauncher" \
    --app-version {REPLACE THIS} \
    --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!

Windows

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 and change the version number, then run it

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

---

Contributors

Contributor panel made with contrib.rocks.

---

Footnotes

¹ Testers needed. Not confirmed. ² Probably coming soon.