Ship categories in this codebase

src/game/Game.ts — manages player ship in the game loop:

• Shield regeneration rate
• Fuel harvest logic
• Input application to flight model
• Damage/death handling

src/game/constants.ts — ship-related constants: HYPERSPACE config, FUEL_HARVEST, GAS_GIANT_SCOOP, BATTLE_DANGER_RANGE, BATTLE_WEAPONS_RANGE

NPC ships

src/game/mechanics/NPCSystem.ts — NPC ship generation and behavior:

• NPCShipState type — position, velocity, cargo, faction, target planet
• Spawn logic — how many ships per system, what they carry
• Trade route AI — movement between planets
• Edit here for NPC ship count, behavior, cargo types

src/game/rendering/SceneRenderer.ts — renders NPC ships via makeNPCShipMesh(). Also manages per-frame NPC movement.

Fleet battle ships

src/game/mechanics/FleetBattleSystem.ts — fleet combat ships:

• FleetShip type — faction, stats, position
• FleetShipRuntime — live combat state (health, behavior, target)
• Behavior states: approach, strafe, retreat
• Weapon range, damage, projectile speed
• Edit here for combat AI, fleet ship stats, battle behavior

src/game/rendering/SceneRenderer.ts — renders fleet ships via makeFleetShipMesh(). Manages fleet battle scene.

Ship visuals / meshes

src/game/rendering/meshFactory.ts — all ship 3D geometry:

• makeNPCShipMesh() — NPC civilian ship mesh
• makeFleetShipMesh() — fleet combat ship mesh (varies by faction)
• Edit here to change ship shapes, sizes, colors, materials

src/game/rendering/effects.ts — ship visual effects:

• Projectile creation (createBattleProjectiles())
• Explosion effects (createBattleExplosions())
• Thrust/engine particle effects
• Edit here for weapon FX, engine trails, explosions

Typical workflows

Change player ship handling (speed, turning, boost):

1. src/game/flight/FlightModel.ts

Change player ship stats (shields, fuel capacity, heat):

1. src/game/GameState.ts — update PlayerState defaults
2. src/game/constants.ts — check relevant constants

Change NPC ship behavior or spawn rate:

1. src/game/mechanics/NPCSystem.ts

Change fleet ship combat stats or AI:

1. src/game/mechanics/FleetBattleSystem.ts

Change ship 3D appearance:

1. src/game/rendering/meshFactory.ts — find makeNPCShipMesh() or makeFleetShipMesh()

Change weapon/projectile effects:

1. src/game/rendering/effects.ts

Add a new ship type:

1. src/game/rendering/meshFactory.ts — add new mesh function
2. src/game/mechanics/NPCSystem.ts or FleetBattleSystem.ts — use the new mesh
3. If the type needs Rust data: engine/src/types.rs, then rebuild WASM