feat: Add comprehensive Clash Royale gameplay analyzer (Stockfish for…

[justicehamilton35-hue]

… Clash Royale)

Implemented a complete gameplay analysis system that analyzes Clash Royale videos similar to how Stockfish analyzes chess games.

Core Features

Video Processing & Analysis

• Video frame extraction and processing (video_processor.py)
• Game state tracking with card, troop, tower, and elixir detection
• Real-time position evaluation (-10 to +10 scale)
• Win probability calculation throughout the game

Move Analysis Engine

• Advanced position evaluator with multiple metrics:

  • Material advantage (troops on board)
  • Board control and territory
  • Elixir efficiency
  • Tower health differential
  • Troop positioning quality
  • Offensive pressure and defense ratings

• Move classification system:

  • Brilliant (!!!) - Exceptional, game-winning moves
  • Great (!!) - Very strong moves
  • Good (!) - Solid plays
  • Book - Standard moves
  • Inaccuracy (?!) - Minor mistakes
  • Mistake (?) - Clear errors
  • Blunder (??) - Severe mistakes

Playstyle Analysis

• Automatic playstyle detection:
  • Beatdown (heavy pushes)
  • Cycle (fast card rotation)
  • Control (defensive focus)
  • Bridge Spam (constant aggression)
  • Balanced (mixed strategy)
• Aggression, defense, and efficiency ratings (0-10)

Backend API

• FastAPI server with REST endpoints
• Video upload and processing
• Background analysis with progress tracking
• Job management and result retrieval
• Download endpoints for analysis reports

Frontend Web Interface

• Next.js 14 with TypeScript
• Chess.com-inspired UI layout
• Interactive evaluation graph with timeline
• Win probability chart
• Move-by-move list with explanations
• Analysis summary dashboard
• Key moments highlighting
• Real-time progress tracking

File Structure

analyzer/
├── backend/api/main.py # FastAPI server
├── engine/
│ ├── analyzer.py # Main orchestrator
│ ├── game_state_tracker.py # State detection
│ ├── evaluation/
│ │ └── position_evaluator.py # Position evaluation engine
│ └── analysis/
│ └── move_analyzer.py # Move analysis and insights
├── frontend/ # React/Next.js interface
│ ├── src/app/ # Pages
│ ├── src/components/ # React components
│ └── src/lib/api.ts # API client
└── utils/
└── video_processor.py # Video processing

Documentation

• ANALYZER_QUICKSTART.md: 5-minute setup guide
• ANALYZER_SETUP.md: Complete setup and configuration
• analyzer/README.md: Architecture overview

Key Improvements

1. Comprehensive analysis similar to chess engines
2. Beautiful web interface for easy access
3. Detailed move explanations and suggestions
4. Playstyle insights and recommendations
5. Exportable analysis reports
6. Real-time progress tracking
7. Fully async API with background processing

Technology Stack

• Python: FastAPI, OpenCV, PyTorch
• Frontend: Next.js, TypeScript, Tailwind CSS, Recharts
• ML: Roboflow for computer vision
• Video: OpenCV for frame processing

This transforms the project from a bot that plays the game to a comprehensive analysis tool that helps players understand and improve their gameplay.