Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
VGSOURCES
List your tool

dedicated serverPATCH 2026.10.16

How to Wipe a tModLoader Terraria Server Without Reinstalling Your Mods

By VGSources Team 12 min read

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To wipe a tModLoader Terraria server, reset the configured world save—not the tModLoader installation. Stop the server cleanly, copy the current world to a dated backup, check the active world= setting or -world launch argument, move the old .wld file out of the live location, then start with autocreate enabled or select a replacement world. Your mods can remain installed and enabled, and player characters are separate files that you can preserve or remove deliberately.

What a server wipe actually changes

A tModLoader wipe normally means replacing one Terraria world. It does not require reinstalling tModLoader, deleting the modpack, or rebuilding the server installation. The server loads the world named by its configuration, so the reset is performed against that configured save location.

As an Amazon Associate I earn from qualifying purchases.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The distinction matters because three kinds of data are commonly confused:

  • World data: the Terraria .wld file selected by the server. Moving or replacing this file produces a new map.
  • Mods and mod configuration: .tmod files, install.txt, enabled.json, and modpacks. These are managed separately from the world.
  • Player characters: character files containing inventories and progression. They are not automatically reset when the world is wiped.

You can therefore start a fresh map while keeping the same tModLoader version, enabled mods, and player characters. A full fresh start requires separate decisions for the mod files and character files.

#1 Best Overall
505 Games Terraria 71501866
  • In Terraria, every world is unique-from the floating islands in the sky to the deepest level of The Underworld. Adventure to the ends of the earth, and defeat villainous bosses along the way. The world is your canvas!

Before deleting anything: choose the kind of reset

Decide the desired outcome before touching the filesystem. The safest first action is a reversible quarantine: move the old world outside the live Worlds directory rather than permanently deleting it. Once the new world has been tested, you can remove the backup according to your own retention policy.

Reset choice World result Mods Player characters Rollback
Quarantine and autocreate A new world is generated at the configured destination. Keep the existing mod files and enabled configuration. Keep or reset separately. Easy: restore the moved world.
Quarantine and select a replacement A prebuilt .wld file is loaded instead of generating one. Keep only if the replacement is compatible with the enabled mods. Keep or reset separately. Easy while the old save remains outside the live path.
Permanent deletion The old world is removed and a new one must be generated or supplied. Unchanged unless you delete them too. Unchanged unless you delete them too. Not available without an independent backup.
Full server reset World, mods, configuration, and possibly characters are rebuilt. Reinstalled or replaced. Deleted or replaced. Depends entirely on your backups.

For a normal map reset, use the first or second row. A world wipe is not a reason to remove the Mods directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Step 1: announce downtime and stop the server cleanly

Tell players when the server will be unavailable and have everyone disconnect. Do not move or delete a world while the server is writing to it; a partially written save can leave you with neither a reliable old world nor a reliable new one.

Use the lifecycle method belonging to your deployment:

  • Docker: stop or detach the container using the normal controls for your compose project. The documented container workflow uses docker compose up -d to start, docker attach tml to attach, and docker exec -it tml execute "YOUR COMMAND" to issue a command inside the container.
  • Management-script installation: use the script’s stop or lifecycle operation rather than killing the process. The management script provides installation, update, mod-installation, and start operations and exposes the server files.
  • Windows direct launch: close the server through the running console or the supplied start-tModLoaderServer.bat workflow, allowing the process to finish saving.
  • Linux or macOS direct launch: stop the process through the shell or the supplied start-tModLoaderServer.sh workflow, again waiting for a clean shutdown.

After stopping, confirm that no tModLoader server process is still running before copying or moving files. If your host has a control panel, its buttons and paths are provider-specific; follow that host’s documented stop procedure.

Step 2: make a recoverable backup

Copy the current world data to a separate location before deletion. Use a dated folder or archive name that identifies the server and the pre-wipe state, such as world-backup-2026-10-15. Keep the backup outside the live Worlds directory so an automatic scan cannot select it as the active save.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The exact host path depends on how tModLoader was installed. Official layouts expose a Worlds directory, while the configured world value can point elsewhere. Back up the file at the configured location and any companion world data your installation keeps with it. Do not assume that a familiar single-player path is the server’s path.

