Skip to content

TheComplianceAide/stickdeath

Repository files navigation

💥 Stick Death 💥

A brutally satisfying, single-file, zero-dependency stick-figure shooter with hyper-realistic ragdoll physics.

This entire game exists in a single index.html file. It was generated by an AI from a highly detailed technical specification.


🕹️ Live Demo

You can play it right now! This repository is configured to be hosted on GitHub Pages.

➡️ PLAY STICK DEATH HERE ⬅️

(Note: If the link doesn't work, it might be because GitHub Pages hasn't been enabled for this repository yet. See "How to Run" below.)


🎬 Make it Viral!

A GIF is worth a thousand words. Record a short, epic gameplay clip and replace the placeholder below to show off the carnage!

(Hint: Replace this placeholder with a real gameplay GIF!)


What is This?

Stick Death is a minimalist arena shooter where the only thing that matters is the visceral, physics-based chaos of stick figures meeting their demise. Built from the ground up in a single HTML file with no libraries or dependencies, it's a testament to what's possible with pure JavaScript and a whole lot of math.

Blast through waves of enemies, watch them crumble with hilarious ragdoll physics, and trigger cinematic slow-mo on epic headshots.

✨ Features

  • Custom Ragdoll Physics: A from-scratch Position-Based Dynamics (Verlet) engine for maximum comedic effect. Limbs can even break and detach!
  • Cinematic Slow-Mo: Land a headshot and the world slows down, letting you savor the moment.
  • Adjustable Gore: From Off to Full, you control the level of particle-based carnage.
  • Multiple Weapons: Switch between a Pistol, an SMG, and a screen-shaking Shotgun.
  • Adaptive Performance: The game automatically adjusts effects and physics calculations to target a smooth 60 FPS on any device.
  • Desktop & Mobile Ready: Play with WASD/Mouse or use the on-screen twin-stick controls on your phone.
  • 100% Client-Side: No servers, no build steps, no internet required. It runs directly from the file:// protocol.

🎮 How to Play

Desktop

  • Move: A/D or ←/→
  • Aim: Mouse
  • Fire: Left Mouse Button
  • Dash: Shift
  • Pause: Space
  • Restart: R
  • Mute: M
  • Cycle Gore: G

Mobile

  • Move: Left virtual joystick
  • Aim/Fire: Right virtual joystick
  • Controls: On-screen buttons for Pause, Mute, and Restart.

🤖 The Genesis: An AI-Generated Game

This isn't just a game; it's an experiment. The entire project was generated by an AI agent from a single, incredibly detailed prompt file: buildthisgame.txt.

This file contains the full technical specification, from the physics engine implementation down to the audio synthesis parameters. It's an exploration of prompt engineering and AI-driven development, demonstrating how a clear and comprehensive spec can be translated directly into a fully functional product.

🛠️ Technical Deep Dive

For the developers in the room, here's what makes this project special:

  • Single File Architecture: All HTML, CSS, and JavaScript are contained within index.html.
  • Zero Dependencies: No frameworks, no libraries, no external assets. Just pure, vanilla web technologies.
  • Custom Physics Engine: A lightweight Position-Based Dynamics (Verlet) solver brings the ragdolls to life.
  • Procedural Audio: All sounds are synthesized on the fly using the Web Audio API. No .mp3 or .wav files needed.
  • Responsive & Adaptive: From the UI to the performance-tuning logic, it's designed to run well anywhere.

🚀 How to Run

It couldn't be simpler:

  1. Clone this repository: git clone https://github.com/TheComplianceAide/stickdeath.git
  2. Open the index.html file in your favorite web browser.

Host Your Own Live Demo with GitHub Pages

  1. Go to your repository's Settings tab.
  2. Navigate to the Pages section in the left sidebar.
  3. Under "Build and deployment", select Deploy from a branch.
  4. Choose the main branch and the / (root) folder, then click Save.
  5. Your game will be live at https://<your-username>.github.io/stickdeath/ in a few minutes!

About

HTML Game 'Stickdeath'

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages