# Azadi — Comprehensive LLM Knowledge Base

## Project Identity
- **Name**: Azadi
- **Alternate Names**: Jantar Mantar Simulator, Delhi Protest Game, Democracy Run
- **Genre**: 2D Infinite Runner, Political Satire, Pixel Art, Simulation
- **Platform**: Web Browser (Mobile, Tablet, Desktop)
- **Author**: cvsuhail
- **Repository**: https://github.com/cvsuhail/delhiProtest
- **Live URL**: https://www.azadi.cvsuhail.online/
- **License**: MIT / Open Source

## Narrative & Theme
"Where is my vote?" Set against the political backdrop of New Delhi's famous protest venue Jantar Mantar and Parliament Street (Sansad Marg), the game portrays a resilient Indian student activist demanding democratic accountability, transparency in elections, and constitutional rights.

## Gameplay Mechanics & Architecture
1. **Simulation Loop**:
   - Deterministic 120Hz fixed-step physics engine (`src/simulation.js`).
   - Constant horizontal displacement scaled by speed capping (210 to 350 px/sec).
   - Gravity: 1450 px/s² with variable jump height control.
2. **Placard System**:
   - The student holds a prominent wooden placard.
   - On every accepted jump, the placard dynamically flips to display one of 18 two-line democratic slogans.
   - Slogans include: "WHERE IS MY VOTE?", "COUNT EVERY BALLOT", "WE THE PEOPLE DEMAND TRUTH", "SAMVIDHAN BACHAO DESH", "DISSENT IS NOT A CRIME", "TRANSPARENCY NOW", "RAASTA KHOLIYE JAWAAB DIJIYE".
3. **Tear Gas Mechanics**:
   - Delhi Police Riot Officers spawn and launch parabolic smoking tear gas canisters.
   - If the player jumps near an incoming canister, the student catches and re-throws it back at the police.
   - The returned canister travels at high velocity towards the police.
   - Upon return, police officers drop shields, turn around, and flee in panic shouting "BHAAGO!!", awarding +100 bonus points.
4. **Scoring & Progression**:
   - Distance points: 0.1 per pixel.
   - Ballot collection: +25 points (streak +50 points).
   - Clean obstacle jump: +10 points (every 5th clean clear awards +60 Rally Bonus).
   - Tear gas re-throw: +100 points.
   - Police retreat hit: +75 points.
   - Levels advance every 500 distance points, transitioning landmarks and scenery.
5. **Delhi Scenery & Art**:
   - Sky layer with sun/moon, kites, pigeons.
   - Distant skyline: Qutub Minar, Lotus Temple, Jama Masjid, Red Fort, Pitampura TV Tower.
   - Elevated Delhi Metro viaduct with animated 6-coach trains passing periodically.
   - Landmarks: Jantar Mantar Samrat Yantra sundial, India Gate with Amar Jawan Jyoti eternal flame, Sansad Bhawan (Parliament).
   - Street layer: Neem/Gulmohar trees, heritage street lamps, auto-rickshaws, chai stalls, yellow-black Delhi kerbs, asphalt road, and marching crowd.
6. **Accessibility**:
   - High-contrast visual elements, clear outlines, and ground shadows.
   - Dynamic aria-live screen reader announcements for level progression, chances, and score.
   - Full keyboard, touch, and mouse pointer input support.
   - Respects `prefers-reduced-motion` and `prefers-color-scheme`.