bansheetech/atlas repository overview

⁠
⁠

⁠👽 About The Atlas

The Atlas is a procedural generation engine designed to create vast, complex galaxies and universes. Built with advanced algorithms and inspired by real astrophysical phenomena, The Atlas offers an unparalleled toolset for generating realistic and immersive cosmic environments. It draws inspiration from the team behind No Man's Sky and pushes the boundaries of space simulation.

⁠🎮 Main New Features

• 🌌 Immersive 3D Exploration: Full Three.js visualization of planets, solar systems and galaxies with advanced visual effects, Pillow is deprecated in this new version
• ⛏️ Game Mining System: Manual and automatic resource extraction with cooldowns and daily limits
• 💎 Three Core Resources: Antimatter, Element 115 and Deuterium to power your spaceship
• 🚀 Spaceship Progression: Level system with efficiency, range and multiplier upgrades
• 🎯 Daily Challenges: Scalable objectives that increase in difficulty each day
• 💰 Secret Treasure Chests: Ultra-rare treasures with 0.000001 spawn probability
• 🧬 10 Types of Life Forms: From intelligent life to divine entities
• 🌍 +26 Planet Types: Each with unique characteristics and specific resources
• 🔮 Planetary Anomalies: Rare and mysterious phenomena to discover
• 📱 Screenshots: Generate 4K Screenshots of anything you're viewing, including QR codes for instant access and image sharing!
• 🌀 Stargate Links: Encoded URLs for instant travel to share any location with your friends

⁠🧬 Life Forms and Visualization

And more!

⁠🪐 Real-time Orbital Physics

• Planetary Rotation: Period calculated based on physical properties
• Orbital Mechanics: Variable speeds according to star distance
• Tidal Effects: Close planets become tidally locked
• Axial Tilt: Affects seasons and ring visibility
• Roche Limit Calculations: Realistic ring formation

⁠🖼️ Users Art Gallery

_{Submit your screenshots and weird planets via Twitter to @SurceBeats in order to be included! Share your seed or make sure to keep your instance online and publicly available}

⁠👀 Other features

• Procedural Universe Creation: Generate diverse galaxies with unique star systems, planetary bodies, and cosmic events.
• Universe Simulation: Simulate the creation and evolution of entire universes, complete with expanding galaxies and planetary motion in real time, following real time physics.
• No Database or Pre-Saved Data: The Atlas does not rely on any database or predefined data. There is no storage of generated content (other than the cache). Everything is procedurally generated in real-time based purely on algorithms and a single primordial seed, even the images.
• Procedural Nature of Existence: The universe, galaxies, planets, and all their characteristics depend on the primal seed and how it is interpreted at the moment of generation. Given the procedural nature everything and nothing exists until we choose to observe it.
• Customizable Parameters: Fine-tune every aspect of the generation process, from physical constants to universe seeds, ensuring a personalized experience (editable via pymodules/__constants.py).
• Synchronized Planet and System Rotation: Planets and systems rotate coherently on screen, with synchronized yet differentiated rotation angles, ensuring visual consistency.
• Procedural Planetary Ring Generation: Planets can procedurally generate rings based on Roche limit calculations, with a realistic 5/7% chance of having rings.
• Optimized Gradient Algorithm: Automatically aligns the shading gradient with the planet's sun(s), dynamically adjusting transparency and opacity for realistic shadow effects.
• Fully Synchronized Planetary Rotation: Planetary rotation and orbital periods are fully synchronized, improving the dynamic accuracy of planetary motion and rendering.
• Performance Improvements in Image Generation: Enhanced Pillow-based drawing functions lead to faster rendering and better overall performance.
• New Universe Initialization System: Choose between exploring the default universe or creating your own custom universe using a seed-based initialization system.
• Increased Planet Sizes and Detail: Planet sizes have been increased by 200%, resulting in more detailed and visually consistent planetary images.
• Dynamic Seasonal Changes: Planets experience seasons, with temperature variations that depend on the planet's orbital position around its star. Temperature recalculations are performed dynamically as the planet moves closer or farther from its star using the inverse square law of radiation.

⁠🔩 Configuration Made Simple

We've recently introduced the Atlas Initialization Protocol, a detailed onboarding process that guides you through configuring your universe on its first start. You can now choose between exploring the Core Continuum (the default shared universe) or creating your own unique universe via the Design the Multiverse option, which uses a seed-based initialization system.

Stargate links will only function properly within the Core Continuum. If you opt to create a custom universe using the Design The Multiverse feature, for stargates to work with others, both parties must have the same cosmic_origin_time and seed configured in their atlas.ini files. Without this, stargates won’t connect unless your Atlas server is publicly accessible on the internet.

Explore, experiment, and evolve with The Atlas—a universe where space and time converge in infinite possibilities.

⁠⬜️ How Big is "The Atlas"?

In The Atlas, you can explore a universe of staggering proportions:

• Galaxies: Up to 1 sextillion (10²¹) galaxies, each located within a vast 10-million-unit coordinate system.
• Galaxy Types:
  • Dwarf Galaxies: 100,000 to 10 million solar systems.
  • Spiral Galaxies: 1 billion to 50 billion solar systems.
  • Elliptical Galaxies: 10 billion to 100 billion solar systems.
• Solar Systems: Approximately 50 tredecillion (5 × 10³¹) solar systems across all galaxies.
• Planets: Each solar system has 1 to 6 planets, resulting in an estimated 300 tredecillion (3 × 10³²) planets.

These numbers showcase the incredible scale of The Atlas, where every exploration reveals new cosmic wonders within a nearly infinite cosmos.

⁠☝️ System Architecture:

Frontend (React + Three.js)
├── 3D WebGL Rendering
├── Custom Shader System
├── localStorage State Management
└── Event System for updates

Backend (Python + Flask - Bridged with vite-fusion)
├── Procedural Generation
├── REST API for data
├── Intelligent Cache System
└── Orbital Physics Calculations

⁠📈 Project Statistics

Lines of Code: 50,000+
React Components: 100+
Three.js Effects: 50+
Planet Types: 26
Life Forms: 10
Game Resources: 3
Treasure Probability: 0.000001
Possible Universes: ∞

⁠📍 Installation and Running Atlas

To get started with The Atlas:

1. Install the required dependencies: pip install Pillow Flask Hypercorn.
2. Run python3 __main__.py.
3. Open your browser and navigate to localhost to select your Universe through the Atlas Initialization Protocol and explore your universe.

Alternatively, you can install all dependencies by running: pip install -r requirements.txt.

⁠🐳 Docker

Directly Docker pull bansheetech/atlas:latest

⁠👾 Security Vulnerabilities

If you discover any security vulnerabilities, please contact us at [email protected]⁠. We take security seriously and will address any issues as soon as possible.

⁠🪪 License

Created by Claudio González⁠ for Banshee⁠.
The Atlas is licensed under the PolyForm Noncommercial License 1.0.0.
Refer to the license overview⁠ for more details.

⁠Important Notice on Commercial Use

This software is licensed under the PolyForm Noncommercial License 1.0.0⁠, which prohibits all commercial uses, including but not limited to:

• Creating, selling, or distributing NFTs.
• Using the software for cryptocurrency-related activities.
• Selling artwork or services generated by the software for commercial gain.

These restrictions ensure the software is used solely for noncommercial purposes.

⁠〽️ Changelog

Refer to the full Changelog⁠ for details on all updates, including new features, fixes, and improvements.