Home / Reality Pass / Reality Pass Specification
RealityPass
There are no shortcuts past physics.
Overview
RealityPass is an open source, AI assisted, physics accurate space engineering simulation platform that enables individuals and teams to design, validate, and experience space systems before they are constructed in the real world.
Unlike traditional simulation games, RealityPass does not simplify the laws of physics to improve gameplay. Every spacecraft, habitat, propulsion system, orbital maneuver, and mission is evaluated using deterministic scientific models designed to reproduce realistic outcomes. Successful designs demonstrate engineering excellence, while flawed designs fail for the same reasons they would fail in reality.
RealityPass combines scientific simulation, artificial intelligence, collaborative engineering, and immersive virtual reality into a single platform where users can safely experiment, iterate, and learn from both success and failure.
Major Features
Deterministic Physics Engine
Simulates:
- Orbital mechanics
- N body gravity
- Lagrange points
- Atmospheric drag
- Orbital decay
- Reentry dynamics
- Delta V calculations
- Docking mechanics
- Rendezvous planning
- Spacecraft attitude control
- Momentum exchange
- Rotation dynamics
- Center of mass calculations
- Structural dynamics
- Material stress
- Material fatigue
- Fracture mechanics
- Resonance
- Thermal expansion
- Thermal contraction
- Radiative heat transfer
- Solar heating
- Cryogenic systems
- Propellant boil off
- Vacuum effects
- Pressure systems
- Fluid movement in microgravity
- Fuel slosh
- Electrical systems
- Power distribution
- Battery degradation
- Solar array performance
- Radiation exposure
- Cosmic rays
- Solar storms
- Micrometeoroid impacts
- Orbital debris collisions
Artificial Intelligence
Engineering Assistant
- Reviews every design
- Detects engineering conflicts
- Explains failures
- Suggests alternatives
- Calculates engineering tradeoffs
- Identifies unnecessary mass
- Recommends structural improvements
- Optimizes power systems
- Evaluates propulsion efficiency
- Explains orbital decisions
- Estimates mission risk
Intelligent Scenario Generator
Creates realistic missions including:
- Satellite deployment
- Lunar missions
- Mars missions
- Space stations
- Orbital refueling
- Cargo transport
- Rescue missions
- Deep space exploration
- Planetary infrastructure
- Scientific research
Adaptive Learning
AI continuously improves from:
- Community designs
- Successful missions
- Failure analysis
- Engineering patterns
- User feedback
Virtual Reality
Users can physically experience:
- Launch
- Orbit
- Docking
- Spacewalks
- Structural failures
- Fire events
- Explosions
- Radiation emergencies
- Hull breaches
- Emergency repairs
- Habitat construction
- Robotics
- Landing operations
- Surface exploration
Features include:
- Full OpenXR support
- Motion controls
- Room scale interaction
- Haptic feedback
- Spatial audio
- Zero gravity interaction
- Time accelerated playback
- Slow motion analysis
- Mission replay
Multiplayer
Supports collaborative engineering.
Roles include:
- Mission Commander
- Systems Engineer
- Structural Engineer
- Propulsion Engineer
- Thermal Engineer
- Electrical Engineer
- Flight Controller
- Mission Planner
- Robotics Operator
- Astronaut
Capabilities:
- Shared workspaces
- Design reviews
- Live collaboration
- Design branching
- Version history
- Replay sessions
- Engineering discussions
- Shared simulations
Engineering Systems
Design and simulate:
- Rockets
- Spacecraft
- Satellites
- Space stations
- Orbital habitats
- Lunar bases
- Mars colonies
- Refueling depots
- Solar power stations
- Mining systems
- Manufacturing facilities
- Space telescopes
- Communications networks
- Planetary landers
- Surface vehicles
- Robotic systems
Environmental Simulation
Includes:
- Earth orbit
- Lunar orbit
- Martian orbit
- Deep space
- Asteroid environments
- Planetary gravity
- Radiation belts
- Eclipse cycles
- Solar activity
- Dust environments
- Regolith interaction
- Planetary weather where applicable
Human Factors
Simulation includes:
- Artificial gravity
- Microgravity
- Bone loss
- Muscle loss
- Fatigue
- Stress
- Crew workload
- Oxygen consumption
- Carbon dioxide buildup
- Water recycling
- Food systems
- Medical emergencies
Mission Planning
Plan complete missions including:
- Launch windows
- Orbital transfers
- Gravity assists
- Surface operations
- Cargo logistics
- Crew scheduling
- Maintenance
- Resource allocation
- Emergency contingencies
- Mission timelines
Failure Simulation
Failures are physically simulated.
Examples include:
- Structural collapse
- Propellant leaks
- Engine failures
- Guidance failures
- Thermal runaway
- Power failures
- Battery fires
- Docking collisions
- Orbital instability
- Radiation damage
- Computer faults
- Human error
- Cascading failures
- Mission loss
Every failure includes:
- Cause analysis
- Timeline
- Engineering explanation
- Recovery options
- Lessons learned
Scientific Libraries
Supports:
- Material databases
- Propellant databases
- Aerospace standards
- Orbital datasets
- Space environment models
- Component libraries
- Engineering equations
- Open scientific publications
Plugin System
Developers can create:
- New spacecraft
- New materials
- Physics modules
- AI models
- Mission packs
- Planetary systems
- Visualization tools
- Educational modules
- Research extensions
Educational Features
Includes:
- Guided tutorials
- Interactive lessons
- Engineering challenges
- Scientific explanations
- Mission walkthroughs
- Classroom mode
- Instructor dashboards
- Student progress
- Research mode
Developer Features
- Open API
- Plugin SDK
- Simulation scripting
- Replay API
- Physics debugging
- AI debugging
- Mission editor
- Scenario editor
- Asset pipeline
- Cross platform support
Technical Stack
Simulation
- Rust
- C++
- GPU acceleration
- Vulkan Compute
- CUDA
- Deterministic simulation
Artificial Intelligence
- Local first inference
- Physics aware reasoning
- Symbolic mathematics
- Constraint solving
- Retrieval augmented engineering knowledge
- Explainable AI
Graphics
- Vulkan
- OpenXR
- Physically based rendering
- HDR rendering
- Dynamic lighting
Networking
- Deterministic multiplayer
- State synchronization
- Replay recording
- Version history
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/reality-pass/
License & Notice Requirements
Reality Pass is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to this project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
Roxanne Ardary and roxanneardary.com. - Reality Pass specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
Any update that adds new contributors or modifies attribution should also updatenotice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
Notice – Reality Pass
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – March 9, 2026
Created the repository for Reality Pass. Developed the core concept, physics-accurate simulation engine, AI co-design system, VR integration framework, and project documentation. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – Reality Pass
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.
