Skip to main content

​
Migrating Worlds: Professional Data Transfer

Whether you are transitioning a private singleplayer masterpiece to a coordinated multiplayer group or hosting a renowned community adventure map like Builder’s Workshop, the Terraria engine facilitates smooth world migration. This procedure involves more than a simple file transfer; you must correctly synchronize the world metadata and pathing within your server configuration to ensure the engine initializes the correct binary data. This guide walk you through the professional technical workflow for world migration on the FREAKHOSTING platform.

Difficulty

Beginner

Time

5 Minutes

​
Technical Migration Workflow

Follow these steps to deploy your custom world to your dedicated instance.
1

Locate Local Binary

On your personal workstation, navigate to your local Terraria save repository: Documents \ My Games \ Terraria \ Worlds
2

Initialize File Transfer

Establish a connection to your server using an SFTP Client.
3

Deploy to World Directory

Navigate to the following path: /Saves/Worlds/. Upload your .wld file directly into this folder.
4

Configure Engine Logic

Open the serverconfig.txt file in your root directory. Update the following parameters to target your new asset:
  • world=Saves/Worlds/YourWorldName.wld
  • worldname=YourWorldName
5

Initialize the World

Restart your server via the Game Panel. Monitor the console to ensure the engine successfully hashes and mounts the uploaded terrain.

​
Troubleshooting Initialization Failures

If the server generates a generic fresh world instead of loading your custom assets, review these technical commonalities.
Our high-performance nodes use Linux, which is strictly case-sensitive. If your configuration targets MyWorld.wld but the physical file is named myworld.wld, the engine will fail the lookup and initialize a randomized world to prevent a startup crash.
Ensure the world= string in your config file accurately reflects the technical subdirectory. If the file is placed directly in the root directory rather than /Saves/Worlds/, the configuration path must be updated accordingly.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!
Last Updated: January 2026 | Terraria: World migration complete.