A Terraria character is mostly stored in a file ending in .plr. TerraWorld's Player Editor opens that file directly in your browser. You can fix a misplaced item, rebuild a lost loadout, change an appearance, or prepare a Journey character without installing a desktop editor.

The editor works on the file you choose and downloads a new copy when you export. It does not silently replace the save in Terraria's folder. That gives you a chance to keep the original before putting the edited character into the game.

1. Find your player file

Close Terraria before replacing a character file. The game may write the character again while closing, which can overwrite the copy you just added. Inside the Players folder, look for a file matching the character name, such as Luna.plr.

Windows

C:\Users\[YourUsername]\Documents\My Games\Terraria\Players

For tModLoader:

C:\Users\[YourUsername]\Documents\My Games\Terraria\tModLoader\Players

The quickest route is to paste the path into File Explorer's address bar. Replace [YourUsername] with your Windows account name, or start at Documents\My Games.

macOS

Open Finder, press Command + Shift + G, then paste one of these paths:

~/Library/Application Support/Terraria/Players
~/Library/Application Support/Terraria/tModLoader/Players

Linux

~/.local/share/Terraria/Players

For tModLoader:

~/.local/share/Terraria/tModLoader/Players

Folders beginning with a dot are hidden. In many file managers, Ctrl + H shows them.

Steam Deck

Switch to Desktop Mode, open Dolphin, enable hidden files, and go to:

/home/deck/.local/share/Terraria/Players

For tModLoader, use:

/home/deck/.local/share/Terraria/tModLoader/Players

Android

Android/data/com.and.games505.TerrariaPaid/Players

Recent Android versions restrict access to Android/data. You may need a file manager that can request access to this folder, or copy the save through a computer. The exact visible storage name depends on the device.

iPhone and iPad

Open the Files app and look under:

On My iPhone (or iPad) → Terraria → Players

If a character is stored only in Steam Cloud and no local .plr appears, open Terraria's character list and move that character back to local storage first. Then check the Players folder again.

2. Make a backup before editing

Copy the original .plr to another folder before making changes. A useful name is Luna-before-edit.plr. For tModLoader characters, also copy the matching .tplr file. The .plr contains the Terraria character data; .tplr can contain data owned by mods. Keep files from the same save together.

Do not test with your only copy. Terraria, tModLoader, mods, and third-party editors can all change a save. A backup is much faster than rebuilding a character by hand.

3. Open the character in TerraWorld

  1. Open TerraWorld Player Editor.
  2. Click Choose character file, or drag the character file onto the page. For tModLoader, select the matching .plr and .tplr together.
  3. Wait for the character name, file version, and editor tabs to appear.
  4. If the file came from mobile Terraria, enable Mobile format before export so the file is written for the correct platform.

Your edits stay in the current browser tab until you export. The status beside the character name tells you whether there are unsaved changes. Undo and Redo are useful when trying several values, while Reset edits returns the character to the state it had when opened.

Open a tModLoader character through Character library

A modded character has two parts: Luna.plr and Luna.tplr. Use files from the same save. The companion file contains mod data that the .plr alone cannot supply.

  1. In Character library, click Choose Terraria folder. On Windows, choose Documents\My Games\Terraria, the save folder rather than the game's installation folder.
  2. Allow the browser to read that folder. The library lists vanilla and tModLoader characters in separate tabs and pairs matching .plr/.tplr filenames automatically.
  3. Select the tModLoader tab. Connect the item sources described below before opening the character, so the editor can load available mod names and images.
  4. Click Open beside the character. Check that the entry includes both filenames. If you just copied a character into the folder, use Refresh to scan again.

You can still use Choose character file without connecting a character library. Select both files in the same file dialog. On browsers without folder access, use file selection; the remembered-folder workflow is not available there.

Connect the tModLoader folder

In the tModLoader tab, find Full tModLoader support and click Connect tModLoader folder. Choose either of these save folders on Windows:

Documents\My Games\Terraria
Documents\My Games\Terraria\tModLoader

The selected location must lead to tModLoader\Mods. Do not select Players, the Mods subfolder itself, or the tModLoader installation under steamapps\common. On macOS and Linux, use the Terraria or tModLoader save folder from section 1.

