NEIGHBOR WARS 🧨🏡

🏠 THE PREMISE

Two neighbors. 🧍‍♂️ Two houses. 🏡 Zero property-line respect. 🚫 Take turns launching projectiles 🚀 across a procedurally generated suburban battlefield 🌳 — adjust angle 📐 and power ⚡, account for shifting winds 💨, and reduce the enemy's home to rubble 🧱 before they flatten yours!

⚔️ GAME MODES

• 🔥 Player vs Player — Hot-seat local multiplayer 🎮
• 🤖 Player vs CPU — Adaptive AI that scales to your skill 🧠 (or feigns incompetence to keep it tense 😅)
• 🍿 CPU vs CPU — Watch the chaos unfold as a screensaver or strategy study 📺

🎯 CORE FEATURES

• 🌍 Fully Destructible World: Every blast carves real craters 🕳️ into the terrain. Explosions can sever water-tower legs 💧, topple hills ⛰️, and leave floating chunks that fall under gravity and re-bake into the landscape 🧩 — permanently altering the battlefield.
• 🎬 Dramatic "Peggle-Style" Camera: When a shot bears down on a house, the camera punches in with smooth slow-motion 🐌 and a drumroll build-up 🥁. You feel the tension as the missile creeps toward impact — hit or miss, it's cinematic. 🍿
• 😡 Living, Breathing Neighbors: Stick-figure residents aren't decorations. They run inside when you fire 🏃‍♂️, scramble out to curse when their lawn burns 🤬, dodge incoming missiles in panic 🤸‍♂️, and traverse the ruined terrain — climbing cliffs 🧗, rappelling down canyons 🪢, and building bridges 🌉 to retrieve UFO scrap.
• 🛸 UFO Tech Upgrades: Rare flying saucers streak across the sky 🌌. Shoot one down 💥, and its wreckage crashes as salvage ⚙️. The first neighbor to reach it claims a 4× damage multiplier ☢️ for the rest of the match. High-risk, high-reward! 🏆
• 🌤️ Dynamic Wind & Time of Day:
• Variable wind drifts and gusts in real time 🍃 — time your shot to a favorable breeze.
• System-clock synced day/night/twilight with gorgeous gradient skies 🌅🌃, or lock to Day/Night/Random. ⏱️
• Clouds ☁️, birds 🦅, and celestial bodies 🌙 all respond to the hour.
• ✈️ Living Sky Traffic: Biplanes (towing "SPACECHAKRA" banners) 🛩️, commercial jets 🛫, hot-air balloons 🎈, blimps 🌭, drones 🚁, and the elusive UFO 🛸 — each with distinct physics, hitboxes, and destruction sequences 💥.

• 🔥 Persistent Fire & Crater Embers: Near-misses ignite houses with flickering flames 🔥 and rising smoke 💨. Craters burn for seconds after impact, leaving the battlefield smoldering between turns. 🌋
• 🏚️ House Physics: Houses lean when one side loses ground support 📉. Undermine a foundation enough and the whole structure falls — squashing, stretching, and kicking up dust on landing 🌪️ — before settling at a permanent tilt.
• 🧠 Adaptive CPU Intelligence: The AI solves ballistic trajectories in real time 🧮, but its intent adapts: dominating players face surgical strikes 🎯; struggling players get nail-biting near-misses 😅. It even leads moving UFOs! 👽
• 🪙 Coin Toss Ceremony: A fully animated 3D coin flip (Heads/Tails) decides who fires first 🥇 — complete with physics-based spin 🌀, mid-air suspension ⏳, and dramatic settle.

🎮 CONTROLS & ACCESSIBILITY

• 🖱️ Mouse drag aiming — pull back from your house to set trajectory 🏹 (pointer-lock for precision 🎯).
• ⌨️ Direct input — type values 🔢, mouse-wheel nudge 🖲️, or click-drag scrub the HUD sliders 🎚️.
• ⬆️ Keyboard — Arrow Up/Down nudges your last-adjusted value; Enter fires 🧨.
• ⏱️ Turn timer — configurable (5/10/15/30 sec or off) with audio tick warnings ⏰.

🎨 AUDIO-VISUAL POLISH

• 👾 Retro pixel aesthetic with modern shaders ✨: screen shake 🫨, additive explosions 💥, layered gradients 🌅.
• 🎵 Classic soundtrack — Mussorgsky's "Night on Bald Mountain" 🎻 (looped, atmospheric 🦇).
• 🔊 Per-action sound design — distinct launch tones per player 🎛️, 4 explosion variants 💣, UI clicks 🖱️, coin flip/drop 🪙, timer ticks ⏳, destruction crunches 🏚️.
• 💬 Speech bubbles — neighbors shout contextual curses ("MY PETUNIAS!" 🌸, "YOU FIEND!" 👿, "OFF MY LAWN!" 🌾) with varied frustration animations (waving 👋, jumping 🦘, fist-pounding ✊).

📊 PROGRESSION & REPLAYABILITY

• 💾 Persistent battle records (localStorage): total wars ⚔️, wins per side 🏆, total ammo expended 🪖.
• 📏 Configurable blast radius (10–200 px) — from surgical strikes 🎯 to map-wipers ☢️.
• 🎲 Starting turn selection — Coin toss 🪙, P1 first 🔵, or P2 first 🔴.
• 🔁 CPU vs CPU background battles run on the main menu — watch infinite wars while you browse options 🍿.

💾 TECHNICAL DETAILS

• 🌐 Platform: Browser (HTML5/Canvas) — play instantly, no install 🚀.
• 🖥️ Resolution: 1920×1080 internal 📺, responsive down to mobile 📱.
• 🕹️ Input: Mouse 🖱️, keyboard ⌨️, touch-friendly HUD inputs 👆.
• 📁 Save: Automatic localStorage for stats 📈.
• ⚡ Performance: 60 FPS target 🏎️, optimized offscreen canvases 🖼️, sub-stepped physics ⚙️.