English | 日本語

A fast-paced, single-player 3D zombie survival FPS running natively in modern web browsers with zero external asset downloads.
🤖 Built with ChatGPT Plus (GPT-6 Astra) and Antigravity 2.0.
🎮 Play Online: https://astrafloor.berochlu.workers.dev/

• Overview
• Key Features
• Basic Gameplay & Controls
• Essential Survival Tactics
• Weapon Arsenal
• Difficulty Modes
• Setup & Development
• Detailed Specifications
• Credits & AI Development

Astra Floor is a single-player 3D zombie survival first-person shooter designed specifically for PC keyboard and mouse.
Set in an apocalyptic quarantined industrial complex, players must eliminate unrelenting waves of anomalous mutants known as "Zods". Clear each wave, earn credits (₡), and upgrade your firearms, armor, and gear in the supply shop between rounds. Survive Waves 1 through 6, then defeat the Final Boss in Wave 7 to win. You lose when your HP reaches zero.

Note: There is no save feature. Reloading the page, retrying, or returning to the title resets run progression.

• Pure Browser-Native 3D FPS
  Runs smoothly inside modern web browsers via Three.js and React 19 / vinext without installing client binaries, plugins, or extensions.
• 100% In-Memory Procedural Assets
  Weapon models, environmental architecture, mutant body geometry, and 128–256px PBR texture sets (albedo, normal, roughness) are synthesized dynamically in memory at startup. No external 3D asset downloads.
• Pure Web Audio API Sound Synthesis
  Every sound effect—explosive gunshots, crisp sniper bolt mechanisms, rocket thrusters and detonations, bullet impacts, ricochets, monster growls, and the final boss's mechanical voice—is synthesized in real-time using Web Audio oscillators, noise buffers, biquad filters, and master dynamic compressors.
• Authentic FPS Recoil & Gunplay
  Every shot produces strong recoil. Players must pull the mouse down to compensate. Headshots with any firearm or a direct rocket strike deal devastating damage.

Controls use a simple, familiar PC FPS layout to help newcomers get comfortable with keyboard input.

Headshots deal 3× normal damage. Aim for enemy heads with bullets or direct RPG-7 rocket strikes to take them down more efficiently.

1. Combat Waves: Eliminate all active Zods to clear the wave.
2. Automatic Health Restoration: Clearing a wave restores player HP to 100. Armor, ammunition, and consumables are not restored automatically.
3. Preparation Shop:
   • Earn credits (₡) from enemy kills and wave completion bonuses.
   • The shop has no timer. Purchase weapons, weapon upgrades, ammunition refills, armor reinforcement, Medical Kits, and grenades.
   • All equipment, upgrades, credits, and remaining supplies carry over to subsequent waves.
   • When ready, press NEXT WAVE (or FACE FINAL BOSS before Wave 7) to deploy.

• Strafe-Shooting & Katana Breakouts
  Strafe-shooting while staying mobile and slashing through swarms with the Katana (V key, once purchased from the shop) are essential techniques to escape zombie encirclements.
• Evade Charges with Sprinting
  If enemies surround you or charge, keep moving and sprint (Left Shift) to slip away.
• Precision Recoil Control & Headshots
  Actively aim for headshots. Manually pull down your mouse during sustained fire to suppress muzzle climb.
• Line Up Penetration Shots with the SR-3
  The SR-3 Sniper Rifle penetrates up to 3 targets. Line up headshots to take down troublesome or clustered enemies simultaneously.
• Use Grenades & Medical Kits Generously
  Frag Grenades (G) and Medical Kits (Q) can be cheaply restocked in the shop, so do not hesitate to use them before turning into a critical situation.
• Watch Out for Colossal Enemies
  The colossal enemies appearing in Waves 5–6 will enrage and charge after a short time. Quickly take cover behind obstacles or prioritize headshots from long range to bring them down as fast as possible.

Both difficulties initialize with full HP, full Armor, full ammunition, and full grenades.

• Node.js: >= 22.13.0
• Package Manager: npm

# Clone the repository
git clone https://github.com/username/astrafloor.git
cd astrafloor

# Install dependencies
npm install

# Start local development server
npm run dev

Open http://localhost:3000 in your browser. Click the screen to lock the pointer and begin.

Run the full automated test suite (140 unit tests):

npm test

# TypeScript type check
npx tsc --noEmit

# Build production bundle (Cloudflare Worker, SSR, RSC, client assets)
npm run build

For in-depth mathematical formulas, weapon ballistics, enemy HP/damage profiles, and boss combat phases, consult the reference specifications:

• Developer Reference & Detailed Specs: English | 日本語

Astra Floor was created and implemented with ChatGPT Plus (GPT-6 Astra) and Antigravity 2.0.

This project is licensed under the MIT License.