Skip to main content

A Terraria world parser in Python

Project description


A Terraria world parser in Python.

You can use this package to get programmer-friendly data from a Terraria world!

Install with:

pip install lihzahrd


You can open a world file and get a World object by calling:

import lihzahrd
world = lihzahrd.World.create_from_file("filename.wld")

It will take a while to process: a small Terraria world contains more than 5 million tiles!

Once you have a World object, you can use all data present in the save file by accessing its attributes.


The documentation is available here.

It's a bit messy and incomplete, as I still have not figured out the meaning of some data, and the code is in need of some refactoring.

If you know something that isn't present in the documentation, please let me know with an issue!


lihzahrd is compatible with PyPy, a faster implementation of Python!

If you think that parsing a world takes too much time, you can use PyPy to reduce the required time by a factor of ~3!


Time to parse the same large world:

  • CPython took 11.45 s.
  • Pypy took 3.57 s!


To contribute to lihzahrd, you need to have Poetry installed on your PC.

After you've installed Poetry, clone the git repo with the command:

git clone

Then enter the new directory:

cd lihzahrd

And finally install all dependencies and the package:

poetry install

This will create a new virtualenv for the development of the library; you can activate it by typing:

poetry shell

Please note that for compatibility with PyPy, the project needs to target Python 3.6.

Building docs

You can build the docs by entering the docs_source folder and running make html, then committing the whole docs folder.

References used


lihzahrd is licensed under the AGPL 3.0. That means you have to publish under the same license the source code of any program you create that uses lihzahrd.

See also

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for lihzahrd, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size lihzahrd-2.0.0-py3-none-any.whl (111.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size lihzahrd-2.0.0.tar.gz (92.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page