Systems Map
The complete federation architecture. Five systems working together to create an autonomous, responsive game engine.
Core Architecture
Federation Console (Core Orchestrator)
↓
Executes Turn Cycle → Triggers Events → Updates Consciousness
↓
All Systems React (Quests, Factions, Tech, NPCs)
↓
State Persists (Save/Load)
The Five Systems
1. Federation Console
The orchestrator. Runs the game loop, manages phases, triggers events, and tracks consciousness evolution.
Consciousness Dims
6 Metrics
What It Does
- Executes autonomous turn cycles
- Manages game phases (Genesis → Late Expansion)
- Triggers narrative events (with 4-choice branching)
- Updates consciousness metrics (Morale, Identity, Confidence, Anxiety, Expansion, Diplomacy)
- Maintains rival NPC federations
- Generates dynamic narratives based on game state
- Saves and loads game state (JSON persistence)
- Provides REPL interface with 13+ commands
Integration Points
Events from Console → Consciousness changes → Faction shifts → Quest progress → Tech unlocks → NPC reactions
2. Quest System
Player progression engine. Quests offer objectives, track completion, and distribute rewards.
Difficulty Levels
5 Tiers
TUTORIAL - LEGENDARY
Scaling
Difficulty Tiers
- Tutorial: New player onboarding
- Easy: Simple objectives
- Normal: Balanced challenges
- Hard: Complex requirements
- Legendary: Ultra-challenging
What It Tracks
- Quest acceptance and completion
- Objective progress (0-100%)
- Quest chains and prerequisites
- Faction affiliation bonuses
- Reward distribution (resources, perks, unlocks)
3. Faction System
Player alignment engine. Join factions, gain reputation, unlock faction-specific content.
Ideologies Available
8 Types
Reputation Tracking
0.0 - 1.0
Registered Factions
- Exploration Corps (Ideology: Discovery) — HQ: Prime Station Alpha
- Peace Alliance (Ideology: Diplomatic) — HQ: Nexus Station
- Science Consortium (Ideology: Scientific) — HQ: Research Station Delta
Available Ideologies
- Diplomatic, Military, Cultural, Scientific
- Spiritual, Economic, Discovery, Stability
Progression System
- Join faction → Gain reputation from quests
- Reputation unlocks perks (at 0.2, 0.4, 0.6, 0.8, 1.0)
- Faction-specific quests become available
- Factions compete for player loyalty
4. Technology Tree
Research progression. Unlock new capabilities through technology advancement.
Research Philosophies
4 Paths
Research Philosophies
- Scientific: Pure research and innovation
- Cultural: Prosperity, unity, influence
- Military: Defense, power, dominance
- Consciousness: Enlightenment, transcendence, harmony
Registered Core Technologies
- Faster Engines (Sci, Cost 50) — Increase movement speed
- Diplomatic Protocol (Cul, Cost 75) — Improve faction relations
- Shield Technology (Mil, Cost 100) — Deploy protective shields
- Consciousness Interface (Cons, Cost 200) — Interface with collective consciousness
Tier Progression
- Tier 1 (Foundation) → Tier 2 (Classical) → Tier 3 (Medieval)
- Tier 4 (Industrial) → Tier 5 (Modern/Future) → Transcendent unlocks
5. NPC System
Character universe. Recruit companions, interact with rivals, build relationships.
Personality Traits
5 Dimensions
Registered Characters
- Captain Zara (Explorer) — Leads expeditions into the unknown
- Ambassador Chen (Diplomat) — Negotiates peace treaties
- Dr. Vel'Kaith (Scientist) — Conducts frontier research
Personality System
Each character has 5 traits (0.0 - 1.0 scale):
- Loyalty: Faithful vs. self-interested
- Ambition: Power-seeking vs. content
- Wisdom: Thoughtful vs. reactive
- Charisma: Charming vs. isolated
- Cunning: Strategic vs. straightforward
NPC Types (Planned)
- Historical figures, Faction leaders, Companions
- Antagonists, Mysterious characters, Unique archetypes
- Recruitable companions with gameplay bonuses
- Mythic creatures (8 creature types)
System Interactions
Turn Cycle Flow
1. Console executes turn
2. Event triggered (25% probability)
3. Player makes choice (4 options)
4. Consciousness updated
5. Quests check completion
6. Factions update reputation
7. Tech tree checks unlocks
8. NPCs react to changes
Example Interaction Chain
Event: "Revolutionary Technology Breakthrough"
→ Console: Consciousness changes (morale +0.2)
→ Quests: "Research Ancient Tech" progresses 20%
→ Factions: Science Consortium +0.1 reputation
→ Tech: Faster Engines moves 50 points closer to unlock
→ NPCs: Dr. Vel'Kaith relationship increases 0.05
Development Status
Completed
- ✅ All 5 core systems implemented
- ✅ Integration layer working
- ✅ 10+ integration tests passing
- ✅ Autonomous 10-turn gameplay demonstrated
- ✅ Cross-system interactions verified
Next Phases
- Phase 2: Make the engine visible (logs, turn summaries, event cards)
- Phase 3: Interactive console (run turns, generate events, draw cards)
- Phase 4: Expand federation (add quests, factions, techs, NPCs)
For the complete codebase and latest updates, visit the GitHub repository.