🐝 HoneyFlap
Flappy-Bird in your terminal
Physics-driven flap game — the bird's vertical motion is a HoneyBounce projectile (gravity + an upward velocity kick on each tap), pipes scroll left at a fixed cell rate, collision is per-cell. Pure-state Game class; the renderer is a one-pass canvas fill.
Install
composer require sugarcraft/honey-flapQuickstart
./bin/honey-flap
// Programmatic:
use SugarCraft\Core\Program;
use SugarCraft\Core\ProgramOptions;
use SugarCraft\Flap\Game;
(new Program(Game::start(),
new ProgramOptions(useAltScreen: true)))->run();What's in the box
Real physicsBird movement is a
Projectile with gravity vector. flap() rebuilds the projectile with an upward velocity kick — same trick the original flapioca uses, just expressed as projectile state.Pipe spawningA new pipe pair every
PIPE_EVERY ticks; the gap row is sampled from the injected PRNG so tests pin layouts deterministically.Tick-driven
Cmd::tick(0.033, …) ≈ 30 fps. Each tick advances physics + scrolls pipes + checks collision.Per-cell collisionBird's row is rounded to a cell index; collision = bird column matches a pipe column AND the row is outside the open gap.
Restart on crash
r reseeds the world; q / Esc quits.Score on passEvery tick that moves a pipe past the bird's column bumps the score.
Variable difficultyPipe gap shrinks from 6 cells down to 3 as score increases — every 5 points the gap narrows by 1 cell, making the game progressively harder.
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of flapioca (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| Game | start() | Initialize game state |
| Game | tick(delta) | Advance physics one step |
| Game | flap() | Apply upward velocity kick |
| Game | render() | Return ANSI frame string |
| Program | new(game, options) | Create program |
| Program | run() | Start the event loop |
| ProgramOptions | new(useAltScreen) | Configure terminal mode |
