How cubickt/geneships works
GeneShips is an early-stage libGDX naval-ship simulation. The current workflow is desktop launch, click-to-generate a random-genome ship, create its Box2D body and physics updater, then advance and render it each frame. The README describes genetic evolution, biodiversity, tactical AI, race mode, and configurable game modes as plans; they are not evidenced as implemented runtime stages. The graph reflects sampled runtime code and documented roadmap items, not an inspected implementation of those plans.
Main entry points: Ship.java Ship and Genome · Main.java Game Loop · ShipGenerator.java Random Generator · ShipBodyFactory.java Hull Body Factory
Components 14
Desktop Runtime
- LWJGL Launcher
lwjgl3/src/main/java/io/github/GeneShips/lwjgl3/Lwjgl3Launcher.java - Startup Helper
lwjgl3/src/main/java/io/github/GeneShips/lwjgl3/StartupHelper.java
Simulation Loop
- Game Loop
core/src/main/java/io/github/GeneShips/Main.java - Box2D World
core/src/main/java/io/github/GeneShips/Main.java - Random Generator
core/src/main/java/io/github/GeneShips/generators/ShipGenerator.java - Hull Body Factory
core/src/main/java/io/github/GeneShips/generators/ShipBodyFactory.java - Ship Physics
core/src/main/java/io/github/GeneShips/entities/ShipPhysics.java - Ship Renderer
core/src/main/java/io/github/GeneShips/Renderers/ShipRenderer.java
Ship Model
- Ship and Genome
core/src/main/java/io/github/GeneShips/entities/Ship.java - Physics Properties
core/src/main/java/io/github/GeneShips/Interfaces/ShipPhysProp.java - Ship State
core/src/main/java/io/github/GeneShips/Interfaces/ShipState.java - Value Mapping
core/src/main/java/io/github/GeneShips/MathUtils.java
Planned Capabilities
- Evolution and Modes
README.md
Other components
- Player
Connections 20
- Player → Game Loop: clicks to spawn
core/src/main/java/io/github/GeneShips/Main.java - LWJGL Launcher → Startup Helper: checks restart
lwjgl3/src/main/java/io/github/GeneShips/lwjgl3/Lwjgl3Launcher.java - LWJGL Launcher → Game Loop: starts app
lwjgl3/src/main/java/io/github/GeneShips/lwjgl3/Lwjgl3Launcher.java - Game Loop → Box2D World: steps physics
core/src/main/java/io/github/GeneShips/Main.java - Game Loop → Random Generator: requests ship
core/src/main/java/io/github/GeneShips/Main.java - Game Loop → Ship and Genome: updates ships
core/src/main/java/io/github/GeneShips/Main.java - Game Loop → Ship Renderer: renders ships
core/src/main/java/io/github/GeneShips/Main.java - Random Generator → Ship and Genome: constructs
core/src/main/java/io/github/GeneShips/generators/ShipGenerator.java - Random Generator → Hull Body Factory: creates body
core/src/main/java/io/github/GeneShips/generators/ShipGenerator.java - Random Generator → Ship Physics: attaches updater
core/src/main/java/io/github/GeneShips/generators/ShipGenerator.java - Hull Body Factory → Box2D World: creates fixtures
core/src/main/java/io/github/GeneShips/generators/ShipBodyFactory.java - Hull Body Factory → Ship and Genome: reads geometry
core/src/main/java/io/github/GeneShips/generators/ShipBodyFactory.java - Ship and Genome → Ship Physics: updates physics
core/src/main/java/io/github/GeneShips/entities/Ship.java - Ship Physics → Ship and Genome: syncs state
core/src/main/java/io/github/GeneShips/entities/ShipPhysics.java - Ship Renderer → Ship and Genome: reads shape and state
core/src/main/java/io/github/GeneShips/Renderers/ShipRenderer.java - Ship and Genome → Physics Properties: implements
core/src/main/java/io/github/GeneShips/entities/Ship.java - Ship and Genome → Ship State: implements
core/src/main/java/io/github/GeneShips/entities/Ship.java - Ship and Genome → Value Mapping: maps genes
core/src/main/java/io/github/GeneShips/entities/Ship.java - Ship Physics → Value Mapping: maps speed
core/src/main/java/io/github/GeneShips/entities/ShipPhysics.java - Hull Body Factory → Value Mapping: maps hull
core/src/main/java/io/github/GeneShips/generators/ShipBodyFactory.java