Skip to content

ychoi-kr/vibefps

Repository files navigation

VibeFPS - 3D Web-based FPS Game

Play Now

VibeFPS is a web-based FPS game where you shoot various targets in a 3D environment. With over 80% of code written by AI, this game features combo systems, procedural audio, and an advanced spatial sound system.

VibeFPS Screenshot

🎮 Play Now

Play VibeFPS directly in your browser (desktop and mobile supported)

✨ Features

  • Target Variety: Standard targets (10pts), bonus targets (25pts), and penalty targets (-15pts)
  • Combo System: Build up consecutive hits for 1.5x, 2x, and 3x score multipliers
  • Penetration Shots: Hit multiple targets with a single bullet for bonus points
  • Procedural Audio: Dynamic sound generation using Web Audio API
  • Spatial Sound: Realistic audio reverb based on wall distance and player direction
  • Mobile Support: Optimized controls for both desktop and mobile play
  • Multilingual: Korean and English language support
  • Easter Egg: Find the hidden GitHub target to discover the source code

🎯 How to Play

Desktop Controls

  • WASD: Move
  • Mouse: Aim
  • Click: Shoot
  • R: Reload
  • Space: Jump

Mobile Controls

  • Left Joystick: Move
  • Right Side: Swipe to aim
  • Shoot Button: Fire weapon

🛠️ Technology Stack

  • 3D Rendering: Three.js
  • Physics Engine: Cannon.js
  • Audio: Web Audio API (procedural sound generation)
  • Frontend: HTML5, CSS3, JavaScript

📚 Development with AI

This game was developed with the challenge that at least 80% of the code must be written by AI. The entire development process is documented in the book "Vibe Coding: FPS Game Development Journey" (in Korean).

The development process explored:

  • Working with multiple AI models (Claude, ChatGPT, Gemini)
  • Iterative refinement of AI-generated code
  • Solving unique challenges in browser-based games
  • Creating immersive gameplay and audio experiences

📖 Development Background

This project was created as an exploration of AI-assisted game development, with the following goals:

  • Create a fully playable web-based FPS game
  • Ensure at least 80% of code is AI-generated
  • Implement instant play without loading screens
  • Support both desktop and mobile devices
  • Make the game free to play without signup requirements

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👏 Acknowledgments

  • Three.js - JavaScript 3D library
  • Cannon.js - Physics engine
  • Claude, ChatGPT, and other AI assistants that contributed to code generation

🎮 VibeFPS