Rank #2
Terraria Boss Rush: Hardmode Edition T-Shirt
  • Gaming Boss Battles design. Boss Rush: Hardfashion Edition items are perfect for fans of Terraria or anyone who likes cool video game clothes! These Terraria items feature the hardmode bosses and is a great way to show your enthusiasm for Terraria!
  • Part of the official Terraria merchandise line from Re-Logic, the creators of Terraria! If you are a terraria fan or should know one, get this design to give yourself or others who play terraria a great gift.
  • Lightweight, Classic fit, Double-needle sleeve and bottom hem
  • Record the original full path and filename.
  • Copy rather than cut until the backup has been checked.
  • Check that the copied file exists and has a plausible nonzero size before proceeding.
  • Keep the backup readable by the account or container that runs the server.

A backup is what makes a quarantine reversible. Permanent deletion should happen only after the replacement world has loaded and players have confirmed that the intended reset occurred.

Step 3: identify the world tModLoader will load

The most common wipe mistake is editing a different file from the one the server actually uses. Find the active configuration and launch arguments, then resolve the final world path.

Read serverconfig.txt

Locate the world= entry in the server configuration. The value must be the full path to the server world and must end in .wld. The tModLoader server guide specifically distinguishes this from .twld: the server world setting takes the .wld file, not the .twld file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For example, a configuration might contain:

world=/path/to/Worlds/MyWorld.wld

The example path above is illustrative; use the exact path on your machine or in the mounted container data. If the value is relative, determine which working directory the launch script uses before deciding which file is active.

Check launch arguments

A batch file, shell script, management tool, or container command can override a configuration file. Look for -world and -config arguments. On Windows, the documented form is a full path such as:

-world "C:pathtoMyWorld.wld"

Linux and macOS launches use the equivalent -world argument with a full filesystem path. If both a configuration file and command-line arguments are present, treat the argument used by the actual launch command as authoritative and verify the resulting console output.

Check the Docker mount

In Docker, the live Worlds directory is normally a host directory mounted into the container. The official utility setup creates Mods and Worlds directories when they are absent. Edit or move the host-side file in the mounted data, not an unrelated directory on the host. Restart the container after changing the mounted data.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Terraria Bunny Plush
  • Product Type:Toy Figure
  • Item Package Dimension:11.6 cm L X 14.4 cm W X 15.8 cm H
  • Item Package Weight:0.1 kg
  • Country Of Origin: China

Step 4: move the old world out of the live location

With the server stopped and the active path confirmed, rename or move the old world to the backup location. Quarantine is preferable to deletion because it prevents the server from finding the old save while preserving an immediate rollback.

  1. Open the directory containing the configured .wld file.
  2. Move that file, and any associated world files your installation stores alongside it, into the dated backup directory.
  3. Leave the destination named in world= empty if you want tModLoader to generate a world there.
  4. If you are using a replacement world, copy the replacement .wld to the destination and make sure the configuration points to that exact filename.
  5. Do not pass a .twld filename as the server’s world value.

Do not place the backup folder inside the active Worlds directory if your deployment automatically discovers world files. Keeping it outside the live directory removes ambiguity about which save should load.

Step 5: configure a fresh generated world

To generate a replacement, set autocreate and worldname in the server configuration, while keeping world pointed at the intended destination. The documented behavior is that autocreate=1 enables automatic creation when no world exists at the provided location. Values 1, 2, and 3 select the available world-size choices; choose the value appropriate for your server.

world=/path/to/Worlds/FreshWorld.wld
autocreate=1
worldname=FreshWorld

The same concepts can be supplied as launch arguments where your script uses command-line configuration:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
-world "/path/to/Worlds/FreshWorld.wld" -autocreate 1 -worldname FreshWorld

Use the syntax required by your existing configuration format. The important conditions are that the destination does not already contain the selected world, autocreate is enabled, and the name and path refer to the world you intend to create. If an old file remains at that path, the server can load it instead of generating anything.

Use a prebuilt replacement instead

If you have a prepared .wld, leave automatic creation off or remove the autocreate setting according to your deployment’s normal configuration, copy the replacement into the configured location, and point world= or -world to it. The replacement must be compatible with the tModLoader version and enabled mods used by the server.

