Puck Arena is a fast-paced arcade air hockey game and lightweight 2D engine built with Python and pygame. Featuring real-time physics, smart AI, Supershot mechanics charged by skillful play, menus, audio system and state-based game flow. A playable game and a reusable engine foundation.

---

✨ Features

• 🖱️ Mouse-based controls (no WASD)
• 🤖 AI bot with difficulties: Easy / Normal / Expert
• ⚡ Supershot (ULT) mechanic
  • charges from:
    • strong hits
    • accurate shots
    • clutch deflections
  • one-time powerful boosted strike
• 🔊 Full audio system
  • intro splash sound
  • background soundtrack
  • score / victory / lose / click SFX
• 🎆 Confetti & spark effects
• ⏱️ FPS control
  • custom FPS input
  • default: 60 FPS
• 📊 Debug HUD (F3)
  • FPS
  • bot difficulty
  • supershot states (player & bot)
• ⏸️ Pause menu
  • difficulty
  • FPS cap
  • music volume
  • back to menu / exit
• 🧩 Main menu
  • Play
  • Settings
  • Instructions
  • Exit
• 🖼️ Splash screen with animated logo
• 🎨 Clean neon-style visuals

---

🧠 Controls

Action	Input
Move paddle	Mouse
Pause	Click pause icon
Toggle debug HUD	F3
Navigate menus	Mouse

---

🏆 Win Condition

• First player to reach 7 points wins
• After win:
  • countdown
  • confetti
  • automatic restart

---

⚙️ Requirements

• Python 3.10+
• pygame

👤 Author

maciejftw
Puck Arena v0.1-dev

---