tModLoader Server Configuration Generator
Use this tModLoader Server Config Generator to configure your tModLoader server—your modded Terraria server—without writing serverconfig.txt by hand. Set the world, world size, seed, player count, password, difficulty and modpack using a form or AI Easy Mode. Preview it live, then copy or download it. Free and without sign-up, including Easy Mode.
Built by Florian Galz
Config ready? Rent your server and apply it directly in the panel.
ZapX AI Agent
Explain how you want to configure your server
# tModLoader — generated with the ZAP-Hosting Game Config Generator# zap-hosting.com/tools/terraria/tmodloader-config-generator# Worldworldname=ZAP tModLoader Worldworld=worldautocreate=2seed=# Server identitymaxplayers=8password=motd=Welcome to our ZAP-Hosting tModLoader server!# Difficulty & languagedifficulty=0language=en-US# Security & launch parameterssecure=1upnp=0# Mods
Show config file preview
# tModLoader — generated with the ZAP-Hosting Game Config Generator# zap-hosting.com/tools/terraria/tmodloader-config-generator# Worldworldname=ZAP tModLoader Worldworld=worldautocreate=2seed=# Server identitymaxplayers=8password=motd=Welcome to our ZAP-Hosting tModLoader server!# Difficulty & languagedifficulty=0language=en-US# Security & launch parameterssecure=1upnp=0# Mods
Example result
Example: the generated serverconfig.txt
You set the options using a form or AI Easy Mode, and the generator creates the finished serverconfig.txt for tModLoader live. Below are the first lines of the default configuration; your file contains your values and all other settings.
Example · Default configuration
Output
# tModLoader — generated with the ZAP-Hosting Game Config Generator# zap-hosting.com/tools/terraria/tmodloader-config-generator # Worldworldname=ZAP tModLoader Worldworld=worldautocreate=2seed= # Server identitymaxplayers=8password=motd=Welcome to our ZAP-Hosting tModLoader server! # Difficulty & language- +8 rowsYou can copy or download the complete file in the generator; the sample lines here only show the beginning.
Settings
Keys in your tModLoader Server Config
Like Terraria, tModLoader's serverconfig.txt consists of simple key=value lines, with comments starting with #. The generator writes these keys for you with their default values. modpack and modpath appear in the file only if you fill them in:
| Key | Default value | Meaning |
|---|---|---|
| worldname | Default value: ZAP tModLoader World | World name used when a new world is created automatically. Up to 100 characters. |
| world | Default value: world | Full path to the .wld world file. tModLoader stores its worlds in the Worlds folder under the tModLoader subfolder, separately from Terraria. The server loads this world or creates it there if it does not exist yet. On a ZAP-Hosting server, just the name without the folder or .wld is enough, as in the default value. The server adds both automatically. |
| autocreate | Default value: 2 | Size of an automatically created world: 1 = Small, 2 = Medium, 3 = Large. Applies only if the world file doesn't exist yet. |
| seed | Default value: empty | Seed for automatic world generation. If left empty, tModLoader uses a random seed. |
| maxplayers | Default value: 8 | How many players can be connected at once, from 1 to 255. |
| password | Default value: empty | Password required to join. Leave blank for a public server. It's masked in the form and never included in a share link. |
| motd | Default value: Welcome to our ZAP-Hosting tModLoader server! | Welcome message players see when they connect. Up to 300 characters. |
| difficulty | Default value: 0 | 0 = Classic, 1 = Expert, 2 = Master, 3 = Journey. Applies only to a newly created world; an existing world keeps its difficulty. |
| language | Default value: en-US | Language of console messages. Available options: en-US, de-DE, it-IT, fr-FR, es-ES, ru-RU, zh-Hans, pt-BR and pl-PL. |
| secure | Default value: 1 | 1 turns on additional cheat protection and is recommended; 0 leaves it off. |
| upnp | Default value: 0 | Automatically forwards the port on the router. Not needed on a rented server, so the default is 0. |
| modpack | Default value: empty | tModLoader only: the name of a modpack file, <Name>.json, containing a list of mod names in the ModPacks folder inside the mod folder. The .json extension is optional. The server enables exactly these mods. If the file is missing, startup fails with an error. Leave this empty to load the mods enabled in the mod folder. |
| modpath | Default value: empty | tModLoader only: the folder from which the server loads .tmod files and enabled.json. Leave this empty to use tModLoader's default mod folder. A ZAP-Hosting server always uses its mods folder. |
What the generator intentionally doesn't cover
- port: The port depends on the server's network configuration, so the generator deliberately omits it.
- worldpath and banlist: The generator does not set file or folder paths.
- npcstream and priority: The generator doesn't cover these advanced performance settings.
- The mods themselves: which mods are installed is determined by the .tmod files in the mod folder and enabled.json, not serverconfig.txt.
- Additional startup parameters: This generator field is not a serverconfig.txt key and is not written to the file.
Guide
How to create the config for your tModLoader server
From default values to restarting: how to configure your tModLoader server with serverconfig.txt.
Step 1
Open the generator
The generator starts with the defaults for a serverconfig.txt: 8 players, a medium world and Classic difficulty. To import an existing serverconfig.txt, upload the file or paste its contents.
Step 2
Describe your server or fill in the fields
In Easy Mode, describe your server to the AI in your own words and apply only the suggestions you confirm. In Advanced Mode, you set each field yourself.
Step 3
Set world
Enter the world name and, under world, the path to the .wld world file in tModLoader's Worlds folder. On a ZAP-Hosting server, the filename without .wld is enough. Choose Small, Medium or Large for the world size, and optionally enter a seed.
Step 4
Set player count, password and welcome message
Set the maximum player count from 1 to 255, add a password for a private server and write a welcome message (MOTD).
Step 5
Choose difficulty and language
Choose Classic, Expert, Master, or Journey and the language of console messages. Difficulty only applies to a newly created world.
Step 6
Select Modpack
Enter the name of your modpack file under modpack if you want the server to load exactly those mods. Without a modpack, it loads the mods enabled in the mod folder.
Step 7
Check the preview and export
Check serverconfig.txt in the live preview. Then copy it, download it or share a link that doesn't contain your password.
Step 8
Apply the config to your server
Self-hosted Dedicated Server: Place serverconfig.txt in the tModLoader folder alongside start-tModLoaderServer.sh or .bat. The startup script will use it automatically. To use a file elsewhere, specify it with the -config startup parameter. tModLoader reads it only at startup, so restart the server after every change. ZAP-Hosting server: The server regenerates the file from the startup parameters each time it starts. Set the values in the startup parameters in the panel. For a modpack, add -modpack and its name to the additional startup parameters. Put your mods in the mods folder.
Setup
File location & applying changes
Two ways to get the config onto a server: upload it yourself or apply it directly in our panel.
The manual method
On a self-hosted server
- 1
Download file
Download the generated serverconfig.txt using the button above.
- 2
Upload via file manager or FTP/SFTP
A self-hosted server has no fixed location for it: the server loads the file that the
-configstartup parameter points to. - 3
Apply changes
Place serverconfig.txt in the tModLoader folder alongside start-tModLoaderServer.sh or .bat, and the startup script will use it automatically. To use a file elsewhere, specify it with the -config startup parameter. tModLoader reads it only at startup, so restart the server for changes to take effect.
The ZAP-Hosting way
Startup parameters in the panel
On a ZAP-Hosting server, the server image regenerates serverconfig.txt from the startup parameters every time it starts. Set the values in the startup parameters in the panel. To specify a modpack, add -modpack and its name to the additional startup parameters there. UPnP and mod folder settings are lost on the next start; the server always loads your mods from the mods folder.
- Startup parameters directly in the panel
- No FTP client required
- Online in 60 seconds
More tools
Related tools for your tModLoader server
Server Configuration Generator
Describe your server.properties in your own words using the ZapX AI Agent or set each option manually — with a live preview to copy or download.
Built by Florian Galz
Server Configuration Generator
Describe serverconfig.txt to ZapX AI Agent in your own words or set the options in the form — with a live preview for your Terraria server.
Built by Florian Galz
Terraria Map Viewer
Open your Terraria world file (.wld) and view the full map with biomes, ores, chests, and dungeon. Zoom, search, and save as PNG, entirely in your browser.
Built by Dimitri Heissler
Server Configuration Generator
Describe ServerConfig.json to ZapX AI Agent in your own words or set the options in the form — with a live preview for your Core Keeper server.
Built by Florian Galz
Server Configuration Generator
Describe server.cfg to ZapX AI Agent in your own words or set the options in the form — with a live preview for your Necesse server.
Built by Florian Galz
FAQ
Frequently asked questions about tModLoader Server Config
Quick answers about differences from Terraria, file location, mods and modpacks, Dedicated Servers, world settings, import, Easy Mode and passwords.
Is tModLoader's serverconfig.txt the same as Terraria's?
Almost. tModLoader reads the same keys as a Terraria server, such as world, worldname, maxplayers, password and difficulty, in the same key=value format. It also supports two keys specific to tModLoader: modpack for a modpack and modpath for the mod folder. For a server without mods, use the Terraria Server Config Generator. Go to Terraria Server Config Generator
Where is serverconfig.txt on a tModLoader server?
On a ZAP-Hosting server, it is in the config folder: config/serverconfig.txt on Linux and config\serverconfig.txt on Windows. It is regenerated from the startup parameters in the panel each time the server starts, so changes you make directly to the file will not persist. On a self-hosted server, it is in the tModLoader folder alongside start-tModLoaderServer.sh or .bat, where the startup script uses it automatically. To use a different file, specify it with the -config startup parameter.
How do I load a Terraria modpack on my tModLoader server?
Without a modpack, the server loads .tmod files from the mod folder and enables the mods listed in enabled.json. With modpack, it loads only the mods listed in a modpack file: a JSON list of mod names stored as <Name>.json in the ModPacks folder inside the mod folder. Modpacks you save in the tModLoader menu are folders instead. Copy their Mods/enabled.json file to the ModPacks folder as <Name>.json so the server can find it. On a ZAP-Hosting server, mods are in the mods folder. Specify the modpack by adding -modpack and its name to the additional startup parameters.
What happens if the modpack does not exist?
The server will not start. tModLoader looks for a file named after the modpack value, with the .json extension, in the ModPacks folder inside the mod folder. If the file is missing or invalid, startup fails with an error. Leave modpack empty if you are not using a modpack.
How do I set up a tModLoader Dedicated Server?
Create serverconfig.txt in the generator and place it in the tModLoader folder. Then start the server with start-tModLoaderServer.sh on Linux or start-tModLoaderServer.bat on Windows. The script automatically uses the serverconfig.txt in that folder. Put mods as .tmod files in the mod folder. On ZAP-Hosting, tModLoader is already installed: set the values in the startup parameters in the panel and upload your mods to the mods folder.
Can I change the difficulty, size or seed of an existing world?
No. difficulty, autocreate and seed apply only when Terraria automatically creates a new world because the specified world file doesn't exist yet. An existing world keeps its difficulty. The values are: difficulty 0 = Classic, 1 = Expert, 2 = Master, 3 = Journey; autocreate 1 = Small, 2 = Medium, 3 = Large. If you leave the seed blank, Terraria uses a random seed. Terraria creates the world at startup, not the generator.
Can I edit my existing serverconfig.txt?
Yes. You can upload a .txt or .properties file of up to 2 MB or paste its contents. The generator adds recognized settings to the form; other lines are preserved and placed at the end of the exported file. Comment lines starting with # are dropped.
What does AI Easy Mode do?
Describe the server you want in your own words, such as “small private Expert server with a password for friends,” or click one of the examples. The AI suggests suitable values, explains each change and applies only what you confirm. Your server password is not sent to the AI.
Is the generator free to use without signing in?
Yes. The form, Easy Mode, import, copy, download and share link all work without an account. Easy Mode is briefly rate-limited to prevent excessive requests. The password is masked in the form and never included in a share link, which contains only your changed, non-secret values.
Any more questions?
Contact SupportGet your tModLoader server online today
Rent your tModLoader server now and apply this config directly in the panel.
No setup. No risk. Online in 60 seconds.
