Web Mario — SS Assignment 02

Play here: https://mario-112000203.web.app

---

Scoring

Basic Components

Item	Score	Check
Complete Game Process (Start Menu / Level Select / Game View / Game Over)	5%	Y
World Map — correct physics, camera follows player, at least 1 map	10%	Y
Level Design — static walls + question blocks	5%	Y
Player — physics, keyboard control, hurt by enemies, out-of-bounds death, respawn	15%	Y
Enemies — correct physics, at least 1 type, stomp-only kill	15%	Y
Question Blocks — super mushroom (Mario grows bigger), block interaction	5%	Y
Animations — player walk & jump (5%), Goomba walk (2%), Piranha Plant (2%)	9%	Y
Sound Effects — BGM (2%), jump & die (3%), additional: coin / stomp / power-up / power-down / click (5%)	10%	Y
UI — player lives (3%), score (5%), timer (2%)	10%	Y
Appearance (subjective)	10%	Y
Git — regular commits	5%	Y

Bonus Components

Item	Score	Check
Firebase deployment + Membership (sign up / log in / save best score)	5%	Y
Leaderboard (in-game Pause panel + Game Over screen)	5%	Y

---

Features

• 2 Stages — World 1 and World 2; Stage 2 unlocks only after clearing Stage 1
• Membership system — register / login via Firebase Auth; only the personal best score is saved (lower scores do not overwrite)
• Guest mode — play without registering; scores are not saved to the leaderboard
• Leaderboard — all scores ranked by best, scrollable list; accessible from Pause panel (ESC) and Game Over screen; current user's row marked with ★
• Pause system — press ESC to pause / resume; shows Continue / Quit / Leaderboard options
• Win / Lose distinction — WIN (green) or OVER (red) shown on Game Over screen with different BGM for each
• Score popups — floating +points appear above coins, enemies, mushrooms, and the flag
• Time bonus — remaining time is converted to bonus score when clearing a stage
• Super Mushroom — Mario grows bigger when collected; shrinks (not dies) on first enemy hit while big
• Invincibility frames — Mario flashes (opacity alternates) for 2 seconds after taking damage, during which he cannot take further damage; implemented via update() to avoid schedule overlap bugs
• Enemies — Goomba (walks, stomped to kill) + Piranha Plant (attacks from pipe, bite animation)
• Username display — current user's name shown in the top UI bar; shows "Guest" for guest players
• Input validation — username rules enforced on sign up; login / sign up forms clear on switch

---

How to Use

Controls

Key	Action
← / → (Arrow Keys)	Move left / right
Space / ↑	Jump
ESC	Pause / Resume

Game Flow

1. Open https://mario-112000203.web.app
2. Log In / Sign Up with email & password — or play as Guest
3. Select Stage 1 or Stage 2 (Stage 2 requires clearing Stage 1 first)
4. Collect coins, stomp enemies, hit question blocks for mushrooms
5. Reach the flag at the end to clear the stage
6. If all lives are lost → Game Over screen with leaderboard

Sign Up Rules

• Username: 3–12 characters, letters / numbers / underscore only
• Password: minimum 6 characters