This connection asks for read and write access. TerraWorld creates a TerraWorld.dev cache folder inside the tModLoader save folder for extracted mod data. This is separate from exporting your character: the editor still downloads edited saves for you to put back manually. The connection should then show Connected; use Change mod folder if you chose the wrong location.

Connect Steam Workshop mods

Mods downloaded through Steam Workshop may live in a Steam library rather than the local Mods folder. Click Connect Steam Workshop and select the folder containing tModLoader's Workshop downloads. For example:

C:\Program Files (x86)\Steam\steamapps\workshop\content\1281930

Your Steam library may be on another drive. TerraWorld accepts steamapps, workshop, content, or 1281930 itself, as long as the path below the selected folder reaches workshop/content/1281930. Selecting the top-level Steam folder or a single Workshop item's numbered subfolder does not work.

Steam access is read-only. This is an additional item source; use it when your character's mods are installed through Workshop. If the required folder is missing, check which Steam library contains the downloaded mods. Connecting an empty or unrelated Steam library will not provide their item images.

Why does the browser ask to reconnect?

Remembering a folder and having permission to read it are separate things. TerraWorld stores the folder reference in this browser, but the browser can require you to grant access again on a later visit. A reconnect message does not mean your character has been deleted.

  1. If the character list needs access, click Reconnect folder in Character library and approve the browser prompt.
  2. In the tModLoader tab, click Reconnect mod folder if that source says Reconnect required. Approve the requested read/write access.
  3. If Steam also needs access, click Reconnect Steam folder and allow reading. Each connection can need its own approval.
  4. Wait for the relevant sources to show Connected, then open the character. If you connected sources after opening a character, export any pending edits first and reopen the saved character to load the sources again.

If you dismiss or deny a prompt, the folder stays unavailable; click the reconnect button again when ready. If the folder was moved, the drive is disconnected, or access cannot be restored, choose the folder again with the appropriate folder button. Clearing site data, changing browser profiles, or using private browsing can also mean selecting folders again. Remembered folders are local to that browser, not an account setting shared across devices.

What mod data can I edit?

For supported mod items, you can change placement, stacks, favorites, and vanilla modifiers. The item picker can add mod items with usable save metadata. Connecting the actual mod packages lets TerraWorld load the available names and textures; it does not make every custom mod system editable.

Unknown custom player data is preserved, and some entries remain read-only. Missing images or a symbolic name such as ModName/ItemName can mean the matching package is missing, inaccessible, or not fully supported. Check the two connection states, the Workshop library, and the installed mod version before trying again. Use the same mod set when checking the exported character in tModLoader.

4. Stats

The Stats tab covers the character name, difficulty, health, mana, play time, death counters, quest progress, and other values available in that version of Terraria. Older character files do not contain every field used by newer releases, so the editor only shows values that exist for the opened file version.

Use sensible values even when a number box accepts something unusual. A very large health, mana, or quest value may be technically writable but can display strangely or be changed by the game when the character loads. Difficulty deserves extra care: Classic, Mediumcore, Hardcore, and Journey characters behave differently after death and when entering worlds.

5. Appearance

The Appearance tab includes a live preview, hair picker, clothing style, skin variant, voice settings, team, and the character's color palette. Hair and clothing pickers show pictures, so you do not need to remember numeric IDs. Color controls cover hair, skin, eyes, shirt, undershirt, pants, and shoes.

The preview combines the character layers in Terraria's drawing order. It is meant to make color and style choices easier before opening the game. Equipped armor, vanity items, dyes, and some special effects can still change the final in-game look.

6. Permanent upgrades

The Upgrades tab contains permanent character bonuses such as Demon Heart, Torch God's Favor, Artisan Loaf, Vital Crystal, Aegis Fruit, Arcane Crystal, Galaxy Pearl, Gummy Worm, Ambrosia, and the Minecart Upgrade Kit where supported. These switches represent progress stored on the character.

Turning a bonus on grants the corresponding character state; it does not replay the game's acquisition animation or remove an item from inventory. If you want a normal progression experience, only enable bonuses the character has actually earned.

7. Inventory and item editing

The Inventory tab shows the main bag, coin slots, and ammo slots. Click an occupied slot to open its details. From there you can choose another item with the searchable visual picker, change its stack, mark it as favorite, apply a valid modifier, or clear the slot.

