https://github.com/thepriben/quantum-tetris

A Rust/Bevy/WASM experiment where Tetris gameplay decisions are driven by simulated quantum circuits.
https://github.com/thepriben/quantum-tetris

2026 bevy-engine preprint programmez-magazine quantum-computing quantum-game quantum-simulation rust-lang rustqip tetris tetris-game wasm webassembly

Last synced: 1 day ago
JSON representation

A Rust/Bevy/WASM experiment where Tetris gameplay decisions are driven by simulated quantum circuits.

Host: GitHub
URL: https://github.com/thepriben/quantum-tetris
Owner: thepriben
License: mit
Created: 2026-05-30T01:56:53.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2026-06-26T23:45:35.000Z (2 days ago)
Last Synced: 2026-06-27T01:21:28.806Z (2 days ago)
Topics: 2026, bevy-engine, preprint, programmez-magazine, quantum-computing, quantum-game, quantum-simulation, rust-lang, rustqip, tetris, tetris-game, wasm, webassembly
Language: Rust
Homepage: https://thepriben.github.io/quantum-tetris/
Size: 920 KB
Stars: 3
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.fr.md
- License: LICENSE

Awesome Lists containing this project

README

          # Quantum Tetris



  🇬🇧 English · 🇫🇷 Français





  ▶ Jouer en ligne





Tetris où les événements stochastiques (pièce, état d’apparition, cadence, bonus…) sont pilotés par des circuits quantiques mesurés en mode par défaut. Le joueur garde les commandes ← → ↑ ↓ et Espace ; le jeu tire le reste depuis les mesures.

> **Le joueur :** ← → ↑ ↓ et Espace · **Le jeu :** tout le reste.

