Terrasavr » documentation
Loading, please wait...

Table of Contents

This is a set of pages intended to serve as a user manual \ FAQ for Terrasavr.

While it's work-in-progress, it can already prove useful, so feel free to look around.

If there are particular questions that are not covered here, you can also contact me.

Pages by categories:

Saving and loading:

Using Terrasavr:

Misc:

Locating PLR files

"PLR" (short for "Player"?) is the file extension used by Terraria when storing character information. The files themselves are small (usually under 10KB) and contain tightly packed information about the character's stats, visuals, inventory contents, and few other things.

Whereabouts of the files vary by platform:

Windows

Saved characters in Terraria for Windows are located in

My Documents » My Games » Terraria » Players
Most often these are in your "personal" folder (as opposed to "shared" folders).

If needed, you can also quickly bring up this location via "Run" or "Explorer" by using a relative address:

%UserProfile%\Documents\My Games\Terraria\Players

Mac

Saved characters in Terraria for Mac are located in

~/Library/Application Support/Terraria/Players
The easiest way to get there is:

  1. Open "Finder"
  2. Pick menu "Go - Go to Folder..."
  3. Paste the said address
  4. Press the "Go" button

Alternatively you may use the search feature in "Finder" to locate the folder.

Linux

Saved characters in Terraria for Linux are located in

~/.local/share/Terraria/Players
You can usually "cd" there just fine. If using a file manager application, the process is as following:

  1. Open your "home" folder in the file manager of choice.
  2. Enable display of hidden files if not done already (default Ctrl+H)
  3. Navigate to ".local" » "share" » "Terraria" » Players

Depending on your configuration, the files may instead reside in

$XDG_DATA_HOME/Terraria/Players

Use with Terrasavr

Usually you should be able to navigate to the saved characters folder directly from the browser's "file picker" dialog.

If that is not possible, you can often copy the file path to clipboard (e.g. "C:/.../Terraria/Players/Yellow.plr") and paste it into the dialog.

If that is not possible either (or unnecessarily complicated), you can copy the file(s) into an easily accessible location, work with file(s) there, and copy the file(s) back afterwards.

Troubleshooting loading problems

This page houses a list of common problems that you may encounter while loading files and their resolutions.

"Failed to dispatch FileReader"

Means that program has received the file, but could not read it due to certain functionality not being present in the browser. Resolved by using the Flash version, but trying a different (newer) browser also may work.

"The file is empty"

Quite literally, means that the file uploaded contains nothing inside (size is 0KB).
Usually a result of the file going corrupt before the game has decided that there's nothing left to fix in it. Try loading the backup versions (.bak) if there are any.

"That doesn't look like a valid character file"

Due to how the game encodes\decodes the files, their size (in bytes) can only be a multiplier of 16. This error means that the chosen file's size isn't, most likely due to corruption or otherwise missing fragments.

"Failed to load profile. The error was ..."

Is an error from the underlying file reading routines. If neither the regular nor Flash versions can load the file, it usually means that it is corrupt or in wrong format (for example, mods may have an incompatible format for files).

Troubleshooting saving problems

This page houses a list of common problems that you may encounter while saving files and their resolutions.

Nothing happens upon clicking "Save"

Usually means that either:

  1. The browser had skipped the file dialog and sent the file to the "Downloads" folder.
    Check your downloads and copy the file from there if that's so.
  2. The browser had ignored the incoming file alltogether.

Trying the Flash version or a different browser may help.

The browser opens a new tab with gibberish text