Modifiers are filtered from the metadata for the selected item. This matters because a sword, accessory, tool, and ranged weapon do not share the same valid modifier list. The preview summarizes effects such as damage, defense, critical chance, mana cost, knockback, use speed, and movement speed before you apply the choice.

You can drag an item to another slot. Hold Ctrl or Alt while dropping to copy it instead of moving it. On a touch screen, press and hold an item, then drag it to the destination. Empty slots remain selectable, so you can use the item picker to add something without first moving an existing item there.

8. Equipment and loadouts

The Equipment tab separates armor, accessories, vanity armor, vanity accessories, and their dye slots. It also includes the character's general equipment and equipment dyes. Choose loadout 1, 2, or 3 before editing, and use Equip this loadout if that set should be active when the character opens in game.

Visibility switches control whether equipped armor and accessories are drawn. They do not remove the item or its stats. This is useful when you want the benefit of an accessory but prefer the character's vanity appearance.

9. Storage

The Storage tab gives access to the Piggy Bank, Safe, Defender's Forge, and Void Vault. Item slots work like the main inventory: click to edit, drag to move, or hold Ctrl/Alt while dropping to copy. The Void Vault also has its enable state on file versions that support it.

Storage belongs to the character, so it follows the player between worlds. Before adding large stacks, remember that each item has its own maximum stack size and that some special items do not behave like ordinary materials.

10. Buffs

The Buffs tab displays each effect with its icon, name, tooltip, and remaining time. Click the effect to open a searchable buff picker, then enter its duration in game ticks. Terraria normally runs at 60 ticks per second, so 3,600 ticks is about one minute.

Debuffs are marked separately. Some effects are designed to be temporary or depend on equipment, an environment, or game logic. Terraria may remove or recalculate them after loading, even if the value was saved correctly.

11. Journey powers and research

For Journey characters, the Research tab can change Godmode, extended placement range, enemy spawn rate, and the item research list. Search by item name or ID to add one item, filter the existing unlocked list, remove entries, clear the list, or use Unlock all.

Unlocking every item creates a long research list. TerraWorld splits it into pages so the browser stays responsive. Use the filter rather than scrolling through the entire catalog. Research values only have their intended effect on Journey characters.

12. Export and put the player back into Terraria

  1. Click Export. TerraWorld downloads a file ending in .edited.plr.
  2. Keep Terraria closed.
  3. Move the original .plr to your backup folder instead of deleting it.
  4. Rename the downloaded file so it uses the original character filename and ends in .plr.
  5. Copy it into the correct Players folder.
  6. Start Terraria and check the character, inventory, equipment, and storage before continuing your main playthrough.

For a paired tModLoader character, Export downloads both Luna.edited.plr and Luna.edited.tplr. If the browser asks to allow multiple downloads, allow them and check that both arrived. Back up both originals, rename the downloaded pair to Luna.plr and Luna.tplr, then place both in tModLoader/Players while the game is closed. Do not combine an edited file with an unrelated or older companion. Unsupported custom fields are preserved rather than exposed as editable controls.

13. Recover a broken player with .plr.bak

Terraria often keeps a backup beside the main save, for example Luna.plr.bak. If the character becomes unreadable, disappears from the list, or loads with clearly broken data, close the game and try the backup:

  1. Open the character's Players folder.
  2. Copy both the broken file and the backup to a safe folder first.
  3. Rename the broken Luna.plr to something such as Luna.broken.plr.
  4. Rename Luna.plr.bak to Luna.plr. Make sure file extensions are visible so the result does not accidentally become Luna.plr.plr.
  5. Start Terraria and check the character.

The backup may be one save behind, so a small amount of recent progress can be missing. If Windows hides extensions, enable View → Show → File name extensions in File Explorer before renaming.

14. Report a bug or request a feature

If something does not work, use the TerraWorld feedback board. A useful report includes the Terraria or tModLoader version, operating system, browser, the tab and action that failed, the exact error message, and steps that reproduce it.

For save-related bugs, say whether the character is vanilla, mobile, Journey, or tModLoader. You can attach a test character only if you are comfortable sharing it; remove personal names or items first if needed. For a feature request, describe the problem you want to solve and an example workflow. That is usually more helpful than only naming a button.