AstraTerra Docs

Astra Terra turns Vintage Story’s sky into a scientifically grounded astronomy and navigation system. Observe a 5,000+ star Earth-centered sky, navigate by the Sun, Moon, and stars, explore deep-sky objects through a telescope, and chart and monitor your own constellations as the heavens move overhead.

Chart the sky Keep a journal Observe Forecast Connect the stars

Player Docs

• Player Guide: what AstraTerra adds and how to use its instruments.
• Command Reference: every .stars and /stars command.
• Configuration Reference: every key in ModConfig/astraterra.json, its default, and what it does.
• Constellation Build Cheat Sheet: three-letter codes for .stars build.

Developer Docs

• Developer Guide: build, test, package, and repository layout.
• Architecture: runtime systems and ownership boundaries.
• Celestial Model: the sky's coordinates, the sun and moon, and the clock.
• Latitude And Longitude: where the observer's position comes from, and how longitude was invented.
• Extending AstraTerra: the catalog-replacement API another mod builds a sky on.
• Data Pipeline: committed catalog assets and generation tools.
• Manual Verification: in-game smoke checks before release.
• Product Scope: current goals, non-goals, and deferred work.
• Reference Sky Rendering Notes: findings from local reference sky packages.

License

AstraTerra is licensed under the GNU Affero General Public License, version 3 only (AGPL-3.0-only). Third-party assets retain the licenses and attribution listed in THIRD_PARTY_NOTICES.md.