Means that your browser, for some reason (perhaps extension being shared with something else), had decided to display the incoming PLR file as text instead (which it isn't). You should be able to "save" (default Ctrl+S) the opened file just fine.

The browser opens a blank tab (without anything in it)

This is an issue that occurs on certain versions of Safari on Mac - the browser, for reasons uncertain, may not understand that it was given a file and is supposed to be displaying a dialog for letting the user choose where to save it.

While I'm yet to find a solution (if any) to this on program's side, there are a couple of possible workarounds:

  1. Use the flash version. The Flash Player provides it's own file dialogs, and can be trusted with the task of successfully showing them.
  2. If you can not (or do not want to) install the Flash Player to run the Flash version, download a standalone Flash Player ("Flash Player Projector") and use it to open the downloadable SWF of Terrasavr.
  3. If you cannot do that either, try a different browser. Should you be wondering, you can also find portable\standalone browsers for Mac.

The game considers the edited character corrupt

If the character wasn't corrupt before opening it with the Terrasavr, it may mean that you've found a bug in the program. If you can send me a copy of the initial (.plr\.bak) and the corrupt (.plr) files along with a short description of what you were doing, that'd be nice (and I would have a chance to fix the problem).

The game ignores the changes to the character

Make sure that the game is closed or is at the title screen while editing.

  • If the character was open in-game, the game will overwrite the changes when exiting back to the menu.
  • The character selection screen will not automatically notice the changes, as it essentially loads all player files (to display the miniatures) when it is opened.

The game crashes time to time \ on "Exit and Save"

This is a very rare problem related to the browser sometimes setting the downloaded files as "read-only". Open "Properties" for both .plr and .bak files and untick the "read-only" checkbox if it is set and apply changes.

Some of the added items\stats\... are missing

While you may change the character file pretty much as you please (and Terrasavr helps with that), the game reserves the right to ignore the changes as it sees fit:

  • There are limits to the maximum amount of health\mana that a character can have. Mods may change or lift the limitations.
  • "Equip" (armor\accessory\social\dye\misc) slots can only house single-item stacks.
  • Not every item can receive every prefix.
  • Items have a maximum stack size and usually cannot be stacked past that.
  • Buffs have a maximum duration (usually 5 hours)
  • When saving a file for the older versions of the game, content added in newer versions will not work (because it wasn't there yet).

However, here's a small list of things that do work while they shouldn't:

  • There is no minimum limit what maximum health can be.
    You can even set it to be 0 and watch the character die in one hit from anything.
  • Armor items can have accessory prefixes.
  • Armor can be equipped in wrong slots (e.g. 3 helmets). Set bonuses will not be granted.
  • Armor items can be equipped in accessory slots (and vice versa).
  • Bullets can have some of the prefixes.
  • You can equip two pets or two "light pets" instead of one of both kind.
    Certain combinations (e.g. Shadow Orb + Fairy Bell) will cause the game to glitchfully re-summon the pet 60 times per second.

Editing the character

General character-related information can be edited via the "Character" tab.
Contents and their functions are as following:

Format

File format version. If you want to migrate the character to an earlier version of the game, this can be used. Version options are grouped by functionality introduced - you only need to set this to a version earlier or equal to the game version used.

Health

Current and maximum health. Click the according number and input the new value.

Mana

Current and maximum mana. Click the according number and input the new value.

Mode

Mode\difficulty. Setting a character to Hardcore mode requires confirmation to avoid accidents. "Expert mode" is set for worlds rather than for characters.

Hair style

Determines the looks of the character's haircut. You can enter an index manually or use arrow-buttons to switch through over the hundred of ones available.

Gender

Determines the character's gender. Gender in Terraria only affects the character's appearance and "hurt" sound effects.

Cloth style

Controls the appearance of character's default clothes. Terrasavr currently does not display these separately, meaning that you may have to experiment with the options to see how each one looks.

Colors

The set of options determines the colors of character's features and default clothes. Colors are entered in hexadecimal format. You can find applications to aid you with picking a color visually by searching "hexadecimal color picker online" or so. A in-program color picker is planned for a later update.

Fishing quests complete

The number of quests completed for the Angler. Higher number means better rewards for the new quests, but only up until 150. Due to a code error, rewards for quests 151+ will have similar odds to those on quest 1. The issue persists since the introduction of fishing quests and is not fixed as of 1.3.0.7.

Extra accessory

Whether the extra accessory slot for "expert mode" worlds have been unlocked. Has no effect in non-expert-mode worlds.

Editing items

The character's possessions are shown across multiple tabs, akin to how they are shown in-game.

Managing items

Items can be managed in roughly the same way as they can be in Terraria:

  • Items can be moved by clicking the source cell, and then clicking the destination cell.
  • Item stacks can be split by right-clicking them (alternatively, shift+clicking).
  • Item stacks can be destroyed by dropping them off into the "library" section on the bottom of each tab.

Adding items

The most common way to add items is through use of "library". To do so, click "Library" on the right, and select a desired item library from the list.
Once selected, the section on the bottom of the tab will be filled with library items, and you will be able to move them to your inventory similar to how you would with shops in the actual game (you can also hold the mouse button to pick up more items at once).

Editing items

Whenever an item slot is clicked, it becomes selected (indicated via a border around it). The selected item can then be edited via the "Edit" tab on the right side.

There you can change the item ID (if you know the desired one), change the item quantity, or change it's prefix. All of three are done by clicking the according number and inputting the new value.

For convenience, the bottom of the "Edit" tab is filled with prefix categories, with items being clickable to quickly apply one or other prefix to the item.

Restocking items

If you need to stack up an item to max capacity, you can do so by middle-clicking it (alternatively, ctrl+clicking). This can be handy for restoring the used up stacks of materials or "preparing" the library tab before filling the inventory tab with item stacks.

Setting modifiers\prefixes

To change an item' modifier, you need to:

  1. Click an item to select it (and click again if you don't want to move it anywhere)
  2. Open the "Edit" tab on the right.
  3. Pick the desired prefix from the bottom half of the tab.

Note that different kinds of items can have different prefixes. If the game discards (or changes) the prefix upon loading, chances are that it's an incompatible one.

Downloading \ offline use

While Terrasavr is largely an online\browser-based program, in some cases you may want to use the program without a connection to the internet.

If you have tried to save the page as-is, chances are that the local copy did not work correctly (or at all). This is due to a couple of factors:

  1. The default (non-Flash) version requires a specific server configuration to run in.
  2. Web browsers can be awkwardly bad at saving interactive web pages for local use.

However, that can be helped - if you download the SWF file used by the flash version, you'll be able to open it with a browser even if no internet connection is available.

If you need to download this documentation, that is much easier to do - simply save any of it's pages. It is specifically designed to include all content in a single file, which then displays displays one or other part of itself depending on the input.

The flash version

The flash version of the program uses Adobe Flash Player instead of JavaScript for vast majority of it's functions.

While it relies on the aforementioned browser plugin to function, that permits it to work more consistently and remain independent of system and browser settings.

If the regular version is not working correctly for you, the flash version is a good alternative to having to open the program in a different browser.

It can also be downloaded for offline use.

Feature requests \ roadmap

This page contains a list and status of commonly requested features.

Set custom stats for items

Currently not possible: Terraria only stores a bit of information about each item in the file, namely just the item index (which item it is), item quantity (where applicable), and the item' prefix index. So that's a job for the downloadable game mods.

Preview the character with armor\vanity\dyes

Planned, but don't hold your breath: while a potentially useful feature, is also a crazy amount of work - not only would I need to efficiently pack all the additional armor and particle imagery, but also precisely replicate the game's algorithms of drawing the various effects and dyes.

tAPI support

Implemented: is a separate program.

While item names\icons\descriptions from custom mods will not be displayed, they can be modified as long as you know the item IDs to input.

Mod support

"Are there plans to support mod X?"

Planned: Since the character files only store item indexes (as opposed to actual stats), supporting a given mod currently requires me to make a partially altered version of the program that would recognize those items and file format changes (see above). Needless to say, that is a lot of work.

In future I plan to make the program more adapted for supporting multiple formats and item sets at once. Most likely will be done together with some major UI overhaul if anything.

Downloadable\executable version

Planned: While you already can download Terrasavr for offline use, I would like at some point to make a "proper" downloadable version that would be able to save/load files without displaying file prompts every time.

That is not as easy as it sounds though - web applications function quite differently to the "native" ones, and doing a native application "right" is quite different from doing a web application "right".

Consistently compiling 5 versions of the program (JavaScript, Flash, Windows, Mac, Linux) would likely be a rather time-consuming process as well.

Terrasavr for Terraria Mobile\Console

"Is it possible to edit Terraria iOS/Android/PS/XBox/... save files with Terrasavr?"

Currently not planned: While Re-Logic are fine with modding the PC versions of the game, 505 games (which handle the mobile\console ports) are not too keen on modding.

In addition, as the topic mentions, editing the save files is against the terms of service on most consoles. And on mobile the save files are stored in "protected" folders, requiring jailbreaking/rooting to access them.

And, since each port can differ a little in file format and items available, it's a subject to the aforementioned "multiple versions" problem as well.

To summarize, these would be hard to me to implement, questionably legal at times, and not even too convenient to use. Thus Terrasavr will only work with Windows\Mac\Linux versions of the game for time being.

Localizations

"Will Terrasavr be available in language X?"

Planned: Currently Terrasavr is only available in English. This is due to a couple of reasons:

  1. The program was not made with multi-language support in mind and thus includes no mechanisms for displaying multiple possible captions for everything.
  2. The font used by the game ("Andy") does not include any non-Latin characters as-is. Picking a different font would disturb the visual consistency with the game.
  3. It would only be possible to include item names and descriptions available in the actual game - any other languages would have a mix of localized UI and English item names/descriptions, which is not good.

I plan to experiment with more compatible approaches to displaying user interface in future, which should potentially both allow to rely on the viewer's system for font features and for translation software to be able to "read" the program's text.

Software for other games

"Could you make an editor for game X?"

Maybe, but most likely not: writing software is not easy, and writing good software is hard.

For example, while it would have been nice to make a similar web editor for Starbound, that introduces series of challenges:

  1. Starbound's player files are larger, more sophisticated, and contain larger volumes of information due to the nature of the game (in comparison, Terraria files are very compact).
  2. Presence of "randomized" items means that displaying the information about them requires figuring out and mimicking the algorithms that produce this information behind the scenes.
  3. The game also spots huge quantities of objects that can be picked up, meaning that packing all of the graphics and texts is a similarly (if not more) challenging task (for reference, items displayed in Terrasavr are packed into a pretty monstrous PNG file).
  4. The game is still in development, meaning that things may change often, breaking any user-created software.

Terrasavr © YellowAfterlife. Terraria content/materials are trademarks/copyrights of Re-Logic and its licensors.