Add Quantum Breakout - a quantum game that teaches qubits by playing (Closes #54)

[ashmitjsg]

Closes #54

Program a quantum game - Quantum Breakout

This PR adds a new game tutorial directory, QuantumBreakout/, mirroring the existing QuantumPoker/ format (tutorial README.md + images/).

Quantum Breakout is a quantum re-imagining of Atari's Breakout: your paddle is a 3-qubit register (8 positions), and you steer it by building a quantum circuit with gates. It teaches superposition, measurement/collapse, the X gate, phase & interference, and entanglement - each concept taught in-game on a board before the matching level, then
practised by playing.

• ▶ Play in browser (no install): https://ashmitjsg.itch.io/quantum-breakout
• 🎥 Video demo: https://youtu.be/jnlsQTBWw98
• Game source: https://github.com/ashmitjsg/Quantum-Breakout
• Engine (open-sourced, on PyPI): https://github.com/ashmitjsg/Quantum-Circuit-Game-Engine, https://qcge.vercel.app/ · pip install qcge

More than one game - a reusable engine

The quantum logic lives in qcge (Quantum Circuit Game Engine (Website, PyPI)), a small open-source package I extracted. It lets anyone add quantum controls to a pygame game - or build a whole new quantum game - without writing any quantum program from scratch. You drop in the circuit-grid widget; players build and measure real circuits while the engine handles the backends (real Qiskit on desktop, a verified pure-Python statevector simulator in the
browser, since Qiskit can't run under WebAssembly).

So this PR isn't just one tutorial - it's a tool the community can reuse to make many more quantum learning games. A second game already runs on it:

• QuantaVania - a quantum platformer where you build real circuits to fight through each level. ▶ Play in browser: https://ashmitjsg.itch.io/quantavania · source: https://github.com/ashmitjsg/QuantaVania

Same engine, a very different game - which shows qcge generalizes well beyond Breakout.

What's included

• QuantumBreakout/README.md - the educational, step-by-step tutorial: what you learn, how to play, the quantum concept behind each level (with the math and the in-game effect), how the game is built (qcge engine, statevector → paddle probabilities, dual Qiskit/pure-Python backend), how to run it, dependencies explained, a "how I got started in quantum" note, and an AI-usage disclosure. Includes a clickable demo-video thumbnail.
• QuantumBreakout/images/ - a gameplay screenshot (hero image).

Bounty requirements checklist

• Educational tutorial teaching quantum concepts, with the math/results explained + references
• Playable game (browser via itch.io + desktop)
• Dependencies explained
• "How I got started in quantum" note
• AI-usage disclosure
• Video demo (https://youtu.be/jnlsQTBWw98)
• Source code open-sourced and credited (game + the reusable qcge engine)

AI-usage disclosure

The original Quantum Breakout and the first QCGE engine were written by hand in 2023, with no AI (a college tech-fest project). This 2026 v2 builds on that human-written foundation, and here I used an LLM as a collaborative tool - I directed the design and all quantum/game decisions, reviewed and tested every change, and ran each on both desktop and browser. All quantum behaviour is verified against Qiskit. Full disclosure is in the tutorial README.

[ashmitjsg]

Hi @lia-approves @MaldoAlberto, it was a great learning opportunity to participate and work on this during the UnitaryHack 2026. Although the bounty was granted to another amazing PR, I still wish to add this game built using QCGE to your platform, so that developers know about QCGE and build their own quantum games using it. I wanted to ask if there are any chances or any other upcoming bounty/hackathon events that you participate/organize under which I can add this game to your platform?