How votetz/pocket-empire works
Pocket Empire is a turn-based 4X strategy simulation. The principal workflow starts the game, sets up a hex world and factions, advances turns through player/AI actions and game systems, then reports the evolving game through console rendering and victory outcomes. Major documented branches include city economy and research, unit FSM tactics and combat, diplomacy, and environmental events. Relationships below are limited to README statements and source-index references; unsampled subsystems are represented at their supported directory paths.
Main entry points: TurnManager.java Turn Manager · Main.java Game Entry · World.java World State · fsm Unit FSM
Components 24
Game Runtime
- Game Entry
src/main/java/com/pocketempire/Main.java - Game Setup
src/main/java/com/pocketempire/simulation/GameSetup.java - Game Runner
src/main/java/com/pocketempire/simulation/GameRunner.java - Turn Manager
src/main/java/com/pocketempire/simulation/TurnManager.java - Player Controller
src/main/java/com/pocketempire/player/PlayerController.java - Console Renderer
src/main/java/com/pocketempire/display/ConsoleRender.java - Batch Simulation
src/main/java/com/pocketempire/tools/BatchSimulator.java
World and Units
- Hex World
src/main/java/com/pocketempire/world/MapGenerator.java - World State
src/main/java/com/pocketempire/world/World.java - Hex Map
src/main/java/com/pocketempire/world/Map.java - Fog of War
src/main/java/com/pocketempire/world/FogMap.java - Pathfinding
src/main/java/com/pocketempire/pathfinding/Pathfinder.java - Unit Models
src/main/java/com/pocketempire/entities/Unit.java - Unit FSM
src/main/java/com/pocketempire/fsm - Tactical Combat
src/main/java/com/pocketempire/simulation/CombatResolver.java
Faction Strategy
- Factions and Cities
src/main/java/com/pocketempire/entities/Faction.java - City Economy
src/main/java/com/pocketempire/economy/EconomyManager.java - Technology Tree
src/main/java/com/pocketempire/tech/TechTree.java - Diplomacy
src/main/java/com/pocketempire/diplomacy/DiplomacyManager.java - Victory Conditions
src/main/java/com/pocketempire/objective/VictoryManager.java
Game Systems
- World Events
src/main/java/com/pocketempire/events/EventManager.java - Game Event Bus
src/main/java/com/pocketempire/events/GameEventBus.java - Game Configuration
src/main/java/com/pocketempire/config
Other components
- Player
Connections 27
- Player → Game Entry: starts game
- Game Entry → Game Setup: initializes
src/main/java/com/pocketempire/Main.java - Game Entry → Game Runner: runs simulation
src/main/java/com/pocketempire/Main.java - Game Runner → Turn Manager: advances turns
- Turn Manager → Player Controller: invokes actions
src/main/java/com/pocketempire/simulation/TurnManager.java - Player Controller → Console Renderer: renders console
src/main/java/com/pocketempire/player/PlayerController.java - Turn Manager → Diplomacy: updates relations
src/main/java/com/pocketempire/simulation/TurnManager.java - Turn Manager → World Events: updates events
src/main/java/com/pocketempire/simulation/TurnManager.java - Turn Manager → Technology Tree: advances research
src/main/java/com/pocketempire/simulation/TurnManager.java - Turn Manager → World State: uses world state
src/main/java/com/pocketempire/simulation/TurnManager.java - Game Setup → Hex World: creates world
src/main/java/com/pocketempire/simulation/GameSetup.java - Hex World → Hex Map: generates terrain
- World State → Hex Map: holds map
src/main/java/com/pocketempire/world/World.java - World State → Diplomacy: checks hostility
src/main/java/com/pocketempire/world/World.java - Fog of War → Hex Map: reads terrain bounds
src/main/java/com/pocketempire/world/FogMap.java - Fog of War → Unit Models: reveals from units
src/main/java/com/pocketempire/world/FogMap.java - Unit Models → Unit FSM: delegates AI updates
src/main/java/com/pocketempire/entities/Unit.java - Unit FSM → Tactical Combat: resolves engagements
src/main/java/com/pocketempire/fsm/SkirmishState.java - Unit FSM → Pathfinding: requests paths
src/main/java/com/pocketempire/fsm/SkirmishState.java - City Economy → Factions and Cities: updates resources
src/main/java/com/pocketempire/economy/EconomyManager.java - Turn Manager → Factions and Cities: processes factions
src/main/java/com/pocketempire/simulation/TurnManager.java - Diplomacy → Game Event Bus: publishes events
src/main/java/com/pocketempire/diplomacy/DiplomacyManager.java - World Events → Game Event Bus: publishes events
src/main/java/com/pocketempire/events/EventManager.java - Victory Conditions → Game Event Bus: publishes outcomes
src/main/java/com/pocketempire/objective/VictoryManager.java - Turn Manager → Victory Conditions: checks outcomes
src/main/java/com/pocketempire/simulation/TurnManager.java - Game Configuration → City Economy: configures gameplay
- Batch Simulation → Game Runner: runs games