{"id":31051016,"url":"https://github.com/chadbercea/docker-bug-squasher","last_synced_at":"2026-05-01T18:33:09.305Z","repository":{"id":309824145,"uuid":"1037665600","full_name":"chadbercea/docker-bug-squasher","owner":"chadbercea","description":"Retro PS1-style game where you squash Docker bugs! Race Conditions, Memory Leaks, and Zombie Processes await your debugging skills.","archived":false,"fork":false,"pushed_at":"2025-08-14T01:36:08.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T05:38:54.602Z","etag":null,"topics":["agent","arcade","containers","debugging","devops","docker","educational","game","javascript","lol","mcp","retro-gaming","three-js"],"latest_commit_sha":null,"homepage":"https://chadbercea.github.io/docker-bug-squasher/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chadbercea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-13T23:48:54.000Z","updated_at":"2025-08-14T01:36:11.000Z","dependencies_parsed_at":"2025-08-14T02:35:11.948Z","dependency_job_id":"e88dbfec-7905-4ed3-94d1-aa06552f741e","html_url":"https://github.com/chadbercea/docker-bug-squasher","commit_stats":null,"previous_names":["chadbercea/docker-bug-squasher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chadbercea/docker-bug-squasher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadbercea%2Fdocker-bug-squasher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadbercea%2Fdocker-bug-squasher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadbercea%2Fdocker-bug-squasher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadbercea%2Fdocker-bug-squasher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chadbercea","download_url":"https://codeload.github.com/chadbercea/docker-bug-squasher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadbercea%2Fdocker-bug-squasher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32508901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","arcade","containers","debugging","devops","docker","educational","game","javascript","lol","mcp","retro-gaming","three-js"],"created_at":"2025-09-14T23:44:30.411Z","updated_at":"2026-05-01T18:33:09.288Z","avatar_url":"https://github.com/chadbercea.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐳 Docker Bug Squasher - PS1 Arcade Edition\n\u003cimg width=\"1369\" height=\"924\" alt=\"Screenshot 2025-08-13 at 7 22 00 PM\" src=\"https://github.com/user-attachments/assets/602020db-bc8e-44ce-9fac-040290a1e107\" /\u003e\n\nA retro PS1-style 3D arcade game where you squash hilarious Docker pun-bugs! Experience the nostalgic charm of 90s gaming with authentic pixelated graphics, chunky polygon aesthetics, and satisfying bug-squashing gameplay.\n\n**Perfect for DevOps teams, Docker enthusiasts, and anyone who loves retro gaming!**\n\n## 🎮 Game Features\n\n- **🎯 PS1-Style Graphics**: Authentic retro 3D with pixelated textures and chunky polygons\n- **🐛 Docker Pun-Bugs**: Race Conditions, Memory Leaks, Zombie Processes, and more!\n- **🎮 Third-Person Gameplay**: Katamari Damacy-style camera with WASD movement\n- **🏆 Arcade Progression**: Complete objectives, earn high scores, unlock achievements\n- **💬 Interactive Elements**: Floating labels, event notifications, and visual feedback\n- **📊 High Score System**: Persistent leaderboards with arcade-style victory screens\n- **🎵 Retro Sound Effects**: Authentic 8-bit style audio feedback\n\n## 🐛 Docker Bugs to Squash\n\n### Simple Bugs (100 points each)\n- **🔴 Race Conditions**: Red containers racing in circles\n- **🔵 Memory Leaks**: Blue pipes dripping memory everywhere  \n- **🟣 Zombie Processes**: Purple shambling containers wandering aimlessly\n\n### Agent Bugs (300 points, need 3 agent spheres)\n- **🟡 Deadlocks**: Yellow containers frozen by literal padlocks\n- **🟢 Container Drift**: Green containers slowly floating away\n\n### MCP Bugs (500 points, need MCP component)\n- **🟠 Port Conflicts**: Orange cones shaking violently from harbor battles\n\n## 🚀 Quick Start - Multiple Options!\n\n### Option 1: Docker Container (🔥 Recommended - Very Meta!)\n\n**🎯 Super Simple One-Click Launch:**\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/docker-bug-squasher.git\ncd docker-bug-squasher\n\n# One-click start (handles everything automatically)\n./run.sh\n```\n\n**🐳 Docker Compose (Recommended):**\n```bash\n# Start the game\ndocker-compose up -d\n\n# Stop the game  \ndocker-compose down\n\n# View logs\ndocker-compose logs -f\n\n# Restart\ndocker-compose restart\n```\n\n**🔧 Manual Docker Commands:**\n```bash\n# Build and run\ndocker build -t docker-bug-squasher .\ndocker run -p 8080:80 --name docker-bug-squasher-game docker-bug-squasher\n\n# Stop\ndocker stop docker-bug-squasher-game\n\n# Remove\ndocker rm docker-bug-squasher-game\n```\n\n**Then open your browser to:** **http://localhost:8080**\n\n### Option 2: GitHub Pages (🌐 Free Hosting - Zero Setup!)\n\n**🎯 For Players:**\nJust visit the live game at: `https://yourusername.github.io/docker-bug-squasher/`\n\n**🔧 For Developers to Deploy:**\n1. **Push to GitHub:**\n```bash\ngit clone https://github.com/yourusername/docker-bug-squasher.git\ncd docker-bug-squasher\n# Make your changes\ngit add .\ngit commit -m \"Update Docker Bug Squasher\"\ngit push\n```\n\n2. **Enable GitHub Pages:**\n   - Go to your repo **Settings → Pages**\n   - Source: **Deploy from a branch**\n   - Branch: **main** \n   - Folder: **/ (root)**\n   - ✅ **Automatic deployment** via GitHub Actions!\n\n3. **Your game goes live automatically at:**\n   `https://yourusername.github.io/docker-bug-squasher/`\n\n### Option 3: Local Development Server\n\n**🔧 Any Web Server:**\n```bash\n# Python\ncd public \u0026\u0026 python -m http.server 8080\n\n# Node.js\ncd public \u0026\u0026 npx http-server -p 8080\n\n# PHP\ncd public \u0026\u0026 php -S localhost:8080\n\n# Then open http://localhost:8080\n```\n\n## 🎯 How to Play\n\n### 🎮 Controls\n- **WASD**: Move your blocky green avatar around\n- **Mouse**: Look around (click to lock cursor, reversed Y-axis like classic games)\n- **SPACEBAR**: Squash bugs and collect items (proximity-based interaction)\n- **ESC**: Release mouse cursor\n\n### 🏆 Objectives (Complete ALL to win!)\n1. **📦 Find and collect resources** - Gather agent spheres and MCP components\n2. **🐛 Squash simple bugs (100 pts)** - Easy bugs, no requirements needed\n3. **🔵 Collect 3 agent spheres** - Cyan glowing orbs scattered around the world\n4. **⚡ Squash agent bugs (300 pts)** - Use 3 agent spheres to tackle harder bugs\n5. **🔶 Find MCP components** - Orange cylinders from server stations  \n6. **💥 Squash MCP bugs (500 pts)** - High-value bugs needing MCP components\n7. **🎯 Achieve 2000+ points** - Rack up your score for the perfect run!\n\n### 🔄 Gameplay Loop\n1. **🏃 Explore** the retro 3D world with your third-person avatar\n2. **📦 Collect resources** by walking up to items and pressing spacebar\n3. **🔍 Hunt down bugs** using floating labels to identify them\n4. **⚖️ Strategic resource management** - save resources for high-value bugs\n5. **✅ Complete all objectives** to trigger the arcade victory sequence\n6. **🏆 Compete for high scores** and achieve \"Perfect Run\" status!\n\n## 🏅 Perfect Run Challenge\n\nAchieve **ALL** of these for the coveted \"Perfect Run\" status:\n- **🎯 3000+ points** (well above the 2000 requirement)\n- **🐛 15+ bugs squashed** (clean up the environment thoroughly)\n- **⏱️ Fast completion time** (efficient resource management)\n\nPerfect Runs are highlighted in **GOLD** on the leaderboard! 🏆\n\n## 🎨 The Authentic PS1 Experience\n\nThis game captures the genuine feel of 90s PlayStation games:\n\n### 🎮 Visual Authenticity\n- **📐 Chunky low-poly models** with flat-shaded surfaces\n- **🖼️ Pixelated textures** rendered with nearest-neighbor filtering  \n- **🎨 Limited color palettes** with retro dithering effects\n- **📉 Geometric instability** - vertices wobble like real PS1 hardware limitations\n- **🌫️ Fog-based draw distance** hiding the horizon like original hardware constraints\n- **⏱️ 30 FPS feel** with authentic timing and movement\n\n### 🎵 Audio Design\n- **🔊 8-bit sound effects** for interactions and events\n- **🎼 Victory melody** with classic arcade ascending notes\n- **💥 Satisfying audio feedback** for every bug squash\n\n## 🛠️ Technical Architecture\n\n### 🐳 Docker Implementation\n- **Base**: `nginx:alpine` (lightweight 30MB image)\n- **Web Server**: Optimized nginx with gzip compression\n- **Security**: Complete security headers and best practices\n- **Health Check**: Available at `/health` endpoint\n- **Performance**: Static asset caching and optimization\n\n### 🌐 Web Technologies\n- **Frontend**: Pure HTML5, CSS3, JavaScript (no frameworks!)\n- **3D Engine**: Three.js with WebGL rendering\n- **Storage**: localStorage for persistent high scores\n- **Responsive**: Works on desktop, tablet, and mobile\n- **Progressive Loading**: CDN fallbacks and error handling\n\n### 📁 Project Structure\n```\ndocker-bug-squasher/\n├── 📁 public/                    # Game files\n│   ├── index.html               # Main game interface\n│   └── game.js                  # Complete game logic (30KB)\n├── 🐳 Dockerfile                # Container definition\n├── ⚙️ docker-compose.yml         # Easy deployment config  \n├── 🌐 nginx.conf                # Optimized web server config\n├── 🚀 run.sh                    # One-click launcher script\n├── 📚 README.md                 # This comprehensive guide\n├── 🚫 .dockerignore             # Docker build optimization\n└── 📁 .github/workflows/        # GitHub Actions for auto-deployment\n    └── deploy.yml               # Automatic Pages deployment\n```\n\n## 🎭 Perfect for DevOps Teams\n\nThis game speaks directly to the DevOps experience with hilarious Docker metaphors:\n\n### 🐛 Real Issues as Game Enemies\n- **🏃‍♂️ Race Conditions** that literally race around in circles\n- **💧 Memory Leaks** as actual dripping pipes flooding your system\n- **🧟‍♂️ Zombie Processes** shambling around your infrastructure\n- **🔒 Deadlocks** as literal padlocks freezing your containers\n- **☁️ Container Drift** showing your infrastructure floating away from specifications\n- **⚔️ Port Conflicts** as harbors having boxing matches\n\n### 🎯 Team Building Benefits\n- **🤝 Team bonding** - compete for high scores during breaks\n- **🎪 Conference demos** - everyone loves retro gaming + Docker humor\n- **😌 Stress relief** - physically squash your deployment frustrations  \n- **📚 Education** - teach Docker concepts through interactive play\n- **🎉 Onboarding** - fun way to introduce new team members to Docker terminology\n\n## 💡 High Score Pro Tips\n\n### 🎯 Strategy Guide\n- **⚡ Prioritize simple bugs early** for quick points and momentum building\n- **🔵 Collect all 6 agent spheres** but use them strategically on high-value targets\n- **🔶 Save MCP components** for the highest-value Port Conflicts (500pts each)\n- **🏃‍♂️ Move efficiently** - bugs spawn every 6 seconds, so stay mobile\n- **🧠 Learn bug behaviors** - Race Conditions move predictably, Memory Leaks stay stationary\n- **⏰ Perfect timing** - wait for multiple high-value bugs before spending resources\n\n### 🎮 Advanced Techniques\n- **📍 Memorize collectible spawn locations** for faster resource gathering\n- **🔄 Plan efficient movement routes** to maximize bug encounters\n- **⚖️ Resource management** - never use 3 agents on a 300-point bug if 500-point bugs are available\n- **🎯 Combo scoring** - squash multiple bugs quickly for momentum\n\n## 🌐 Deployment Options Comparison\n\n| Method | Pros | Cons | Best For |\n|--------|------|------|----------|\n| **🐳 Docker** | Self-contained, runs anywhere, very meta! | Requires Docker installed | Developers, teams with Docker |\n| **📄 GitHub Pages** | Free hosting, no installation, instant access | Limited to static content | Sharing with anyone, demos |\n| **🖥️ Local Server** | Full control, offline capable | Manual setup required | Development, testing |\n\n## 🚀 Sharing Your Game\n\n### 🐳 Docker Hub Distribution\n```bash\n# Build and tag for Docker Hub\ndocker build -t yourusername/docker-bug-squasher .\ndocker push yourusername/docker-bug-squasher\n\n# Others can run instantly with:\ndocker run -p 8080:80 yourusername/docker-bug-squasher\n```\n\n### 🌐 Direct Web Access\nSimply share your GitHub Pages URL - no installation needed!\n`https://yourusername.github.io/docker-bug-squasher/`\n\n### 📱 Social Media Ready\nPerfect screenshots and GIFs for sharing:\n- Retro PS1 aesthetics are Instagram gold 📸\n- Bug squashing action is satisfying to watch 🎬\n- Docker puns are Twitter-ready content 🐦\n\n## 🔧 Development \u0026 Customization\n\n### 🎮 Modifying the Game\nWant to add your own Docker puns or change gameplay?\n\n1. **Edit game logic**: `public/game.js`\n2. **Modify UI/styling**: `public/index.html`\n3. **Add new bug types**: Search for `bugTypes` array in `game.js`\n4. **Adjust difficulty**: Modify spawn rates, point values, movement speeds\n\n### 🐳 Container Customization\n- **Custom nginx config**: Edit `nginx.conf`\n- **Different base image**: Modify `Dockerfile`\n- **Environment variables**: Add to `docker-compose.yml`\n\n## 🆘 Troubleshooting\n\n### Common Issues\n\n**❓ Black screen or game won't load:**\n- Check browser console (F12) for JavaScript errors\n- Ensure WebGL is supported in your browser\n- Try a different browser or disable browser extensions\n\n**❓ Docker container won't start:**\n```bash\n# Check if port 8080 is already in use\ndocker ps\nlsof -i :8080\n\n# Use different port\ndocker run -p 3000:80 docker-bug-squasher\n```\n\n**❓ GitHub Pages not updating:**\n- Check **Actions** tab for deployment status\n- Verify **Pages** settings point to correct branch\n- Wait up to 10 minutes for propagation\n\n**❓ Performance issues:**\n- Close other browser tabs\n- Check if hardware acceleration is enabled\n- Lower browser zoom level for better performance\n\n## 🎉 Community \u0026 Support\n\n### 🤝 Contributing\nWant to add features or fix bugs?\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n### 🐛 Reporting Issues\nFound a bug (not the fun Docker kind)? \n- Open an issue on GitHub with details\n- Include browser type, OS, and error messages\n- Screenshots or videos are super helpful!\n\n### 💬 Community\nShare your experiences:\n- **Twitter**: Tweet your high scores with #DockerBugSquasher\n- **LinkedIn**: Share with your DevOps network  \n- **Reddit**: r/docker, r/devops communities love this stuff\n- **Discord/Slack**: Perfect for team channels\n\n## 📈 Roadmap\n\nPlanned future features:\n- 🌟 **More bug types**: Stack Overflow towers, Build Failure construction sites\n- 🎵 **Background music**: Chiptune soundtrack\n- 🏆 **Achievements system**: Unlock titles and badges\n- 🌍 **Multiplayer mode**: Cooperative bug squashing\n- 📱 **Mobile optimization**: Touch controls for phones/tablets\n- 🎨 **Mod support**: Custom bug types and environments\n\n---\n\n## ⭐ Star This Repository!\n\nIf you enjoyed Docker Bug Squasher, please **⭐ star this repository** to help others discover it!\n\n**Built with ❤️ for the DevOps community**\n\n*May your containers never drift, your ports never conflict, and your processes never become zombies! 🐳✨*\n\n---\n\n### 🎮 Ready to Play?\n\n**Choose your deployment method above and start squashing those Docker bugs!**\n\n*Perfect for coffee breaks, team building, conference demos, and explaining Docker concepts in the most entertaining way possible.* 🎯\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadbercea%2Fdocker-bug-squasher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchadbercea%2Fdocker-bug-squasher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadbercea%2Fdocker-bug-squasher/lists"}