Lihzahrd can be installed from PyPI like any other public Python package.
Using uv, that means:
uv add lihzahrdYou 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.
Warning
Maliciously designed Terraria worlds can drain system resources, crash the interpreter, or possibly do other evil things!
Make sure you trust worlds before parsing them!
The documentation is available here.
If you know something that is missing in the documentation, please let me know with an issue!
lihzahrd is compatible with PyPy, an alternative implementation on 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!
You can build the docs by entering the docs_source folder and running make html, then committing the whole docs folder.
- The TEdit World Parser, the most accurate source currently available.
- The tModLoader wiki, containing lists of all possible IDs.
- The Terrafirma world documentation, accurate for old worlds (version <69)
- The 1.3.x.x world documentation, a bit incomplete, but an useful source nevertheless.
- A JS World Parser on GitHub.
- A Background Guide on Steam that displays all possible world backgrounds.
- flyingsnake, a map renderer using this package
