tiargus

Tools to work with the 4X video game Terra Invicta.

Features

• Parse and inspect Terra Invicta save files (.gz format)
• Query habitat sites, factions, settlements, and space bodies
• Export site data to Excel spreadsheets
• Extract and export location data to YAML

Installation

pip install tiargus

Quick Start

from tiargus import TerraInvictaSave, SpaceBodyModule

save = TerraInvictaSave.load()
bodies = SpaceBodyModule.from_save(save)
for body in bodies:
    print(body.name)

CLI Tools

Command	Description
argus site-report	Generate an Excel report of all hab sites
argus extract-game-data	Rebuild bundled game-data YAML resources

Contributing

Contributions are welcome. The short version:

1. Fork the repo and create a branch.
2. Install dev dependencies: pip install -e ".[dev]"
3. Make your changes and run pytest.
4. Open a pull request against main.

See CONTRIBUTING.md for the full process and guidelines.