Terraria Map Viewer: See and Edit Your World with TEdit

To see a whole Terraria world, open its .wld file in a map viewer: TerraMap shows everything read-only, in your browser or as an app for Windows, macOS and Linux, and TEdit, a Windows editor, also lets you change the world. For a world on a dedicated server, save it, download the .wld over SFTP and open a copy, so the server's own file stays untouched until you decide to replace it.

The current PC version of Terraria is 1.4.5.8, a hotfix from 23 August 2026 (Terraria Wiki), and that matters, because every map tool has to know your world's file version. The versions below were checked on 25 October 2026 on each tool's own release page and on the official Terraria Wiki's list of map viewers.

Which Map Viewer to Use

For simply looking at a world, TerraMap is the one to start with: it never writes to the file, and its page says the browser version runs entirely on your computer, so your world is not uploaded anywhere (TerraMap). Use TEdit when you want to change something.

Why the In-Game Map Shows So Little

Terraria saves the map with your character, not with the world. Each character has a .map file per world in its own folder under Players, and it only contains what that character has explored (Minimap). A new character on an old server world therefore sees black, and two players on the same server see different maps.

A map viewer reads the world file itself, so it shows every block, chest and biome, explored or not. If you want to avoid spoilers, the TerraMap app can load a character's map for the chosen world and show only the parts that character has seen (TerraMap release notes).

Step 1: Save the World on the Server

A dedicated server saves on its own now and then, and since Terraria 1.4.5.0 it also saves when the last player leaves. On shutdown it only saves when you stop it with the exit command (Server). The console commands you need:

• save writes the world to disk while the server keeps running. Enough if you only want to look at the map.
• exit saves and shuts the server down. Use this before an edit you plan to upload again.
• exit-nosave shuts down without saving. Avoid it here.
• version prints the server's Terraria version, which tells you which TEdit build you need.

If you are going to edit, keep the server closed while you work. You are editing a snapshot, so anything players build after the download is lost when you upload the edited file.

Step 2: Download the .wld Over SFTP

First find the file. The server loads the world given after -world in its startup command, or in the world= line of its config file, and worldpath= sets the folder for its worlds (command-line parameters). On a Linux server without either setting, worlds live in ~/.local/share/Terraria/Worlds/.

Then connect with any SFTP client, such as FileZilla or WinSCP:

1. In the server panel, find the SFTP address and username. On our Pterodactyl panel they are under Settings, and the password is your panel password.
2. Connect with protocol SFTP and the port the panel shows, which is not always 22.
3. Download the world file, for example MyWorld.wld, and MyWorld.wld.bak, the backup Terraria makes when it saves.
4. On a tModLoader server, also download MyWorld.twld and MyWorld.twld.bak. More on those below.
5. Put the downloads in a folder you do not touch, and make a copy to work on.

The panel's file manager works too for a small world, but SFTP is easier on large worlds and slow connections.

Step 3: View It with TerraMap

1. Open terramap.github.io in your browser, or install the TerraMap app.
2. Open your copy of the .wld.
3. Pan and zoom with the mouse, and use the search to highlight ores, items in chests, biomes such as the Corruption or floating islands, NPCs, the spawn point and the dungeon.

TerraMap also shows the world's properties, such as its version, size, moon phase and how many altars have been smashed. Because it is read-only, there is no way to damage the world with it.

Step 4: Edit It with TEdit on Windows

TEdit needs Windows 10 or 11 on 64-bit and a DirectX 11 graphics card. The installer on the GitHub release page (TEdit-stable-Setup.exe, or TEdit-beta-Setup.exe for the beta) includes the .NET 10 runtime it needs and keeps TEdit up to date. Windows SmartScreen may warn you, because the installer is not code-signed (TEdit install requirements).

1. Check versions first. If the server's version command says 1.4.5.8, use TEdit 5.2.5-beta0 or newer; the stable 5.2.4 lists 1.4.5.7 (checked 25 October 2026) and warns before it opens a newer world.
2. Open your copy with File > Open (Ctrl+O). For sprite previews, TEdit needs Terraria installed through Steam or GOG on the same PC; without it, editing still works.
3. Make your changes. TEdit can repaint terrain, edit chests, signs and NPCs, and change world settings such as the time and which bosses are defeated (World Properties).
4. Save with File > Save As (Ctrl+Shift+S) under a new name, so your untouched copy stays as it is.

