How do I upload my own world?

Stop the server, upload the .wld file and its matching .twld file to the worlds folder in the Savegames tab, then enter the file name without .wld under World file name.

Does my server load mods from the Steam Workshop?

No. Upload the .tmod files to the mods folder yourself and enable them in enabled.json.

tModLoader: Server Configuration

Learn how to configure the world, size, difficulty, password, and mods for your tModLoader game server, and how to switch worlds → Learn more now

10 November 20264 min read0 Views0 helpful

Introduction

With the right configuration, you can make your tModLoader game server exactly the way you want it: your own world with the right size and difficulty, a password, a welcome message, and the mods you want to play with. In this guide, we’ll show you which settings are available, where to find them in ZapX, and how to switch worlds.

How configuration works

tModLoader reads its settings from the serverconfig.txt file in your server’s config folder. You don’t need to edit this file manually: you can find all the settings in ZapX under Configuration > Startup Parameters.

Important

Your server completely rewrites serverconfig.txt from the startup parameters every time it starts. Any changes made directly to the file will be lost on the next start. Always change your settings in the Startup Parameters.

After saving, ZapX will offer to restart the server. Your changes will only take effect after the restart.

Startup parameters at a glance

Startup parameter	Description
World file name	Name of the world file in the `worlds` folder, without `.wld`. Default: `world`
World name	Name of the world in the game. Only used when a new world is created. Default: `ZapX tModLoader World`
Automatic world creation	Size of a new world if the world file doesn’t exist yet: `1` = small, `2` = medium, `3` = large, `0` = off. Default: `2`
Max. players	Maximum number of players online at the same time. Default: `10`
Message of the day (MOTD)	Message players see when they join. Default: `A ZapX tModLoader Server`
Server password	Password required to join. Leave blank for an open server.
Difficulty	Difficulty of a new world: `0` = Classic, `1` = Expert, `2` = Master, `3` = Journey. Default: `0`
Language	Language of the server output, for example `en-US` or `de-DE`. Default: `en-US`
Secure mode	`1` enables Terraria’s additional cheat protection, while `0` disables it. Default: `1`
World seed	Seed for a new world. Leave blank for a random seed.
Additional startup parameters	Optional additional parameters for starting the server. Only use these if you know exactly what a parameter does.

Info

World name, Automatic world creation, Difficulty, and World seed only apply when a new world is created. An existing world keeps its size, difficulty, and seed, even after a restart.

Tip

You can only enter a Journey world (3) with a Journey character. Classic, Expert, and Master worlds can only be entered with regular characters.

ZapX sets the port, mod folder, and world folder for your server, so you don’t need to change these values.

Managing worlds

Your worlds are stored in the worlds folder. Each world has two files: the .wld file containing the Terraria world and the .twld file containing your mod data. The World file name startup parameter determines which world your server loads.

Creating a new world

Set Automatic world creation, Difficulty, and, if you like, World seed and World name.
Enter a new name under World file name, for example welt2.
Save and restart your server.

If your server can’t find a file with that name, it creates a new world. Your previous world remains in the worlds folder, and you can switch back to it at any time by entering its file name again.

Info

Creating a new world takes a few minutes, depending on its size and mods. You can see the progress in the Console.

Uploading your own world

On Windows, you can find your local tModLoader worlds in the Dokumente\My Games\Terraria\tModLoader\Worlds folder.
Stop your server.
In the Savegames tab, upload both the .wld file and the corresponding .twld file to the worlds folder.
Under World file name, enter the file name without .wld, for example MeineWelt for MeineWelt.wld.
Start your server.

Important

If you only upload the .wld file, the world will be missing all content from your mods. Use the same mods on the server that you used to play the world.

Mods

Your mods are stored in the mods folder. The enabled.json file in the same folder specifies which ones your server loads. For instructions on uploading and enabling mods, see our guide Installing mods (tModLoader).

Your server does not load mods from the Steam Workshop automatically. You need to upload the .tmod files to the mods folder yourself.
Your players don’t need to install the mods themselves: tModLoader usually downloads any missing mods from the server automatically when they join.
Settings for server-managed mods are stored by tModLoader in the tModLoaderSave/ModConfigs folder.

Tip

Large mods such as Calamity or Thorium need significantly more memory. Keep an eye on usage in the Statistics tab and upgrade your server if needed.

Conclusion

Your tModLoader server is now set up just the way you want it. If something isn’t working as expected, see our guide to Common issues. If you have any other questions, our support team is available every day! 🙂

FAQ

Frequently asked questions

Your server rewrites serverconfig.txt from the startup parameters every time it starts. Change your settings in ZapX under Configuration > Startup Parameters.

Set the size and difficulty, and optionally a seed, then enter a new name under World file name. The server creates the world after restarting, and your old world remains available.

Difficulty, world size, world name, and seed only apply when creating a new world. Existing worlds keep their current settings.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Which 🍪 cookies would you like to allow?

tModLoader: Server Configuration

Introduction

How configuration works

Startup parameters at a glance

Managing worlds

Creating a new world

Uploading your own world

Mods

Conclusion

Frequently asked questions

tModLoader

How configuration works

Managing worlds

Creating a new world

Uploading your own world

Mods

Conclusion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting