jbourdon/space-game
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Consolidate spatial docs into universe model

Browse Source
This commit is contained in:
Jonathan Bourdon
2026-04-06 21:29:49 -04:00
parent 74b8bf4116
commit fdcf83ccec
15 changed files with 129 additions and 652 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/STATIONS.md
View File

@@ -2,7 +2,7 @@
This document defines the intended role of stations in the simulation.
Stations are persistent nodes in the world that own local bubbles, provide services, participate in the economy, and act through station commanders.
Stations are persistent constructions in the world that live in a localspace, provide services, participate in the economy, and act through station commanders.
## Core Principles
@@ -17,7 +17,7 @@ A station lives at one location.
It does not spread across multiple construction points.
Station growth happens by adding modules to the existing station at its current Lagrange point.
Station growth happens by adding modules to the existing station at its current construction location.
To create another station, a faction needs:
@@ -25,7 +25,7 @@ To create another station, a faction needs:
- another station
- another station commander
Before station construction itself, the faction should also secure the site through the Lagrange-point claim process defined in [SPACES.md](/home/jbourdon/repos/space-game/docs/SPACES.md).
Before station construction itself, the faction should secure the chosen site through the appropriate local claim or founding process defined by the universe model.
Station identity and capability should primarily come from module composition, as described in [MODULES.md](/home/jbourdon/repos/space-game/docs/MODULES.md).
@@ -44,13 +44,15 @@ Stations may serve as:
## Spatial Role
Stations are nodes in `system-space` with their own `local-space`.
Stations are constructions that exist inside one `localspace`.
Stations and other built structures should always be located at Lagrange points.
Stations may be built at valid construction anchors such as:
Each Lagrange point can hold only one structure.
- planets
- moons
- Lagrange points
Their local bubbles are where:
Their localspaces are where:
- docking happens
- cargo transfer happens
@@ -58,13 +60,13 @@ Their local bubbles are where:
- local construction happens
- player and AI interaction happens
Local-space defense and contestation are described further in [COMBAT.md](/home/jbourdon/repos/space-game/docs/COMBAT.md).
Localspace defense and contestation are described further in [COMBAT.md](/home/jbourdon/repos/space-game/docs/COMBAT.md).
## Founding A Station
The intended founding flow is:
1. claim a valid Lagrange point
1. claim or secure a valid construction anchor
2. wait for the claim to activate
3. create station construction storage
4. publish buy orders for the required construction materials
@@ -141,15 +143,9 @@ Actual participation in trade and docking should still be policy-controlled. See
Station ownership is not local-bubble exclusive.
The important hard rule is:
Ownership does not imply one faction per localspace.
- one structure per Lagrange point
Not:
- one faction per local bubble
This means friendly or otherwise permitted factions may build stations within the same system, so long as they use different valid locations.
Friendly or otherwise permitted factions may build stations within the same system so long as they use different valid construction locations.
## Services
@@ -181,7 +177,7 @@ Population growth and decline follow the rules in [WORKFORCE.md](/home/jbourdon/
## Relationship To Other Documents
- [SPACES.md](/home/jbourdon/repos/space-game/docs/SPACES.md)
- [UNIVERSE-MODEL.md](/home/jbourdon/repos/space-game/docs/UNIVERSE-MODEL.md)
- [COMMANDERS.md](/home/jbourdon/repos/space-game/docs/COMMANDERS.md)
- [ECONOMY.md](/home/jbourdon/repos/space-game/docs/ECONOMY.md)
- [SHIPS.md](/home/jbourdon/repos/space-game/docs/SHIPS.md)