🎮 CandyTetris
Tetris on the SugarCraft stack
SugarCraft runtime, CandySprinkles for rounded borders + per-piece colours, deterministic 7-bag RNG, ghost piece, hard drop, hold, level-driven gravity ramp, NES-classic line-clear scoring. Full SRS wall-kicks via official Tetris Association tables, T-Spin detection via the 3-corner rule, Back-to-Back (1.5×) and combo bonuses, DAS/ARR keyboard timing (167/50 ms), and perfect-clear detection (+5000/level).
Install
composer require sugarcraft/candy-tetrisQuickstart
composer install
./bin/tetris
# Controls
# ← / → Move left / right
# ↑ / x Rotate clockwise
# z Rotate counter-cw
# ↓ Soft drop
# Space Hard drop
# p Pause / resume
# q QuitWhat's in the box
SRS rotationFull Super Rotation System — official Tetris Association kick tables for J/L/S/T/Z and I piece. Tries up to 5 offsets per rotation transition; the first that fits the board is used.
7-bag RNGDeterministic shuffle of the seven pieces; injectable RNG closure for reproducible tests.
Ghost pieceTranslucent preview at the hard-drop landing position.
Hard drop / holdSpace-bar drop; level-driven gravity speed-up at every 10 lines.
NES scoring1 → 40, 2 → 100, 3 → 300, 4 → 1200 — multiplied by (level + 1).
T-Spin (3-corner rule)Full T-Spin (400 × level+1) and T-Spin Mini (100 × level+1) via the official 3-corner detection: piece must have rotated and ≥2 diagonal corner cells must be filled (wall = filled).
Back-to-Back (B2B)1.5× multiplier on Tetris or full T-Spin clears when preceded by another B2B-eligible clear. Resets on 1–3 line clears or T-Spin Mini.
Combo counterConsecutive line clears add combo × 10 × (level+1) bonus points; resets to 0 on a zero-line lock.
Perfect clearClearing the full board awards +5000 × (level+1) bonus — documented via Board::isPerfectClear().
DAS / ARR timing167 ms DAS delay (time before auto-repeat begins) + 50 ms ARR interval (repeat rate). Gives precise single-tap and smooth continuous movement; configurable via Input\Das.
Six pure-state classesTetromino, Piece, Board, Bag, Score, Game — each individually testable without booting the runtime.
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of tetrigo (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| Tetromino | new(type) | Create a tetromino piece |
| Piece | rotate(direction) | Rotate piece |
| Piece | rotationsWithKicks(delta) | All valid rotated positions (naive + SRS wall-kick offsets) |
| Piece | move(dx, dy) | Move piece |
| Board | new(width, height) | Create game board |
| Board | lock(piece) | Lock piece into board |
| Board | clearLines() | Clear completed lines |
| Board | isPerfectClear() | True iff every cell is null (empty board after a perfect clear) |
| Bag | next() | Get next piece from bag |
| Score | add(lines, level) | Add score for lines cleared |
| Game | tick() | Process game tick |
| Game | state() | Get current game state |
| SrsKickTable | kicks(piece, from, to) | Return kick offsets for a rotation transition |
| SrsKickTable | allKicks(piece) | Return all four transition tables for a piece |
| Scoring\TSpin | detect(board, piece, wasRotated) | Detect T-Spin state using the 3-corner rule; returns TSpin(active, mini) |
| Scoring\TSpin | T_SPIN_POINTS / T_SPIN_MINI_POINTS | Base score constants (400 / 100, scaled by level+1) |
| Input\Das | create(dasMicroseconds, arrMicroseconds) | Factory — defaults 167_000 / 50_000 µs |
| Input\Das | advance(us) | Accumulate microseconds; returns fresh Das |
| Input\Das | leftFiring() / rightFiring() / downFiring() | Whether the direction should fire at current tick |
