===========================================
  EARTH RECYCLER – ECO GAMES PLATFORM
===========================================

HOW TO USE
----------

1. PARTICIPANT PORTAL
   Open: participant/index.html
   - Players scan QR code or open this file
   - Register with Name, Organisation, Email, Phone
   - Choose from 4 eco games to play
   - One play per game enforced per participant
   - Live leaderboard shown after each game

2. ADMIN PORTAL
   Open: admin/index.html
   Password: earthrecycler2025
   - Live combined leaderboard
   - Game-wise breakdown & top scores
   - Full player registry
   - Export to CSV (leaderboard + players)
   - Reset all data button

GAMES INCLUDED
--------------
1. ♻️  EcoSort       – Waste drag-and-drop (60 sec, 38 items)
2. 🏃  EcoRunner     – Endless runner (collect recyclables, dodge pollution)
3. 🌍  EcoQuiz       – 10-question eco knowledge quiz with power-ups
4. 🌱  CarbonGuess   – Guess CO₂ footprint of 10 everyday activities

SCORING (Combined Leaderboard)
-------------------------------
- All 4 game scores are added for total
- Players who complete all 4 games ranked higher
- Admin leaderboard shows real-time combined rankings

TECH NOTES
----------
- Pure HTML/CSS/JS — no server needed
- Works offline after first load (Google Fonts cached)
- Data stored in browser localStorage (shared if same device/browser)
- For multi-device events: host on a local server or upload to any web host
- To host locally: use VS Code Live Server, Python http.server, or similar

HOSTING FOR EVENTS
------------------
Option 1 (Simple): Open files directly in browser
Option 2 (Network): python3 -m http.server 8080
  Then access via http://YOUR-IP:8080/participant/
  Admin at: http://YOUR-IP:8080/admin/
Option 3: Upload to GitHub Pages, Netlify, or any web host

QR CODE
-------
Generate a QR code pointing to your hosted participant/index.html URL
and display it at your event booth.

RESET DATA
----------
Admin panel has a "Reset All" button to clear all data between events.
===========================================