Clumsy Bird

Flappy-style endless flyer with audio, score and restart.

📄 Docs only

Upstream: https://github.com/ellisonleao/clumsy-bird

Tags: port tier-0

Run desktop: uv run python ported_games/clumsy_bird/simvx_port/main.py Headless: uv run python ported_games/clumsy_bird/simvx_port/main.py –test Web export: uv run simvx export web ported_games/clumsy_bird/simvx_port/main.py -o ported_games/clumsy_bird/simvx_port/web/index.html

Controls: Space / Click Flap Esc Quit

Source

#!/usr/bin/env python3
"""Clumsy Bird: Flappy-style endless flyer with audio, score and restart.

# /// simvx
# tags = ["port", "tier-0"]
# upstream = "https://github.com/ellisonleao/clumsy-bird"
# web = { width = 900, height = 600, responsive = true, disabled = true, reason = "Blocked on audio refactor (uses old 'SFX' bus name)." }
# ///

Run desktop:   uv run python ported_games/clumsy_bird/simvx_port/main.py
Headless:      uv run python ported_games/clumsy_bird/simvx_port/main.py --test
Web export:    uv run simvx export web ported_games/clumsy_bird/simvx_port/main.py \
                   -o ported_games/clumsy_bird/simvx_port/web/index.html

Controls:
    Space / Click    Flap
    Esc              Quit
"""

# /// script
# requires-python = ">=3.13"
# dependencies = ["simvx-core", "simvx-graphics", "numpy", "pillow"]
# ///

from __future__ import annotations

import sys
from pathlib import Path

_PORT_DIR = Path(__file__).resolve().parent
sys.path.insert(0, str(_PORT_DIR))

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

from config import HEIGHT, WIDTH  # noqa: E402
from nodes.play_scene import PlayScene  # noqa: E402


class Game(PlayScene):
    """Root scene: wraps PlayScene to register InputMap actions in on_ready."""

    def on_ready(self):
        # InputMap actions MUST live in the root node's on_ready, not main(),
        # so the web exporter sees them (it skips main()).
        InputMap.add_action("flap", [Key.SPACE, MouseButton.LEFT])
        super().on_ready()


def main():
    test_mode = "--test" in sys.argv
    app = App(width=WIDTH, height=HEIGHT, title="Clumsy Bird", visible=not test_mode)

    if test_mode:
        from simvx.graphics import save_png
        out = _PORT_DIR / "screenshots"
        out.mkdir(exist_ok=True)
        frames = app.run_headless(Game(), frames=180, capture_frames=[60, 120, 179])
        for idx, n in enumerate([60, 120, 179]):
            save_png(out / f"frame_{n}.png", frames[idx])
        print(f"Wrote {len(frames)} screenshots to {out}")
        app.quit()
        return

    app.run(Game())


if __name__ == "__main__":
    main()