Balatro-Feel

Card hover / select / drag / play, pure tween expressiveness.

▶ Run in browser

Upstream: https://github.com/mixandjam/balatro-feel

Tags: port tier-1

Balatro-Feel: SimVX port

Recreates the mixandjam Balatro-feel Unity demo in pure SimVX. A hand of seven cards with hover scale, follow-rotation, drag-to-reorder, selection lift, and a Space-key “play hand” punch sequence.

Run

From the SimVX repo root:

# Interactive
uv run python ported_games/balatro_feel/simvx_port/main.py

# Headless capture (frames 30, 60, 119 → screenshots/frame_*.png)
uv run python ported_games/balatro_feel/simvx_port/main.py --test

# Scripted-input harness (six staged screenshots demonstrating hover/select/drag/play)
uv run python ported_games/balatro_feel/simvx_port/harness.py

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

Controls

Input	Action
Hover	Lift, scale-up, parallax tilt toward cursor
Click	Toggle selection (selected cards rest higher)
Drag	Card follows cursor; crosses swap slots in the hand
Right-click	Deselect all
Space	Punch-pulse the selected cards in left-to-right order, then deselect
Delete	Remove the hovered card

Layout

simvx_port/
├── main.py                # entry + InputMap + root scene
├── harness.py             # scripted input + screenshot capture
├── pyproject.toml         # [tool.simvx] root = "BalatroFeelRoot"
├── nodes/
│   ├── card_textures.py   # procedural card faces, suit pips, drop shadow
│   ├── card.py            # Card (input root) + CardVisual (spring-follow visual)
│   └── hand_holder.py     # hand layout, slot swap, input dispatch
├── screenshots/           # idle + harness captures
└── web/                   # exported HTML bundle

See ../NOTES.md for design decisions, deviations from upstream, and engine friction.

License

MIT (matches upstream).

Source

"""Balatro-Feel: Card hover / select / drag / play, pure tween expressiveness.

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

Run:
    uv run python ported_games/balatro_feel/simvx_port/main.py
    uv run python ported_games/balatro_feel/simvx_port/main.py --test    # headless capture
"""

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.card_textures import make_default_hand  # noqa: E402
from nodes.hand_holder import HorizontalHandHolder  # noqa: E402

from simvx.core import Node2D, Text2D  # 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 = 720


class BalatroFeelRoot(Node2D):
    """Root scene: hand of 7 cards centred low on the screen."""

    def on_ready(self) -> None:
        # Input map (must live in root.on_ready for web export)
        InputMap.add_action("delete_card", [Key.DELETE])
        InputMap.add_action("play_hand", [Key.SPACE])
        InputMap.add_action("primary", [MouseButton.LEFT])
        InputMap.add_action("secondary", [MouseButton.RIGHT])

        cards = make_default_hand()
        self.hand = HorizontalHandHolder(
            cards=cards,
            centre=Vec2(WIDTH / 2, HEIGHT * 0.55),
        )
        self.add_child(self.hand)

        # Title + instructions
        self.add_child(Text2D(
            text="Balatro-Feel  \u00b7  SimVX port",
            x=WIDTH / 2 - 200, y=64,
            font_scale=1.6,
        ))
        instructions = (
            "Hover cards \u2022 Click to select \u2022 Drag to reorder "
            "\u2022 Right-click clears \u2022 Space plays \u2022 Delete removes"
        )
        self.add_child(Text2D(
            text=instructions,
            x=WIDTH / 2 - 460, y=110,
            font_scale=0.85,
            colour=(0.75, 0.75, 0.78, 1.0),
        ))


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

        capture_at = [30, 60, 119]
        app = App(width=WIDTH, height=HEIGHT, title="Balatro-Feel (SimVX)", visible=False)
        frames = app.run_headless(BalatroFeelRoot(), frames=120, 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="Balatro-Feel (SimVX)")
        app.run(BalatroFeelRoot())


if __name__ == "__main__":
    main()