Planet type reference

engine/src/system_generator.rs — procedural generation:

• Surface type probability weights per star type
• Planet color palettes per surface type
• Moon count, ring presence, cloud layer flags
• Oort clouds, asteroid belts, orbital spacing
• Edit here to change what planets get generated and how

Planet rendering (TypeScript / THREE.js)

src/game/rendering/meshFactory.ts — the primary planet rendering file:

• makePlanet() — procedural rocky planet with GLSL shader
• makeGasGiant() — procedural gas giant with band shader
• makeTexturedPlanet() — textured variant (uses planetSkins.ts)
• makeTexturedGasGiant() — textured gas giant variant
• makeRingMesh() — Saturn-style ring system
• Edit here for visual appearance, shader tweaks, geometry changes

src/game/rendering/effects.ts — planet enhancement effects:

• addCityLights() — night-side city light layer (habitable worlds)
• addCloudLayer() — animated cloud sphere
• addSunAtmosphere() — stellar atmosphere glow
• Edit here for atmosphere, clouds, or city light changes

src/game/rendering/planetSkins.ts — texture catalog. Currently references CC0 Solar System Scope textures. Edit here to swap in real texture files or enable textured rendering.

src/game/rendering/textureCache.ts — texture loading and disposal. Edit here if adding texture streaming or memory management.

Planet display in UI

src/ui/SystemMap/SystemMap.tsx — orbital system map showing planets as colored circles with labels. Edit here to change how planets appear on the map (colors, orbit rings, labels).

src/game/GameState.ts — currentSystem.planets array holds the active system's planet data. Touch this when adding new fields to planet state.

src/game/Game.ts — manages the current system's planet objects. Touch when changing how planets are loaded or referenced during gameplay.

Typical workflows

Change a planet's visual appearance:

1. src/game/rendering/meshFactory.ts — find makePlanet() or makeGasGiant() and edit the shader or color logic

Add a new surface type:

1. engine/src/types.rs — add variant to SurfaceType
2. engine/src/system_generator.rs — add color palette and generation weight
3. src/game/rendering/meshFactory.ts — handle the new type in makePlanet()
4. src/ui/SystemMap/SystemMap.tsx — add color for map display
5. Rebuild WASM: npm run wasm:build (or cd engine && wasm-pack build --target web --out-dir pkg)

Add/change ring systems:

1. engine/src/system_generator.rs — control which planet types get rings
2. src/game/rendering/meshFactory.ts — find makeRingMesh() for visual changes

Change cloud or atmosphere effects:

1. src/game/rendering/effects.ts — addCloudLayer() or addSunAtmosphere()

Change city lights:

1. src/game/rendering/effects.ts — addCityLights()

Change planet display on system map:

1. src/ui/SystemMap/SystemMap.tsx