Skip to content
Back to top
View this page

# Lihzahrd

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

User guide

- Install Lihzahrd
- Command-line tools

Developer guide

- `lihzahrd`
- Common operations

Contributor guide

- `lihzahrd._generate`
- Style guide

## Links

- Git forge

- PyPI package

- Tipping

- Index

Todo

Where to provide support for the library?