# nxthingbutv0id/spacesim architecture

> Architecture diagram of the GitHub repository nxthingbutv0id/spacesim, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nxthingbutv0id/spacesim
- Repository: https://github.com/nxthingbutv0id/spacesim

## Overview

WorldSim is a JavaFX celestial-system simulator. The user loads a JSON system, then the animation loop advances its bodies, accepts camera/time/target controls, and renders the resulting system and body statistics. System setup covers JSON decoding, body creation and physical properties; runtime simulation covers gravity and temperature updates; presentation covers body, orbit and ring graphics. The graph preserves documented load/reload, targeting and controls. Edges use excerpts, SOURCE INDEX references, or README statements; unsampled implementation details are not treated as inspected.

Main entry points: [`main/graphics/Animator.java`](https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/Animator.java) (Animation loop), [`main/simulation/bodies/CelestialBody.java`](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/CelestialBody.java) (Celestial body model), [`main/simulation/SimulationSolver.java`](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/SimulationSolver.java) (Gravity solver), [`main/files/JsonReader.java`](https://github.com/nxthingbutv0id/spacesim/blob/main/main/files/JsonReader.java) (JSON system reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and input"]
  node_main["Application entry<br/>[Main.java]"]
  node_manager["Simulation manager"]
  node_animator["Animation loop<br/>[Animator.java]"]
  node_input["Controls and loading<br/>[InputHandler.java]"]
  node_handler["Simulation handler"]
end

subgraph group_system["System loading"]
  node_json["JSON system reader<br/>[JsonReader.java]"]
  node_decoder["Units and references<br/>[Decoder.java]"]
end

subgraph group_physics["Simulation domain"]
  node_solver["Gravity solver"]
  node_celestial["Celestial body model<br/>[CelestialBody.java]"]
  node_star["Star<br/>[Star.java]"]
  node_terrestrial["Terrestrial body<br/>[Terrestrial.java]"]
  node_giant["Gas giant<br/>[GasGiant.java]"]
  node_vectors["Vector math<br/>[Vec2.java]"]
  node_constants["Physical constants<br/>[Constants.java]"]
end

subgraph group_visual["Presentation"]
  node_renderer["Scene renderer<br/>[Renderer.java]"]
  node_bodygraphics["Body graphics<br/>[BodyGraphics.java]"]
  node_orbitgraphics["Orbit graphics<br/>[OrbitGraphics.java]"]
  node_rings["Ring system<br/>[RingSystem.java]"]
end

node_user(("User"))

node_user -->|"controls"| node_input
node_main -->|"starts"| node_manager
node_manager -->|"creates"| node_animator
node_animator -->|"updates"| node_handler
node_animator -->|"handles input"| node_input
node_animator -->|"draws via"| node_renderer
node_input -->|"sets controls"| node_animator
node_input -->|"selects file"| node_animator
node_handler -->|"delegates updates"| node_solver
node_solver -->|"loads system"| node_json
node_json -->|"decodes units"| node_decoder
node_json -->|"creates bodies"| node_star
node_json -->|"creates bodies"| node_terrestrial
node_json -->|"creates bodies"| node_giant
node_solver -->|"updates bodies"| node_celestial
node_solver -->|"sets scale"| node_animator
node_solver -->|"updates temperature"| node_star
node_solver -->|"calculates motion"| node_vectors
node_solver -->|"uses gravity constant"| node_constants
node_star -->|"extends"| node_celestial
node_terrestrial -->|"extends"| node_celestial
node_giant -->|"extends"| node_celestial
node_celestial -->|"creates"| node_bodygraphics
node_celestial -->|"creates"| node_orbitgraphics
node_giant -->|"configures"| node_rings
node_bodygraphics -->|"draws"| node_rings
node_renderer -->|"renders bodies"| node_celestial
node_renderer -->|"reads view state"| node_animator
node_orbitgraphics -->|"tracks body"| node_celestial

click node_main "https://github.com/nxthingbutv0id/spacesim/blob/main/main/Main.java"
click node_manager "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/SimulationManager.java"
click node_animator "https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/Animator.java"
click node_input "https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/InputHandler.java"
click node_handler "https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/SimulationHandler.java"
click node_json "https://github.com/nxthingbutv0id/spacesim/blob/main/main/files/JsonReader.java"
click node_decoder "https://github.com/nxthingbutv0id/spacesim/blob/main/main/files/Decoder.java"
click node_solver "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/SimulationSolver.java"
click node_celestial "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/CelestialBody.java"
click node_star "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/Star.java"
click node_terrestrial "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/Terrestrial.java"
click node_giant "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/GasGiant.java"
click node_vectors "https://github.com/nxthingbutv0id/spacesim/blob/main/main/utils/Vec2.java"
click node_constants "https://github.com/nxthingbutv0id/spacesim/blob/main/main/utils/Constants.java"
click node_renderer "https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/Renderer.java"
click node_bodygraphics "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/BodyGraphics.java"
click node_orbitgraphics "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/OrbitGraphics.java"
click node_rings "https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/RingSystem.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_manager,node_animator,node_input,node_handler,node_user toneBlue
class node_json,node_decoder toneAmber
class node_solver,node_celestial,node_star,node_terrestrial,node_giant,node_vectors,node_constants toneMint
class node_renderer,node_bodygraphics,node_orbitgraphics,node_rings toneRose
```

## Components

### Application and input

- [Application entry](https://github.com/nxthingbutv0id/spacesim/blob/main/main/Main.java): `main/Main.java`
- [Simulation manager](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/SimulationManager.java): `main/simulation/SimulationManager.java`
- [Animation loop](https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/Animator.java): `main/graphics/Animator.java`
- [Controls and loading](https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/InputHandler.java): `main/graphics/InputHandler.java`
- [Simulation handler](https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/SimulationHandler.java): `main/graphics/SimulationHandler.java`

### System loading

- [JSON system reader](https://github.com/nxthingbutv0id/spacesim/blob/main/main/files/JsonReader.java): `main/files/JsonReader.java`
- [Units and references](https://github.com/nxthingbutv0id/spacesim/blob/main/main/files/Decoder.java): `main/files/Decoder.java`

### Simulation domain

- [Gravity solver](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/SimulationSolver.java): `main/simulation/SimulationSolver.java`
- [Celestial body model](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/CelestialBody.java): `main/simulation/bodies/CelestialBody.java`
- [Star](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/Star.java): `main/simulation/bodies/Star.java`
- [Terrestrial body](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/Terrestrial.java): `main/simulation/bodies/Terrestrial.java`
- [Gas giant](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/GasGiant.java): `main/simulation/bodies/GasGiant.java`
- [Vector math](https://github.com/nxthingbutv0id/spacesim/blob/main/main/utils/Vec2.java): `main/utils/Vec2.java`
- [Physical constants](https://github.com/nxthingbutv0id/spacesim/blob/main/main/utils/Constants.java): `main/utils/Constants.java`

### Presentation

- [Scene renderer](https://github.com/nxthingbutv0id/spacesim/blob/main/main/graphics/Renderer.java): `main/graphics/Renderer.java`
- [Body graphics](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/BodyGraphics.java): `main/simulation/bodies/BodyGraphics.java`
- [Orbit graphics](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/OrbitGraphics.java): `main/simulation/bodies/OrbitGraphics.java`
- [Ring system](https://github.com/nxthingbutv0id/spacesim/blob/main/main/simulation/bodies/RingSystem.java): `main/simulation/bodies/RingSystem.java`

### Other components

- **User**

## Connections

- User → Controls and loading: controls (evidence: `README.md`)
- Application entry → Simulation manager: starts (evidence: `main/Main.java`)
- Simulation manager → Animation loop: creates (evidence: `main/simulation/SimulationManager.java`)
- Animation loop → Simulation handler: updates (evidence: `main/graphics/Animator.java`)
- Animation loop → Controls and loading: handles input (evidence: `main/graphics/Animator.java`)
- Animation loop → Scene renderer: draws via (evidence: `main/graphics/Animator.java`)
- Controls and loading → Animation loop: sets controls (evidence: `main/graphics/InputHandler.java`)
- Controls and loading → Animation loop: selects file (evidence: `main/graphics/InputHandler.java`)
- Simulation handler → Gravity solver: delegates updates (evidence: `main/graphics/SimulationHandler.java`)
- Gravity solver → JSON system reader: loads system (evidence: `main/simulation/SimulationSolver.java`)
- JSON system reader → Units and references: decodes units (evidence: `main/files/JsonReader.java`)
- JSON system reader → Star: creates bodies (evidence: `main/files/JsonReader.java`)
- JSON system reader → Terrestrial body: creates bodies (evidence: `main/files/JsonReader.java`)
- JSON system reader → Gas giant: creates bodies (evidence: `main/files/JsonReader.java`)
- Gravity solver → Celestial body model: updates bodies (evidence: `main/simulation/SimulationSolver.java`)
- Gravity solver → Animation loop: sets scale (evidence: `main/simulation/SimulationSolver.java`)
- Gravity solver → Star: updates temperature (evidence: `main/simulation/SimulationSolver.java`)
- Gravity solver → Vector math: calculates motion (evidence: `main/simulation/SimulationSolver.java`)
- Gravity solver → Physical constants: uses gravity constant (evidence: `main/simulation/SimulationSolver.java`)
- Star → Celestial body model: extends (evidence: `main/simulation/bodies/Star.java`)
- Terrestrial body → Celestial body model: extends (evidence: `main/simulation/bodies/Terrestrial.java`)
- Gas giant → Celestial body model: extends (evidence: `main/simulation/bodies/GasGiant.java`)
- Celestial body model → Body graphics: creates (evidence: `main/simulation/bodies/CelestialBody.java`)
- Celestial body model → Orbit graphics: creates (evidence: `main/simulation/bodies/CelestialBody.java`)
- Gas giant → Ring system: configures (evidence: `main/simulation/bodies/GasGiant.java`)
- Body graphics → Ring system: draws (evidence: `main/simulation/bodies/BodyGraphics.java`)
- Scene renderer → Celestial body model: renders bodies (evidence: `main/graphics/Renderer.java`)
- Scene renderer → Animation loop: reads view state (evidence: `main/graphics/Renderer.java`)
- Orbit graphics → Celestial body model: tracks body (evidence: `main/simulation/bodies/OrbitGraphics.java`)
