Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

280 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ World Leaders Game

AI-First Educational Game Development: Father-Son Learning Experiment

๐ŸŒ Live Game ๐Ÿ“š Documentation

Status: Week 6 Retro Transformation โ€ข AI Autonomy: 85% โ€ข Target: 12-year-old learners


๐ŸŽฏ What We're Building

Educational strategy game where 12-year-olds learn geography, economics, and languages by progressing from peasant to world leader through:

  • ๐ŸŽฒ Dice-based career progression (Farmer โ†’ Politician โ†’ World Leader)
  • ๐ŸŒ Real-world territory acquisition using World Bank GDP data
  • ๐Ÿ—ฃ๏ธ Language learning with Azure Speech recognition
  • ๐Ÿค– AI tutoring agents providing safe, educational guidance

Current Focus: Retro 32-bit transformation inspired by our 12-year-old creative director's vision!


๐Ÿš€ Quick Start

# Clone and run the game
git clone https://github.com/victorsaly/WorldLeadersGame.git
cd WorldLeadersGame

# Start with .NET Aspire (recommended)
dotnet run --project src/WorldLeaders/WorldLeaders.AppHost

# Game available at:
# - Web: https://localhost:7154
# - API: https://localhost:7155
# - Dashboard: https://localhost:15888

Requirements: .NET 8 SDK, Docker Desktop


๐Ÿ—๏ธ Technology Stack

Layer Technology Purpose
Frontend Blazor Server + TailwindCSS Child-friendly retro UI
Backend .NET 8 + ASP.NET Core Stable educational API
Database PostgreSQL + Entity Framework Educational data storage
AI Azure OpenAI (GPT-4) Safe educational AI agents
Speech Azure Speech Services Language learning
Deploy .NET Aspire + Azure UK South Production orchestration

๐ŸŽจ Child-Led Design Revolution

Our 12-year-old creative director transformed this from modern UI to retro 32-bit pixel art:

"Dad, this should look like those old games with pixel art and have a green background theme!"

Week 6 Transformation Includes:

  • ๐ŸŽจ 32-bit pixel art aesthetic with green theme
  • ๐Ÿ‘ค Character personas replacing text usernames
  • ๐Ÿ—บ๏ธ Interactive world map with pixel art countries
  • ๐Ÿ“ฑ Mobile-first retro UI optimized for tablets

๐Ÿค– AI Collaboration Stats

AI System Role Autonomy
Claude Sonnet 3.5 Architecture & content 85%
GitHub Copilot Real-time coding 90%
Azure OpenAI Educational AI agents 85%

Human Oversight (15%): Creative vision, safety validation, educational alignment


๐Ÿ“š Documentation & Learning

Section Focus Link
๐Ÿ  Home Project overview Visit โ†’
๐Ÿ“… Journey Week-by-week AI collaboration Follow โ†’
๐Ÿ”ง Technical Implementation guides Learn โ†’
๐Ÿ“ Blog Educational insights Read โ†’
๐Ÿ† Stats Real-time progress metrics Track โ†’

๐Ÿ›ก๏ธ Child Safety Framework

  • ๐Ÿ”’ Multi-layer content moderation (Azure + custom validators)
  • ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ COPPA/GDPR compliance for child data protection
  • โฑ๏ธ Child-specific session timeouts (30 minutes)
  • ๐Ÿ›ก๏ธ Safe AI fallbacks for any inappropriate content
  • ๐Ÿ‡ฌ๐Ÿ‡ง UK data residency with educational compliance

๐ŸŒŸ Why This Matters

Revolutionary AI-First Development: This project demonstrates:

  • ๐Ÿค– 95% AI autonomy in software development
  • ๐Ÿ‘ถ Child-centered design with authentic user feedback
  • ๐Ÿ“š Complete methodology documentation for replication
  • ๐ŸŽ“ Educational technology innovation with real learning outcomes

Perfect for: Educators, parents, AI researchers, and developers interested in human-AI collaboration in educational technology.


๐Ÿš€ Commands & Scripts

All automation scripts are in /scripts/ directory:

# Development
./scripts/start-game.sh                               # Start local game
./scripts/validate-documentation-completeness.sh     # Validate docs

# Deployment
./scripts/fast-deploy.sh                             # Deploy to production
./scripts/restart-production.sh                     # Restart services

# Content
./scripts/generate-blog-image.sh                    # AI blog images

๐Ÿ“– Complete Command Reference โ†’


๐Ÿค Connect & Contribute

GitHub Stars GitHub Forks GitHub Issues

โญ Star this repository to support our AI-first educational development journey!

Educational Use Welcome: Adapt our methodology for your own parent-child learning projects or educational technology development.

๐ŸŒ Start Exploring: worldleadersgame.co.uk โ†’


Built with โค๏ธ by father-son team + AI collaboration

๐Ÿ“– MIT License โ€ข ๐ŸŽ“ Educational Focus โ€ข ๐ŸŒ 12-year-old Creative Director

About

๐ŸŽฎ Educational strategy game for 12-year-olds built with AI assistance. Progress from peasant to world leader using real GDP data, AI tutors, and speech recognition. .NET 8 + Blazor Server + Azure OpenAI. 95% AI-generated code following comprehensive Copilot instructions.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages