LunCoSim is an open-source, collaborative space simulation platform designed for planning lunar & and space missions, engineering complex systems, and training future space explorers.
Built on the powerful Godot 4 engine, it bridges the gap between gaming and professional space engineering.
- Real Engineering, Gamified: We use real physical models (Modelica integration) and engineering constraints, but accessible enough for enthusiasts.
- Multiplayer Mission Control: Run missions with friends! One person drives the rover, another monitors telemetry, and a third manages the power grid.
- Digital Twin Capability: Design your lunar base, simulate its operations, and validate requirements before bending a single piece of metal.
- Open & Extensible: Built on open standards. Control your entities via Python scripts, HTTP API, or custom plugins.
- Multi-Entity Control: Take direct control of 4 types of units:
- Astronauts: EVA activities and manual tasks.
- Operators: Remote presence and drone control.
- Rovers: Driving and surface operations.
- Spacecraft: Orbital maneuvers and landing.
- Solver-Based Physics: Complex interactions (power, thermal, data) are simulated using a graph-based solver, not just simple game logic.
- Network Mode: Host or join sessions. Work together in the same shared environment.
- "With Friends": Collaborative training scenarios where coordination is key to mission success.
- Telemetry & OpenMCT: Stream real-time data to NASA's OpenMCT dashboard for professional-grade mission monitoring.
- Supply Chain Modeling: Visualize and optimize resource flows (Oxygen, Hydrogen, Power) using a node-based graph editor.
- Modelica Support: Integrate high-fidelity physics models for specialized components.
- HTTP API: Send commands to the simulation from external tools.
- Python Bridge: Write your own control scripts in Python.
- Custom Models: Import your own vehicles and assets.
- Control Guide: How to control Rovers, Astronauts, and more.
- Collaborative Missions: Setting up multiplayer sessions.
- Supply Chain: Using the resource graph view.
- Architecture Overview: System design and "Effector" pattern.
- Telemetry Setup: Connecting to OpenMCT.
- HTTP API Reference: Integrating external tools.
- Modelica Integration: Advanced physics modeling.
- Custom Models: Creating new entities.
-
The development is done on Linux Mate, so there could be issues running on Windows and MacOs. Please reach us
-
Install Godot 4.5
-
Install git lfs. It handles large files in the repository. Use git-cmd if you are on Windows.
-
Clone this repo in a terminal:
git clone -b main --single-branch --recurse-submodules https://github.com/LunCoSim/lunco-sim.git
-
After cloning, change directory to project folder
cd lunco-sim -
Enable git-lfs in the repository after cloning:
git lfs install git lfs pull && git submodule foreach git lfs pull -
Now open project and wait till intenal conent management downloads all the files. LunCoSim Content Manager (new system, gradually being adopted):
- Will be installed automatically with other addons
- After installation, you'll see a "Content" button in the editor toolbar
- Use it to download missing content files when needed
-
Wait till all the files are downloaded. You'll see the message in the Output tab.
-
Restart editor and enjoy!
- Some large files are still managed by git-lfs
- Newer content will use
.contentfiles for external storage - If you see missing files:
- First try git-lfs:
git lfs pull - Then use the Content Manager in the editor toolbar
- If issues persist, please reach out on Discord
- First try git-lfs:
Join our vibrant community and stay updated on the latest developments:
Support development on JuiceBox!