Step 6: start the server using your deployment model

Docker

After editing the mounted data and configuration, start the compose service with the deployment’s normal command. The documented utility workflow uses docker compose up -d. Attach with docker attach tml when you need to watch the server console, or use the documented docker exec -it tml execute "YOUR COMMAND" form for a command inside the running container.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Terraria PS Vita Game
  • 14 Different environments (including dungeons, floating islands, jungles) that go to the extremities of the earth, up in the sky and all the way down to the very deepest depths of the world.
  • Hundreds of weapons, armour and other items to craft, with character advancement.
  • Explore to find different materials and make exotic potions, laser guns, magic wands, flamethrower, diving gear, speed boots, grappling hooks, chainsaws, magic mirrors, etc.
  • 29 Different block types to build whatever you imagine!
  • NPCs and a swarm of enemies (over 150 types) including goblins, wyverns, unicorns, and-GASP-clowns!

Do not edit a temporary container path and expect the change to survive a rebuild. The persistent host-mounted data is the location that must contain the backup, configuration, and replacement world.

Management-script installation

Run the management script’s normal start operation after moving the world and changing the configuration. This installation model keeps direct access to the server files and separately manages tModLoader and mods. A start or update action should not be necessary merely to wipe a world; reinstalling the loader is a different operation.

Windows

Use start-tModLoaderServer.bat or the established batch command. If you pass a world on the command line, use the full .wld path, for example -world "C:...MyWorld.wld". Ensure that the batch file is not silently loading a different -config file.

Linux and macOS

Use start-tModLoaderServer.sh or the equivalent shell command. Supply the full .wld path through -world, or use the configuration file that contains that path. Keep the generated destination writable by the account running the server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Step 7: verify that the wipe succeeded

Do not rely solely on the absence of a familiar filename. Verify the server’s behavior and the resulting map.

  1. Watch the console: confirm that tModLoader creates or loads the path you configured. A successful autocreate run should report world creation rather than loading the quarantined save.
  2. Check the file: after startup, confirm that a new .wld exists at the configured destination and that its timestamp reflects the reset.
  3. Connect with the intended client: use the same tModLoader version and mod set expected by the server.
  4. Inspect the spawn: confirm a new starting location, the selected world size and difficulty, and the expected modded content.
  5. Test persistence: make a harmless change, stop the server cleanly, restart it, and confirm the new world remains loaded.

The configured world path and the autocreate settings are the authoritative indicators of which world the process should load. If the console and filesystem disagree, stop again and recheck the launch command before allowing players to continue.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Keeping or resetting mods

A world wipe does not automatically reinstall, update, or remove mods. Preserve the existing Mods directory, .tmod files, install.txt, enabled.json, and modpack configuration when the goal is a new map with the same gameplay rules.

Best Value
Sale
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
  • System: Intel Core i5-13400F 2.5GHz 10 Cores | Intel B760 Chipset | 16GB DDR5 | 1TB PCIe 4.0 NVMe SSD | Windows 11 Home
  • Graphics: NVIDIA GeForce RTX 5060 8GB Graphics | 1x HDMI | 2x DisplayPort
  • Connectivity: 1 x USB-C 3.2 | 2 x USB-A 3.2 | 6 x USB-A 2.0 | 1 x LAN | WiFi 6 | Bluetooth 5.3 | 7.1 Channel Audio
  • Tempered Side Case Panel | Custom RGB Lighting | Keyboard and Mouse
  • 1 Year Parts & Labor Warranty, Free Lifetime Tech Support

Reset the mod set only when that is an explicit part of the maintenance job. Replacing mods at the same time makes troubleshooting harder because a failed startup could be caused by the new world, a changed mod list, or a version mismatch. If you do change mods, record the old enabled configuration in the backup so you can reproduce the pre-wipe environment.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A replacement world can depend on particular mods. Keep the mod versions and enabled state compatible with that world, and have clients use the same tModLoader version and mod set.

Player characters are a separate decision

Characters are not the world. If players keep their character files, they retain inventories and progression while entering a new map. That can be exactly what a seasonal map reset requires, but it can also undermine a deliberately fresh progression server.

  • Keep characters: leave the player files untouched and tell players that inventories carry into the new world.
  • Reset characters: make a separate backup, then remove or replace the character files according to your installation’s player-data layout.
  • Partial reset: preserve selected characters only if you have a clear policy and a verified backup.

