Casual Crusade¶

js13k card/dungeon, domino-card placement with BFS scoring.

Upstream: https://github.com/anttihaavikko/casual-crusade

Tags: port tier-1

Casual Crusade (SimVX port)¶

A SimVX port of Antti Haavikko’s js13k 2023 entry, a card-laying dungeon-crawler / domino puzzle.

Run¶

All commands assume cwd = /home/fezzik/dev/simvx.

# Interactive (windowed)
uv run python ported_games/casual_crusade/simvx_port/main.py

# Headless capture (frames 30, 60, 120)
uv run python ported_games/casual_crusade/simvx_port/main.py --test

# Scripted multi-stage harness (7 captures)
uv run python ported_games/casual_crusade/simvx_port/harness.py

# Web export
uv run simvx export web ported_games/casual_crusade/simvx_port/main.py \
    -o ported_games/casual_crusade/simvx_port/web/index.html

Controls¶

Action	Input
Place card	Drag from hand onto a legal (highlighted) tile
Cancel drag	Right-click
Save run	`S`
Load run	`L`
Restart	`R`

Gameplay summary¶

Each card has 1-4 directional edges. Place a card so at least one edge meets a matching neighbour edge on the board.
The pilgrim walks the new path through connected cards, scoring along the way.
Stepping on a card next to a chest loots it, opening a reward picker, picking one card to add to your permanent deck.
Empty (non-reward) tiles at level end cost one life each. Run ends when life reaches zero. Press R to restart.

File map¶

simvx_port/
├── main.py                # entry point + InputMap registration
├── harness.py             # scripted-input capture (7 stages)
├── pyproject.toml         # [tool.simvx] root = "CasualCrusadeRoot"
├── nodes/
│   ├── constants.py       # widths/colours/level titles
│   ├── card_data.py       # CardData + random_card + starter_deck
│   ├── card.py            # Card (drag, hover, draw)
│   ├── tile.py            # Tile (board cell, accepts/marked/hilite)
│   ├── dude.py            # pilgrim (path-walk + draw)
│   └── game.py            # Game (board, hand, scoring, picker, save/load)
├── saves/                 # JSON save (created on first save)
├── screenshots/           # 7 harness + 3 idle captures
└── web/index.html         # 2.5 MB self-contained Pyodide bundle

Source¶

"""Casual Crusade: js13k card/dungeon, domino-card placement with BFS scoring.

# /// simvx
# tags = ["port", "tier-1"]
# upstream = "https://github.com/anttihaavikko/casual-crusade"
# web = { width = 1280, height = 720, responsive = true }
# ///

A card-laying dungeon-crawler / domino puzzle. Place cards from your hand onto
the board so their direction-lines connect. The pilgrim walks the new path and
scores. Reward chests trigger a card-pick after stepping on adjacent cards.

Run:
    uv run python ported_games/casual_crusade/simvx_port/main.py
    uv run python ported_games/casual_crusade/simvx_port/main.py --test
"""

from __future__ import annotations

import sys
from pathlib import Path

_PORT_DIR = Path(__file__).parent
if str(_PORT_DIR) not in sys.path:
    sys.path.insert(0, str(_PORT_DIR))

from nodes.constants import HEIGHT, WIDTH  # noqa: E402
from nodes.game import Game  # noqa: E402

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


class CasualCrusadeRoot(Node2D):
    """Root node: wraps Game so the web exporter can pick it up via [tool.simvx]."""

    autostart = False

    def on_ready(self) -> None:
        # Input actions belong on the root (web-export rule). Game subtree
        # only consumes them.
        InputMap.add_action("primary", [MouseButton.LEFT])
        InputMap.add_action("secondary", [MouseButton.RIGHT])
        InputMap.add_action("save", [Key.S])
        InputMap.add_action("load", [Key.L])
        InputMap.add_action("restart", [Key.R])
        InputMap.add_action("escape", [Key.ESCAPE])
        self.game = self.add_child(Game(autostart=self.autostart))


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="Casual Crusade (SimVX)", visible=False)
        # Run with autostart so the headless capture exercises gameplay UI.
        root = CasualCrusadeRoot()
        root.autostart = True
        frames = app.run_headless(root, frames=121, 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="Casual Crusade (SimVX)")
        app.run(CasualCrusadeRoot())


if __name__ == "__main__":
    main()