Tetris (raylib classic)¶

Grid logic, rotation, line clears, score HUD.

Upstream: https://github.com/raysan5/raylib-games/tree/master/classics/src

Licence: this port's own code is offered under Zlib, not the SimVX Examples Licence the rest of the gallery carries. See ATTRIBUTION.md for the upstream it re-implements, the terms of anything it bundles, and the credit each one requires.

Ports live in the repository only, not in the simvx-examples distribution, because each is a derivative work licensed individually against the game it re-implements. Read it with git clone https://git.simvx.com/simvx/simvx.

Tags: port tier-0

Tetris (raylib classic): SimVX port¶

A source-faithful port of tetris.c from raylib-games/classics by Marc Palau and Ramon Santamaria. The gameplay is a direct translation of the C original: a sentinel-bordered 12x21 grid, the empty/moving/full/block/fading cell states, gravity with a held soft drop, lateral auto-repeat, a rotation lockout, and the line-clear flash.

Everything is drawn procedurally, so the port bundles no upstream art, audio, or fonts. See ATTRIBUTION.md and UPSTREAM_LICENSE.md.

What it shows¶

Immediate-mode 2D drawing: the whole playfield, preview and HUD come out of one on_draw on a dynamic node, with no sprites or scene nodes per cell.
Typed input actions shared by keyboard and touch, so the same game logic serves desktop and the web export.
Resize-aware layout: the cell size, the panel origin and every text scale are recomputed from tree.screen_size each frame.
A menu / play / game-over state flow inside a single node.

Run¶

# from the repo root
uv run python examples/ports/raylib_tetris/main.py

Controls¶

Action	Keyboard	Touch
Move sideways	LEFT / RIGHT or A / D	Tap left or right half of the board
Rotate 90° CW	UP or W	Tap above the board
Soft drop	DOWN or S (after a brief hold)	Tap below the board
Pause / resume	P	Tap the side panel (any tap resumes)
Start / restart	SPACE or ENTER	Tap anywhere
Quit	ESC	-

Web export¶

uv run simvx export web examples/ports/raylib_tetris/main.py \
    -o /tmp/raylib_tetris.html

Source files¶

File	Summary	Lines
`main.py`	Tetris (raylib classic): Grid logic, rotation, line clears, score HUD.	59
`__init__.py`		0
`nodes/__init__.py`		0
`nodes/tetris_game.py`	Tetris: gameplay node.	558

Source¶

#!/usr/bin/env python3
# /// script
# requires-python = ">=3.14"
# dependencies = ["simvx-core", "simvx-graphics"]
# ///
"""Tetris (raylib classic): Grid logic, rotation, line clears, score HUD.

# /// simvx
# tags = ["port", "tier-0"]
# upstream = "https://github.com/raysan5/raylib-games/tree/master/classics/src"
# web = { width = 600, height = 600, responsive = true }
# ///

A source-faithful translation of raylib's classic ``tetris.c`` into a single
SimVX ``Node2D``. The gameplay follows the C original: a sentinel-bordered
12x21 grid, the empty/moving/full/block/fading cell states, gravity with a
held soft drop, lateral auto-repeat, a rotation lockout, and the line-clear
flash. Around that the port shows immediate-mode 2D drawing (``on_draw`` on a
``dynamic`` node), typed input actions dispatched from both keyboard and touch
zones, a menu / play / game-over flow, and resize-aware text layout that fits
itself to the window.

Controls: LEFT/RIGHT or A/D move, UP or W rotates, DOWN or S soft-drops after
a brief hold, P pauses, SPACE or ENTER starts and restarts, ESC quits. By
touch, tap the left or right half of the board to move, above it to rotate,
below it to soft-drop, and on the side panel to its right to pause.

Run::

    uv run python examples/ports/raylib_tetris/main.py

Web export::

    uv run simvx export web examples/ports/raylib_tetris/main.py -o /tmp/raylib_tetris.html

Attribution and upstream licence: see ``ATTRIBUTION.md`` and
``UPSTREAM_LICENSE.md`` beside this file.
"""

import os
import sys

_HERE = os.path.abspath(os.path.dirname(__file__))
if _HERE not in sys.path:
    sys.path.insert(0, _HERE)

from nodes.tetris_game import TetrisGame

from simvx.graphics import App

WIDTH, HEIGHT = 600, 600


def main():
    App(title="Tetris (raylib classic)", width=WIDTH, height=HEIGHT).run(TetrisGame())


if __name__ == "__main__":
    main()