metarmask / teardown

Tools for parsing and converting Teardown game saves

Tools for parsing and converting the binary format for the Teardown game.

Components

• Parsing of the binary format
• User interface to many of the functions of this repository
• Library for importing saves into the editor
• Blender add-on for importing saves

Converting and opening a level in the editor

1. Download the executable from the latest release.
2. Run it.
3. Click one of the levels on the left.
4. Beside the text "Convert to..." at the bottom, click the "Editor" button.
5. Open the mod "converted" which should have appeared in Teardown.

Converting levels will reuse the same Vox files in order to save storage and time. The Vox files are stored in "Teardown/data/vox/hash".

Contributing

Contributions welcome. One way to contribute is to figure out what fields starting with z_ in this this file mean.

Use Rust Nightly. To run the graphical interface, use:

cargo run --release --package teardown-converter

Known issues

• Specific attributes of the following entities are not added to the editor XML:
  • Screen
  • Trigger
• Shapes with more of a certain material kind than can fit in its designated area of the MagicaVoxel palette will have some incorrect materials.