🎮 doom-on-github-issues

Play Doom using nothing but GitHub Issues.
One issue = one game session · One comment = one game tick

---

🚀 Overview

Blogpost on how i ran: https://blogs.shubhamz.dev/systems/how-i-ran-doom-on-github-issues

The active implementation lives in issues-game-bot/.

This repository is an open-source experiment that turns GitHub Issues into a multiplayer Doom interface.

Each GitHub Issue represents a persistent game session:

• 🎮 1 Issue = 1 Doom Session
• 💬 1 Comment = 1 Action Tick
• 🖼️ Issue Body = Live Rendered Frame

---

🏗️ Architecture (V4)

---

📂 Repository Structure

issues-game-bot/      → Main game implementation
documentation/        → Architecture & release documentation

---

🤝 Contributing

See CONTRIBUTING.md for:

• Local setup
• Development workflow
• Contribution guidelines
• Required checks

---

📦 Current Release

v4.0.0

Persistence & Latency Release

Version 4 introduces:

• ⚡ Persistent DoomGeneric worker
• 🖼️ Cached startup & menu frames
• ☁️ Deterministic S3 frame delivery
• 📥 Batched GitHub comment commands
• 🎮 GitHub Issues remain the only game interface

For the full breakdown, see:

• CHANGELOG.md
• documentation/v4-release-notes/