🐦 Flutter — A Feature-Rich Flappy Bird Clone

C++ · SDL2 · A polished Flappy Bird clone with unlockable skins, a coin economy, power-ups, combos and a persistent high score table.

---

🎮 Features

Core Gameplay

• Classic flap mechanic with progressive difficulty
• Smooth parallax ground scrolling and animated clouds
• Day/night cycle on the default background

Coins & Economy

• Coins appear between every pipe — collect them mid-flight
• Coins persist across sessions and are saved to disk
• Spend coins in the Shop on bird skins and world backgrounds

Shop — 6 Bird Skins

Skin	Cost
Classic (yellow)	Free
Sky Blue	80 coins
Ruby (red)	120 coins
Emerald (green)	150 coins
Void (purple)	200 coins
Rainbow	300 coins

Shop — 6 World Backgrounds

World	Cost
Day	Free
Sunset	80 coins
Night (starfield)	100 coins
Candy	140 coins
Ocean	180 coins
Volcanic	250 coins

Power-Ups (appear mid-air)

Power-Up	Effect
🔵 Shield	Absorbs one hit — pipe or floor collision
🟡 Slow-Mo	Halves game speed for 4 seconds
🔴 Magnet	Coins fly toward you from 120px range

Scoring

• +1 point per pipe passed (base)
• Combo multiplier — consecutive pipes raise the score per pipe
• Combo counter displayed on screen, combo max saved per session
• Top-10 high score table with 3-letter name entry (persistent)

---

🕹️ Controls

Key / Input	Action
SPACE / ↑ / Mouse Click	Flap
P	Pause / Resume
S	Open Shop
H	High Scores
ESC	Return to Title
Shop: ← →	Select item
Shop: ENTER	Buy / Equip
Shop: 1 / 2	Switch Birds / Worlds tab
Name entry: ↑↓	Change letter
Name entry: → / ENTER	Confirm letter

---

🛠️ Building

Dependencies

Ubuntu / Debian:

sudo apt install libsdl2-dev libsdl2-ttf-dev build-essential

macOS:

brew install sdl2 sdl2_ttf

Windows (vcpkg):

vcpkg install sdl2 sdl2-ttf

Compile

g++ flutter.cpp -o flutter \
    $(sdl2-config --cflags --libs) \
    -lSDL2_ttf \
    -std=c++ -O2

Run

./flutter

Progress is saved to flutter_save.dat in the same directory.

---

👤 Author

Aashir Gurung (veqzii)

• github.com/veqzii
• veqzii.github.io