Hextris¶

Rotate the hexagon to line up falling colour blocks.

Upstream: https://github.com/Hextris/hextris

Licence: this port's own code is offered under GPL-3.0-or-later, 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

Hextris (SimVX port)¶

SimVX port of Hextris, the hexagonal falling-block puzzle. Coloured blocks fall from six directions toward a central hexagon: rotate the hexagon so three or more blocks of one colour stack on a single face and they clear. Let any face stack eight blocks deep and the run ends.

Licensing: GPL-3.0-or-later, matching upstream. No upstream art is reused: the board, blocks and HUD are drawn procedurally. See ATTRIBUTION.md.

Run¶

simvx examples run ports_hextris
simvx export web main.py -o hextris.html

Controls¶

Action	Binding
Rotate anticlockwise	Left / A, or tap the left half
Rotate clockwise	Right / D, or tap the right half
Speed the blocks up	Down / S, or hold the pointer near the bottom
Pause	P
Start / restart	Enter / Space / R, or tap

What this shows about SimVX¶

Immediate-mode 2D drawing. The whole board (hexagon, slices, block trapezoids, HUD, overlays) is one on_draw body using polygon, line, rect and text. No sprites, no assets.
Rect-aligned text. Titles, prompts and the controls strip are positioned with text(rect=..., align="centre", fit_to_width=True) instead of hand-measured offsets, so they stay centred and readable at any size.
A resize-aware layout. Drawing and hit-testing both derive from tree.screen_size, with a uniform scale from the 800x800 design size, so the responsive web export stays centred at any aspect ratio.
One input path for mouse and touch. The web runtime reports a touch as a left mouse button press at the touch position, so Input.is_mouse_button_just_pressed(Mouse.LEFT) plus the pointer position covers desktop and mobile without a separate touch branch.
Actions registered in the root’s ready path. InputMap.add_action calls live in HextrisRoot.on_ready, not in main(), because InputMap belongs to a scene tree and none exists before run().

Upstream¶

The upstream JavaScript was used as a design reference only; all Python here was written from scratch.

Source files¶

File	Summary	Lines
`main.py`	Hextris: Rotate the hexagon to line up falling colour blocks.	54
`capture.py`	Headless screenshot capture for Hextris.	22
`nodes/__init__.py`		0
`nodes/game.py`	HextrisGame: the whole game in one immediate-mode 2D scene node.	431
`nodes/hex_math.py`	Hex geometry helpers for the board: angles, vertices, slices and blocks.	89

Source¶

#!/usr/bin/env python3
# /// simvx
# tags = ["port", "tier-0"]
# upstream = "https://github.com/Hextris/hextris"
# web = { width = 800, height = 800, responsive = true }
# ///
"""Hextris: Rotate the hexagon to line up falling colour blocks.

Port of Hextris (https://github.com/Hextris/hextris, GPL-3.0-or-later) rebuilt
on SimVX. Coloured blocks fall from six directions toward a central hexagon:
rotate the hexagon so three or more blocks of one colour stack on a single face
and they clear. Let any face stack eight blocks deep and the run ends.

The board, blocks and HUD are drawn procedurally in ``on_draw`` (polygons,
lines and rect-aligned text), the layout follows the live viewport size so the
responsive web export stays centred, and every control has a pointer
equivalent: web touches arrive as left clicks, so one code path serves mouse
and touch.

Run:           simvx examples run ports_hextris
Web export:    simvx export web main.py -o hextris.html

Controls:
    Left / A, or tap the left half      Rotate anticlockwise
    Right / D, or tap the right half    Rotate clockwise
    Down / S, or hold near the bottom   Speed the blocks up
    P                                   Pause
    Enter / Space / R, or tap           Start, and restart after a game over
"""

from nodes.game import HextrisGame  # noqa: E402

from simvx.core import InputMap, Key, Node
from simvx.graphics import App  # noqa: E402

WIDTH, HEIGHT = 800, 800


class HextrisRoot(Node):
    """Root node: registers actions and hosts the game scene."""

    def on_ready(self):
        # Actions are registered here rather than in main(): InputMap belongs
        # to a scene tree, and none exists before run().
        InputMap.add_action("rotate_left", [Key.LEFT, Key.A])
        InputMap.add_action("rotate_right", [Key.RIGHT, Key.D])
        InputMap.add_action("speed_up", [Key.DOWN, Key.S])
        InputMap.add_action("start", [Key.ENTER, Key.SPACE, Key.R])
        InputMap.add_action("pause", [Key.P])
        self.add_child(HextrisGame(name="HextrisGame"))


if __name__ == "__main__":
    App(width=WIDTH, height=HEIGHT, title="Hextris (SimVX port)").run(HextrisRoot())