How bencbartlett/overmind works
Main Components
a. Core Control Layer:
• Colony (manages individual room operations)
• Overseer (coordinates colony-level decisions)
• Assimilator (enables multi-player hivemind functionality)
b. Operational Layers:
• Directives System (strategic decision-making)
• Overlords System (tactical unit control)
• Logistics Network (resource management)
• Combat Systems (military operations)
c. Support Systems:
• Memory Management
• Caching System
• Console/Debugging
• Statistics/Metrics
Component Relationships
a. Control Flow:
• Overseer → Colonies → Overlords → Creeps
• Directives → HiveClusters → Tasks
• Assimilator ←→ Other Players' Overmind Instances
b. Resource Management:
• LogisticsNetwork → {TerminalNetwork, LinkNetwork, SpawnGroup}
• Energetics → Resource Distribution
• TradeNetwork → Inter-Colony Resource Exchange
Specific Implementation Details
Specialized subsystems:
• Room Planning System (BasePlanner, RoadPlanner, BarrierPlanner)
• Combat Intelligence (CombatIntel, RoomIntel)
• Movement System (Pathing, Movement helpers)
• Task Management System
Special Notes
• Hivemind nature of the system with the Assimilator
• How the system integrates with the game's API
• Stats collection system feeding into Grafana
• Autonomous decision-making pathways