How to Upload a Custom World to Your Terraria Server

How to Upload a Custom World to Your Terraria Server

Whether you want to continue a single-player journey with friends or use a pre-made adventure map, uploading a custom world to MintServers is a simple process. In this guide, we will show you how to locate your world files and configure your server to load them.

Step 1: Locate Your Local World Files

Before uploading, you need to find the .wld file on your computer. Depending on your operating system, they are typically found in the following directories:

1. Windows: Documents\My Games\Terraria\Worlds
2. MacOS: ~/Library/Application Support/Terraria/Worlds
3. Linux: ~/.local/share/Terraria/Worlds

Identify the file named after your world (e.g., MyWorld.wld). If you are using tModLoader, you will also need the corresponding .twld file.

Step 2: Upload Files to the Game Panel

To prevent data corruption, always ensure your server is offline before modifying world files.

1. Stop your server from the MintServers dashboard.
2. Navigate to the File Manager on the left sidebar.
3. Open the saves folder, then enter the Worlds folder.
4. Click Upload and select your .wld file (and .twld if applicable).

Step 3: Update Server Startup Settings

Uploading the file is not enough; you must instruct the server to boot the specific file you just added.

1. Go to the Startup tab in your control panel.
2. Find the World Name field.
3. Change the text to match your file name exactly, but do not include the .wld extension. For example, if your file is "Adventure_Map.wld", type "Adventure_Map".

Step 4: Launch the Server

Return to the Console tab and click Start. Watch the logs to ensure the server initializes the correct world. If the world fails to load, verify that the name in the Startup tab matches your filename exactly, including underscores or capitalization.

Your custom world is now live! You and your players can now connect using the server IP and Port.

Common Issues & Troubleshooting

Changing versions or world types can sometimes cause technical hurdles. Here are the most frequent issues:

1. I Cannot Join My Journey Mode Server

Since Journey Mode is similar to Creative Mode in other games, only Journey characters can join these servers. In order to play, create a new character in Journey Mode. Otherwise, consider switching the difficulty to a different setting in your Game Settings.

• Journey Worlds: Can ONLY be entered with Journey characters.
• Classic/Expert/Master Worlds: Journey characters CANNOT join these worlds.

2. "Version Mismatch" Error

This occurs when your local game version differs from the server. Check the server console during startup to see the version it is running, and ensure your Steam client matches. If you downgraded the server, you may need to use Steam Depots to downgrade your local game as well.

3. Server Stuck on "Starting" or "Loading"

If you downgrade to an older version, the server may fail to load a world created in a newer version. For example, a 1.4.4 world cannot be opened by a 1.3 server. You must restore a compatible backup or generate a new world for that version.