See the stars

Reality Pass Specification

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

Optional


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 update notice.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.