Lihzahrd

A Lihzahrd walking.

Lihzahrd is a suite of utilities for the manipulation of Terraria save files.

Its name, Lihzahrd, comes from the Terraria enemy of the same name, and corresponds to the word “lizard” with an “h” after each vowel.

It features a Python interface to load, edit, and save Terraria worlds, and a small command-line interface to perform some basic tasks, which also acts as an example on how the package can be used.

Changed in version 4.0.0b1: The version 4 of Lihzahrd is a backwards-incompatible rewrite of the whole library. If coming from version 3 or earlier, expect things to be very different!

Warning

The rewrite of the library is pretty recent, and as a result is not yet very mature.

  • Due to a lack of time, not many tests were written, so test coverage is very low! The likelihood of bugs is therefore much higher.

  • Class names are sometimes inconsistent, since a Style guide was not fully developed;

  • Let’s improve the ergonomicity together: please let us know what you find painful to use, so that we can improve it!

  • Let’s also improve the documentation: please let us know if you don’t understand something in these docs, so that we can fix that!

Tip

If you found this package useful, please consider leaving a tip to Steffo, its main developer!

It will allow him to dedicate more time in the future to both this and other similar projects!

Todo

Terraria 1.4.5.6 data is currently missing.

Research and add the new data and FileVersion when possible.

Table of contents

Developer guide

Contributor guide