TEdit also makes its own backup every time you save: .TEdit, .TEdit.2 and so on in the same folder, ten by default (Saves and Backups). If a world will not load in Terraria at all, TEdit can sometimes still open it, and its docs suggest repairing the damaged area and saving the result as a new file.

Step 5: Upload the Edited World

1. Stop the server with exit, if it is not stopped already.
2. Over SFTP, rename the server's current world file, for example to MyWorld.wld.old, instead of deleting it.
3. Upload your edited file and give it exactly the name the server loads, such as MyWorld.wld.
4. Start the server, watch the console until the world has loaded, then join and check the area you changed.
5. If the world does not load, stop the server and rename the .old file back.

tModLoader Worlds Need Extra Care

tModLoader saves a second file next to the .wld: a .twld that holds the modded tiles, chest contents, NPCs and mod data. Before each save it copies the old .twld to .twld.bak (tModLoader source). The two files belong together, so always download, back up and upload them as a pair.

TEdit's documentation still lists modded world files from tModLoader and TConfig as not compatible, but its 5.2 releases added .twld support: reading modded tiles and walls and saving the .twld back (TEdit releases). Treat that as new code. Edit copies of both files, load the result in tModLoader with the same mods on your own PC, and only then put it on the server. TerraMap opens the .wld only, so it cannot show what is stored in the .twld. tModLoader also keeps zipped backups of its worlds in a Backups folder inside its Worlds folder (tModLoader usage guide).

The stable tModLoader release is still built on Terraria 1.4.4 (v2026.08.3.0, 1 October 2026), so modded worlds are not on 1.4.5 yet. Our tModLoader and 1.4.5 status post tracks where that stands.

Preview a Seed Before Your Group Starts

A map viewer is also the easiest way to judge a seed before a group commits to it. Create the world in single player with that seed, or let the server do it with -autocreate, -seed and -worldname (in the config: autocreate=, seed= and worldname=), which only creates a world when none exists at the -world path. Then download the .wld, open it in TerraMap and check how far the jungle, the dungeon and the evil biome are from spawn.

If you are still choosing a world size for the server, our Terraria server RAM and world size guide covers the memory side.

Running the World on a Server

Everything above works the same on any host that gives you file access. Our Terraria server hosting starts at €2.00 a month for 2 GB, switches between vanilla Terraria and tModLoader from the panel, and gives you SFTP and a file manager for exactly this kind of job, with DDoS protection and NVMe storage in 9 regions. If you run plugins on vanilla, our TShock setup guide covers that side.

FAQ

What is the best Terraria map viewer? TerraMap for viewing: it is read-only, runs in any browser or as an app on Windows, macOS and Linux, and supports 1.4.5 worlds. For editing on Windows, TEdit; its beta 5.2.5-beta0 supports Terraria 1.4.5.8 (checked 25 October 2026).

Can I use TEdit on a Mac or Linux? No, TEdit needs Windows 10 or 11 on 64-bit. On macOS or Linux, TerraMap covers viewing, and TerraWorld is a browser-based viewer and editor that the official Terraria Wiki lists for 1.4.5.8.

Does TEdit work with tModLoader worlds? Not officially. TEdit's documentation still says modded world files are not compatible, while its 5.2 release notes add .twld support. A tModLoader world keeps its modded data in a separate .twld file, so if you try it, edit copies of both files and test the world in tModLoader before it goes back on the server.

Can a map viewer damage my world? TerraMap cannot, because it only reads the file. TEdit writes to the file you save, which is why you open a copy and save under a new name.

Why does TEdit warn me or refuse to open my world? A world saved by a newer Terraria version than your TEdit build supports gets a "Newer World Version" warning: TEdit offers to load it anyway, but newer tiles and walls may cause problems (TEdit source). On 25 October 2026 the stable TEdit 5.2.4 lists Terraria 1.4.5.7 and the beta 5.2.5-beta0 lists 1.4.5.8, and the server's version console command tells you which one you need. TEdit's troubleshooting page names modded and damaged world files as the reasons a world will not open.

Where is the world file on a Terraria dedicated server? At the path after -world in the startup command or in the world= line of the config file. On Linux, the default folder is ~/.local/share/Terraria/Worlds/.

Related guides: Terraria server RAM and world size, tModLoader server mods, TShock setup, Terraria 1.4.5 and tModLoader status