Skip to content

README.md

Latest commit

 

History

History
121 lines (91 loc) · 6.22 KB

README.md

File metadata and controls

121 lines (91 loc) · 6.22 KB
Raw

🌌 SOLAR SYSTEM SIMULATION 3D (SolarSystemSimulation3D)

Solar System Simulation Preview

An interactive, ultra-realistic 3D Solar System simulation built with modern web and 3D graphics technologies (Three.js & WebGL). It delivers a breathtaking visual panorama alongside comprehensive educational and encyclopedic planetary data, custom GLSL atmospheric shaders, dynamic orbital physics, cinematic post-processing bloom, and out-of-the-box dual-language (English 🇬🇧 / Turkish 🇹🇷) support.

Additionally, with native Lively Wallpaper integration, you can run this live simulation interactively directly as your 3D Windows desktop background.

🔗 Live Demo & Download Links

👉 🚀 Launch Live Web Simulation

📦 Latest Release Packages (v1.0.0)

🖥️ Live Wallpaper Integration (Lively Wallpaper)

This project features native support for Lively Wallpaper, enabling it to operate as a dynamic, interactive 3D desktop wallpaper without disrupting your daily workflow.

🚀 How to Install on Lively Wallpaper

  1. Download and extract SolarSystemSimulation3D-Web.zip (or clone the repository).
  2. Open Lively Wallpaper on your Windows PC.
  3. Drag and drop the index.html file (or extracted folder) directly into your Lively library window.

🎛️ Customization Options (Lively Properties)

Right-click your active wallpaper in Lively and select Customize to dynamically configure the following live parameters:

  • Language (Dil): Toggle seamlessly between English and Turkish.
  • Desktop Interaction: Lock or unlock background mouse camera navigation (rotate/zoom).
  • UI Visibility: Show or hide the floating control panel for a pure cinematic panorama.
  • Time Controls: Freeze orbital movement or resume in real-time.
  • Simulation Speed: Scale simulation temporal speed from 0x to 3x.
  • Realistic Scaling: Switch planet dimensions and orbital radii between aesthetic and scientific proportions.
  • Orbital Lines: Toggle planetary orbit path lines.
  • Panel Opacity: Adjust control panel glassmorphism transparency.

🚀 Key Features

  • Advanced Three.js & WebGL Engine: High-framerate 3D rendering pipeline with procedural particle stars and custom galaxy skybox textures.
  • Dual-Language Support (i18n): Real-time, instant UI language switching between English 🇬🇧 and Turkish 🇹🇷 across all control sliders, tooltips, and encyclopedic data sheets.
  • Custom GLSL Shaders:
    • 🌞 The Sun: Dynamic surface noise textures with dynamic corona atmospheric light scattering.
    • 🌍 Atmospheres: Custom limb-scattering shaders for Earth, Venus, and gas giant atmospheres.
  • Cinematic Post-Processing: UnrealBloomPass bloom rendering for realistic solar glare and lens flare effects.
  • Encyclopedic Planetary Cards: Click on any celestial body (Sun, Mercury, Venus, Earth, Moon, Mars, Ceres, Jupiter, Saturn, Uranus, Neptune, Pluto, Eris) to inspect physical data tables (diameter, surface temp, gravity, escape velocity, atmospheric composition) and generate an interactive wireframe Earth size comparison hologram.
  • Instant UI Navigation: Click anywhere in empty space to dismiss active info cards or control panels cleanly.

🎮 Controls & Interaction Guide

Action Input / Control Description
Language Switch Control Panel Language Button Toggle between English 🇬🇧 and Turkish 🇹🇷
Interaction Lock Control Panel Lock Button Toggle mouse camera rotation lock on/off
Rotate Camera Left Click + Drag Orbit camera around selected focus point (when unlocked)
Zoom Control Panel Zoom Slider / Mouse Wheel Smoothly adjust camera focal distance
Inspect Celestial Body Left Click on Planet Open detailed encyclopedic information card & comparison
Focus Camera Middle Click on Planet Instantly move camera pivot to targeted planet
Close Panels Left Click on Empty Space Dismiss all active UI windows and cards

🛠️ Local Development & Build Commands

If you wish to build or modify the project locally from source:

1. Prerequisites & Installation

git clone https://github.com/MaximusPrime77/SolarSystemSimulation3D.git
cd SolarSystemSimulation3D
npm install

2. Available Scripts

  • Development Server: Run local dev server with hot reload: 
    npm start
# or
npx vite
  • Build Web Distribution (dist/): Compile production web assets: 
    npm run build
  • Build Desktop Setup Installer (.exe): Compile Windows installer package: 
    npm run setup
  • Build Portable Desktop App: Package standalone desktop executable: 
    npm run dist

💻 Tech Stack

JavaScript Three.js HTML5 CSS3 Vite Electron

👤 Author

MaximusPrime77

License: MIT