Clumsy Bird

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

▶ Run in browser

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

Tags: port tier-0

Clumsy Bird (SimVX port)

SimVX port of ellisonleao/clumsy-bird, a MelonJS Flappy Bird clone: flap through pipe gaps, score per pipe passed, crash restarts.

Licensing: GPL-3.0-or-later (matching upstream code); all art is CC0 (Kenney Tappy Plane) or procedural, all audio synthesised. See ATTRIBUTION.md.

Run

uv run python examples/ports/clumsy_bird/main.py            # interactive
uv run python examples/ports/clumsy_bird/main.py --test     # headless capture
uv run simvx export web examples/ports/clumsy_bird/main.py -o /tmp/clumsy_bird.html

Controls

• Space / Left click: flap (also starts the run and restarts after a crash)

• 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 = false }
# ///

Run desktop:   uv run python examples/ports/clumsy_bird/main.py
Headless:      uv run python examples/ports/clumsy_bird/main.py --test
Web export:    uv run simvx export web examples/ports/clumsy_bird/main.py -o /tmp/clumsy_bird.html

Controls:
    Space / Click    Flap
    Esc              Quit
"""

# /// script
# requires-python = ">=3.14"
# 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 config import HEIGHT, WIDTH  # noqa: E402
from nodes.play_scene import PlayScene  # noqa: E402

from simvx.core import InputMap, Key, MouseButton  # noqa: E402
from simvx.graphics import App  # 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()