**Exécution.** Bevy (Rust), en binaire desktop ou WASM dans le navigateur. Mode quantum par défaut : simulation statevector [**RustQIP**](https://github.com/Renmusxd/RustQIP), avec les mêmes circuits en local et en ligne.

---

## Publications & releases

Chaque release taguée fige un état reproductible du code.

| Publication | Release |

| --- | --- |

| **Article *Programmez!*** — Benoît Prieur, *« Quantum Tetris : Rust, Bevy, WebAssembly et circuits quantiques dans la boucle de jeu »*, hors-série n°23, 2026, pp. 7–11. [Lien](https://www.programmez.com/magazine/article/quantum-tetris-rust-bevy-webassembly-et-circuits-quantiques-dans-la-boucle-de-jeu) | [`programmez-hs23`](https://github.com/thepriben/quantum-tetris/releases/tag/programmez-hs23) |

| **Hasard auditable (C5/C6)** — reçus chaînés, journal de session commit-reveal, export à la game over. Voir [`docs/AUDIT.md`](docs/AUDIT.md). | [`preprint-randomness`](https://github.com/thepriben/quantum-tetris/releases/tag/preprint-randomness) |

**Reproduire une release**

```bash

git checkout programmez-hs23    # code de l'article *Programmez!*

git checkout preprint-randomness  # journal d'audit + pile C5/C6

```

---

## Hasard auditable

Chaque tirage stochastique en mode quantum par défaut est consigné dans un **journal d'audit chaîné par hash** (couches C5 et C6). En desktop, à la game over, la session est révélée et exportée vers `audit/{session_id}.json`.

| Étape | Commande / action |

| --- | --- |

| Jouer (desktop) | `cargo run -p quantum-tetris-game` — journal finalisé à la game over |

| Vérifier l'export | `./scripts/verify_audit.sh audit/qt-….json` |

| Lire la pile | [`docs/AUDIT.md`](docs/AUDIT.md) — contexte six couches, schéma JSON, chaîne de hash, tests |

| Biais de mapping (C4) | Pièce **T** à P=¼ sous tirages 3 bits uniformes (`010` et `111`) — [`docs/QUANTUM.md`](docs/QUANTUM.md) |

---

## Gameplay & circuits

À chaque moment stochastique, le moteur invoque un circuit de la liste partagée (voir [`docs/QUANTUM.md`](docs/QUANTUM.md)). Les diagrammes sont générés depuis les mêmes définitions de portes, recopiées dans [`scripts/render_circuit_diagrams.py`](scripts/render_circuit_diagrams.py).

### Tirage de la pièce

| | |

|---|---|

| **En jeu** | Détermine le tétromino en chute. |

| **Circuit** | `quantum-teleportation-gate-v1` — une mesure de Bell inspirée de la téléportation ; le résultat 3 bits choisit directement le tétromino actif. |



### Rotation & colonne

| | |

|---|---|

| **En jeu** | Fixe l’orientation à l’apparition et la colonne d’entrée. |

| **Circuit** | `imp-brain-v1` — 2 qubits mesurés → rotation (0–3) et colonne d'apparition. |



### Cadence de chute

| | |

|---|---|

| **En jeu** | Intervalle entre deux descentes ; diminue avec le niveau. |

| **Circuit** | `enemy-profile-hunter-v1` — 2 qubits mesurés → intervalle de chute pour la pièce en cours. |



### Espace — chute forcée

| | |

|---|---|

| **En jeu** | Pose immédiate ; bonus de score, parfois une ligne supplémentaire. |

| **Circuit** | `observation-pulse-v1` — mesure à la pose forcée ; les bits choisissent le bonus. |



### Ligne complétée

| | |

|---|---|

| **En jeu** | Multiplicateur de points ×1 à ×4 selon le tirage. |

| **Circuit** | `q-shard-stabilizer-v1` — après effacement d'une ligne ; les bits fixent le multiplicateur (×1–×4). |



---

## Démarrage rapide

**Desktop**

```bash

cp .env.example .env          # optionnel ; QUANTUM_MODE=quantum est le défaut

cargo run -p quantum-tetris

```

| Mode | Commande |

| --- | --- |

| Quantum — RustQIP (défaut) | `cargo run -p quantum-tetris` |

| Classique | `QUANTUM_MODE=classic cargo run -p quantum-tetris` |

**Navigateur** (nécessite ~3 Go d’espace libre pour le build WASM release)

```bash

cargo install wasm-bindgen-cli   # une fois

./scripts/build_wasm.sh

python3 -m http.server 8080 --directory docs

# → http://localhost:8080/

```

**Contrôles :** ← → déplacer · ↑ rotation · ↓ chute douce · **Espace** chute forcée + observe (`observation-pulse-v1`).

---

## Architecture

Le dépôt sépare le **moteur de jeu** (Bevy), la **couche quantique** (IR + backends) et **l’outillage** (rendu des diagrammes, build WASM, Pages).

```mermaid

flowchart TB

  subgraph clients["Clients"]

    DESK["Binaire desktop
cargo run"]

    WASM["Navigateur
docs/index.html"]

  end

  subgraph game["crates/game — Bevy 0.18"]

    APP["app.rs — TetrisPlugin"]

    TET["tetris.rs — boucle & spawn"]

    FX["measurement_fx.rs — bits → gameplay"]

    UI["ui.rs — grille + HUD + i18n"]

    CFG["config.rs — QuantumSession"]

  end

  subgraph quantum["crates/quantum — simulation"]

    IR["circuit.rs — QuantumCircuit + Gate"]

    BE["backends/ — Classic · RustQIP"]

  end

  DESK --> APP

  WASM --> APP

  APP --> TET

  TET --> FX

  TET --> CFG

  CFG --> BE

  BE --> IR

```

**Principe :** le jeu n’appelle que `QuantumBackend::run(circuit) → Measurement`, puis décode les bitstrings via `measurement_fx.rs`. Passer de Classic à RustQIP ne modifie jamais la logique Tetris.

### Pipeline au spawn

Trois mesures s’enchaînent avant chaque pièce :

```mermaid

sequenceDiagram

  participant T as tetris.rs

  participant Q as QuantumSession

  participant M as measurement_fx.rs

  T->>Q: piece_circuit() — tirage 3 bits inspiré de la téléportation

  Q-->>T: bits → pièce active

  T->>Q: rotation_circuit() — imp-brain-v1

  Q-->>M: rotation + colonne spawn

  T->>Q: speed_circuit() — hunter-profile-v1

  Q-->>M: intervalle de chute

  M-->>T: ActivePiece + HUD

```

### Backends

| Backend | Où | Mécanisme |

| --- | --- | --- |

| **Classic** | partout | `rand` uniforme — baseline sans simulateur |

| **RustQIP** | desktop + navigateur | simulateur statevector in-process |

- `QUANTUM_MODE=classic|quantum` (alias `QUANTUM_BACKEND`)

- Bascule **CLASSIQUE** / **RUSTQIP** in-game

---

## Arborescence

```

quantum-tetris/

├── crates/

│   ├── game/              # Bevy — binaire + cdylib WASM

│   └── quantum/           # IR circuits + backends + tests

├── docs/

│   ├── index.html         # Jeu + guide (anglais par défaut)

│   ├── circuits/*.png     # Diagrammes de circuits

│   ├── QUANTUM.md         # Référence circuits & mappings

│   ├── AUDIT.md           # Journal d'audit C5/C6 & vérification

│   └── WASM.md            # Notes build navigateur

├── scripts/

│   ├── build_wasm.sh

│   ├── clean_build.sh

│   └── render_circuit_diagrams.py

└── .github/workflows/

    ├── ci.yml

    └── pages.yml          # WASM + diagrammes → GitHub Pages

```

---

## CI / déploiement

| Workflow | Déclencheur | Actions |

| --- | --- | --- |

| **CI** | push / PR `main` | fmt, clippy, tests, check WASM |

| **Pages** | push `main` | Build WASM release, PNG circuits, deploy `docs/` |

En ligne : [thepriben.github.io/quantum-tetris/](https://thepriben.github.io/quantum-tetris/)

---

## Projets liés

- [**RustQIP**](https://github.com/Renmusxd/RustQIP) — le simulateur statevector `qip` qui alimente le backend quantique par défaut (`RustQipBackend`). Quantum Tetris en est une vitrine ludique, exécutée nativement comme dans le navigateur via WASM.

---

## Licence

MIT — [LICENSE](LICENSE)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/thepriben/quantum-tetris

Awesome Lists containing this project

README