Introducing: Terrasavr!


Hello again. It've been a short while, but I have some news - today I'm proud to present you with... Terrasavr! Terrasavr is a web-based profile viewer & editor for Terraria (video game). You can either take a look at it from that last link, or read the full post for more details.


Just recently - as you may know, I've added FileReference support into OpenFL-bitfive some time ago, which means that one can now use file dialogs to exchange files with user in HTML5 applications. Provided that I wanted to verify that new features work as intended in most cases, it was a logical choice to actually make something to use it. So I've settled with a project that requires a bit of file operations, a bit of cryptography (Terraria profiles are AES-encrypted), and some UI elements as well. So a week of morning work later, there goes this.


Well... because, I can. Also, should you look at existing profile viewers/editors for Terraria, most of them are written in C#, do not have that much of a comfortable UI, and are generally not particularly up to par. So I've decided to make something that would be a change - look good, stay functional, and work everywhere.


One of things I find particularly annoying in tools of this kind is the dependency on other tools or documentation - even if there's a built-in item search function, you still cannot efficiently compare items without looking at wiki (which can be outdated) or loading up the game (which takes time).
At the same time, Terraria (application itself) features an external interface, which can be used by applications for multiple purposes. So I've made a small separate C# tool that would poll the game for item information and then write down significant parts for later use in Haxe app.
For one, results are amusing - application displays pretty much the same set of data that actual game does, sometimes even more:

Comparison of information shown by Terraria and Terrasavr

Item search itself is also kept intuitive, displaying results as you type in a familiar form:

Terraria item search in Terrasavr

And, just in case you don't even know what you're searching for, there is a library of items, both by categories and by index:

Terraria item browsing in Terrasavr

And, of course, there's the usual functionality of adding/removing items, tweaking prefixes, changing player names & modes, and whatnot. Everything is kept more or less intuitive and matches style of game fairly well.

Technology-wise, Terrasavr is made with Haxe + OpenFL, and is compiled into JavaScript+HTML5 application with use of my OpenFL-bitfive. Source will probably be available later on, once I'll clean things up to a point when it would no longer be possible to scare children with some sections of code.

Check it out!
Flash version
(if default one doesn't work)
(if you are feeling lost)

Related posts:

251 thoughts on “Introducing: Terrasavr!

  1. Can this work in terraria 1.4 mobile? Asking since after 1.4 mobile i am preparing overpowered summoner setups.

    • Assuming that Terraria Mobile did not suddenly stray away from the save file format, it should – you’d want to try it and report if something doesn’t work.

    • It seems to work fine with 1.4.1 characters.

      I’ll see about adding 1.4.1 items soon – currently I’m fairly occupied with work so I didn’t even notice that the update came out before reading your comment.

      If you can find item IDs, you can edit the items in even without Terrasavr showing them (select an item and use “Edit” tab on the inventory to change the ID)

  2. I’m making a character who’s only real purpose is to be a narrator so can I go beyond the max amount of health and mana?

    • Although you can set any amount of health/mana in the file, the game will not accept them unless the executable modded to do so – the logic for clamping health/mana is hard-coded.

  3. Please help I can’t make my terrasavr fullscreens and when I press the save player with my added items it says”protocol unsupported”please help.

  4. Hi! Thanks for making this great program. Since Journey Mode came out Terrasavr is even more useful. Being able to remove (or at least hide) things from your researched list to reduce clutter is something that should have been in Terraria itself.

    I was wondering if you’re planning to fix the character preview? One of the first things I like to do with a new character is use Terrasavr to give them the vanity set, and sometimes give a Stylist-only hairstyle. (When replaying the game why not start with the look you want after all)

    But the hairstyle part is a problem with character preview broken. And it’s been broken for a while now even through other fixes getting put in. So I was starting to wonder if that’s something that’s a planned fix or not.

    • The character preview needs to be remade completely – the original implementation relied on me having cropped-collaged the clothing style/body base images by hand and then combined with hair style images using ImageMagick (see image).

      Since Terrasavr is far from the only personal project I work on, it can take some time for me to get to doing something if it cannot be done in a single weekend evening.

Leave a Reply to Robert Cancel reply

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

This site uses Akismet to reduce spam. Learn how your comment data is processed.