Claustrowordia

LD50 winner, UI tweens, audio juice, 56k-word dictionary scoring.

📄 Docs only

Upstream: https://github.com/anttihaavikko/claustrowordia

Tags: port tier-1

Claustrowordia (SimVX port)

SimVX port of anttihaavikko/claustrowordia LD50 jam winner. Crossword-on-a-grid puzzle: place letter tiles on a 7×7 board, score per valid English word formed in any direction.

Run

# from /home/fezzik/dev/simvx
uv run python ported_games/claustrowordia/simvx_port/main.py            # interactive
uv run python ported_games/claustrowordia/simvx_port/main.py --test     # headless capture (3 frames)
uv run python ported_games/claustrowordia/simvx_port/harness.py         # scripted-input capture (5 stages)
uv run simvx export web ported_games/claustrowordia/simvx_port/main.py \
    -o ported_games/claustrowordia/simvx_port/web/index.html

Controls

• Click a letter in the hand picks up the tile (it follows the cursor).

• Click on an empty grid cell drops the tile there. Words formed in rows / columns (forward and reversed) are scored.

• Right-click while holding a tile cancels and returns it to the hand.

• R restarts after game-over.

• Escape quits.

Acceptance bar

• [x] Source cloned to source/

• [x] main.py launches the game with a fanned hand + 7×7 grid

• [x] Tile placement, word validation, scoring, lose condition all wired

• [x] UI tweens (damped-sine punch on place / score; bounce on hand layout)

• [x] Audio juice: place sound, score note (per-letter ascending pitch), word-complete chime, game-over thunk: all procedural

• [x] Running score in the HUD (Text2D)

• [x] Headless screenshots at frame 30 / 60 / 120 in screenshots/

• [x] Scripted harness covering 5 stages

• [x] Web export to web/index.html

• [x] NOTES.md with friction points + engine-gap candidates

Source

"""Claustrowordia: LD50 winner, UI tweens, audio juice, 56k-word dictionary scoring.

# /// simvx
# tags = ["port", "tier-1"]
# upstream = "https://github.com/anttihaavikko/claustrowordia"
# web = { width = 1280, height = 800, responsive = true, disabled = true, reason = "Blocked on audio refactor (uses removed AudioStream.from_pcm(sample_rate=…) kwarg)." }
# ///

Run:
    uv run python ported_games/claustrowordia/simvx_port/main.py
    uv run python ported_games/claustrowordia/simvx_port/main.py --test    # headless capture
"""
# /// script
# requires-python = ">=3.13"
# dependencies = ["numpy", "freetype-py"]
# ///

from __future__ import annotations

import sys
from pathlib import Path

# Allow running from any cwd
_PORT_DIR = Path(__file__).parent
if str(_PORT_DIR) not in sys.path:
    sys.path.insert(0, str(_PORT_DIR))

from nodes.game import Game  # noqa: E402

from simvx.core import Node2D  # noqa: E402
from simvx.core.input.enums import Key, MouseButton  # noqa: E402
from simvx.core.input.map import InputMap  # noqa: E402
from simvx.core.math.types import Vec2  # noqa: E402
from simvx.graphics import App  # noqa: E402

WIDTH = 1280
HEIGHT = 800


class ClaustrowordiaRoot(Node2D):
    """Root scene wrapper: registers input actions and adds the Game node."""

    def on_ready(self) -> None:
        # Input map (must live in root.on_ready(); web exporter skips main()).
        InputMap.add_action("primary", [MouseButton.LEFT])
        InputMap.add_action("secondary", [MouseButton.RIGHT])
        InputMap.add_action("restart", [Key.R])
        InputMap.add_action("quit", [Key.ESCAPE])

        self.game = self.add_child(Game(viewport_size=Vec2(WIDTH, HEIGHT)))


def main() -> None:
    headless = "--test" in sys.argv
    if headless:
        from simvx.graphics import save_png

        capture_at = [30, 60, 120]
        app = App(width=WIDTH, height=HEIGHT, title="Claustrowordia (SimVX)", visible=False)
        frames = app.run_headless(ClaustrowordiaRoot(), frames=130, capture_frames=capture_at)
        out_dir = _PORT_DIR / "screenshots"
        out_dir.mkdir(exist_ok=True)
        for idx, img in zip(capture_at, frames, strict=False):
            out_path = out_dir / f"frame_{idx}.png"
            save_png(out_path, img)
            print(f"saved {out_path}")
    else:
        app = App(width=WIDTH, height=HEIGHT, title="Claustrowordia (SimVX)")
        app.run(ClaustrowordiaRoot())


if __name__ == "__main__":
    main()