Skip to main content
Version: TEdit 5

Install Requirements

info

On Mac, Linux, or Mobile? Try the browser editor at https://www.terraria-map-editor.com.

Installation​

TEdit 5 uses Velopack for installation and automatic updates.

  1. Download TEdit-Setup.exe from the latest release
  2. Run the installer — TEdit is installed to your local app data folder automatically
  3. Launch TEdit from the Start Menu or desktop shortcut

That's it. Future updates are downloaded and applied automatically (see Auto-Update).

note
  • If the installer prompts you to repair, click Yes to continue.
  • If Windows SmartScreen appears, click More info then Run anyway to proceed with the installation.
tip

If you previously used the manual zip install, you can switch to the Velopack installer. The old folder can be deleted after confirming the new install works.

Manual / Portable Install​

If you prefer not to use the installer:

  1. Download the TEdit-x.x.x-win-x64.zip from the latest release
  2. Unzip to an empty folder with write access, such as C:\Games\TEdit
  3. Launch TEdit.exe
warning

The portable zip version does not support automatic updates. You'll need to download new releases manually.

Requirements​

  • Windows 10/11 x64 (earlier versions are not supported)
  • .NET 10 Desktop Runtime — included with the Velopack installer. For portable installs, download here.
  • DirectX 11 compatible GPU with up-to-date drivers

Sprite Viewing​

For sprite/texture rendering, Terraria must be installed or its content files must be accessible:

  • Steam: Program Files (x86)\Steam\steamapps\common\Terraria\Content
  • GOG: Check your GOG install directory

If Terraria isn't installed locally, TEdit still works — you just won't see sprite previews. You can point to a custom content path in Settings.

Known Limitations​

  • Not compatible with modded world files (tModLoader, TConfig)
  • Sprite textures require a Steam or GOG copy of Terraria
  • Some older integrated graphics may have rendering issues