Never delete player files merely because you are moving a world unless the reset policy explicitly includes character progression.

Common failure modes and fixes

The old world still loads

  • Re-read the actual launch command and confirm which -config file is used.
  • Check that world= and -world point to the path you moved, not to a second copy in another directory.
  • In Docker, verify the host-mounted directory rather than a disposable container directory.
  • Ensure the old .wld is not still present at the configured destination under the same or another selected filename.

No new world is generated

  • Confirm that autocreate is enabled and has a valid value.
  • Confirm that the destination path is writable and that the parent directory exists.
  • Check that a stale world file is not already occupying the exact path.
  • Read the console for a path, permission, or configuration error before changing unrelated files.

The server starts but clients cannot join

  • Check that the client and server use the same tModLoader version.
  • Compare enabled mods and versions on both sides.
  • Verify that the replacement world does not require a mod that is missing or disabled.

The container loses the new world after a restart

Inspect the compose volume mapping. The world and configuration must be stored in persistent mounted data; changes made only inside an ephemeral container can disappear when that container is recreated.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You need to undo the wipe

  1. Stop the server cleanly.
  2. Move the generated or replacement world out of the active destination.
  3. Restore the backed-up original .wld to the exact path named by world= or -world.
  4. Remove or disable autocreate if the original file is present.
  5. Start the server and verify that the original spawn and builds return.

A repeatable maintenance checklist

  • Announce the maintenance window and stop the server cleanly.
  • Record the deployment type and the exact active world path.
  • Back up the current world data to a dated location outside the live Worlds directory.
  • Confirm that the server setting uses .wld, never .twld.
  • Move the old world out of the live path or copy a compatible replacement into it.
  • Set autocreate and worldname only when generating a new map.
  • Leave the Mods directory and enabled configuration unchanged unless a mod reset is intentional.
  • Decide separately whether player characters remain.
  • Start through Docker, the management script, the Windows batch file, or the Linux/macOS shell script used by the installation.
  • Verify console output, the new .wld, spawn, world settings, mod content, and persistence before reopening the server.

How the approaches differ

Approach Reversibility Deployment considerations World outcome Mod continuity Player continuity
Move old save, enable autocreate High while the backup is retained. Works with direct scripts, management installations, and mounted Docker data. New generated world. Retained. Retained unless character files are separately changed.
Move old save, install replacement .wld High while the backup is retained. Requires a known replacement path and compatible mod environment. Prebuilt world. Usually retained, subject to compatibility. Retained unless separately changed.
Delete old save permanently Low or none. Provider-specific deletion and backup rules may apply. Generated or replacement world only. Unaffected unless deliberately deleted. Unaffected unless deliberately deleted.
Reinstall the server Depends on backups. More disruptive than a world reset and unnecessary for a map-only wipe. Depends on what is restored. May be replaced or lost. May be replaced or lost.

For most maintenance windows, quarantine plus autocreate gives the clearest separation between the old map and the new one while preserving a straightforward recovery path.

Quick Recap

Bestseller No. 1
Bestseller No. 2
Terraria Boss Rush: Hardmode Edition T-Shirt
Terraria Boss Rush: Hardmode Edition T-Shirt
Lightweight, Classic fit, Double-needle sleeve and bottom hem
$19.99
Bestseller No. 3
Terraria Bunny Plush
Terraria Bunny Plush
Product Type:Toy Figure; Item Package Dimension:11.6 cm L X 14.4 cm W X 15.8 cm H; Item Package Weight:0.1 kg
$17.78
Bestseller No. 4
Terraria PS Vita Game
Terraria PS Vita Game
Hundreds of weapons, armour and other items to craft, with character advancement.; 29 Different block types to build whatever you imagine!
$40.99
SaleBestseller No. 5
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
Graphics: NVIDIA GeForce RTX 5060 8GB Graphics | 1x HDMI | 2x DisplayPort; Tempered Side Case Panel | Custom RGB Lighting | Keyboard and Mouse
$1,285.00

dedicated serverserver administrationTerrariatModLoaderworld reset

Leave a reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.