Skip to content
tModLoader
Game Configurator

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.

terraria-tmodloader

ZapX AI Agent

Explain how you want to configure your server

Briefly describe the kind of server you want — we'll suggest matching settings.

For example:

Show config file preview
terraria-tmodloaderserverconfig.txtLive preview
# tModLoader — generated with the ZAP-Hosting Game Config Generator
# zap-hosting.com/tools/terraria/tmodloader-config-generator
# World
worldname=ZAP tModLoader World
world=world
autocreate=2
seed=
# Server identity
maxplayers=8
password=
motd=Welcome to our ZAP-Hosting tModLoader server!
# Difficulty & language
difficulty=0
language=en-US
# Security & launch parameters
secure=1
upnp=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

serverconfig.txt
# 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:

KeyDefault valueMeaning
worldnameDefault value: ZAP tModLoader WorldWorld name used when a new world is created automatically. Up to 100 characters.
worldDefault value: worldFull 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.
autocreateDefault value: 2Size of an automatically created world: 1 = Small, 2 = Medium, 3 = Large. Applies only if the world file doesn't exist yet.
seedDefault value: emptySeed for automatic world generation. If left empty, tModLoader uses a random seed.
maxplayersDefault value: 8How many players can be connected at once, from 1 to 255.
passwordDefault value: emptyPassword required to join. Leave blank for a public server. It's masked in the form and never included in a share link.
motdDefault value: Welcome to our ZAP-Hosting tModLoader server!Welcome message players see when they connect. Up to 300 characters.
difficultyDefault value: 00 = Classic, 1 = Expert, 2 = Master, 3 = Journey. Applies only to a newly created world; an existing world keeps its difficulty.
languageDefault value: en-USLanguage of console messages. Available options: en-US, de-DE, it-IT, fr-FR, es-ES, ru-RU, zh-Hans, pt-BR and pl-PL.
secureDefault value: 11 turns on additional cheat protection and is recommended; 0 leaves it off.
upnpDefault value: 0Automatically forwards the port on the router. Not needed on a rented server, so the default is 0.
modpackDefault value: emptytModLoader 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.
modpathDefault value: emptytModLoader 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. 1

    Download file

    Download the generated serverconfig.txt using the button above.

  2. 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 -config startup parameter points to.

  3. 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 Support
Ready?

Get your tModLoader server online today

Rent your tModLoader server now and apply this config directly in the panel.

4.4/5 Trustpilot32,000+ Active serversSince 2010

No setup. No risk. Online in 60 seconds.

Flexible TermCancel anytimeOnline in 60 seconds