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:

• Windows: Documents\My Games\Terraria\Worlds
• MacOS: ~/Library/Application Support/Terraria/Worlds
• 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. Here is how the local folder structure typically looks on Windows:

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 Files tab 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).

Your server's file structure should now look like this:

Step 3: Update Server Game Settings

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

1. Go to the Game Settings 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 Game Settings 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.