Flappy World
White Paper v1.03.9 — Web3 Mini-Game
Visit siteVision
Flappy World is a browser-based Web3 mini-game. The goal is to prove that a blockchain game can be simple, fun, and immediately playable before integrating on-chain mechanics.
The project explores the intersection of casual gaming and the Solana blockchain, building solid gameplay first, then layering a tokenized economy on top.
The game source code is open source. Only the Web3 architecture (token management, reward distribution) will remain private for security reasons.
Gameplay
Flappy World is a reimagined Flappy Bird. The player controls a pixel bird flying through pipes and collecting coins. One input is enough: click, space, or touch.
Controls
A tap/click flaps the wings. Holding extends the flight briefly ("float" physics). Releasing triggers the fall.
Score
Each coin collected between two pipes is worth 1 point. The top 10 scores are kept per session.
Modes
Free Run: unlimited free play. Adventure: upcoming mode with conditions and rewards.
Tricks
Every 3 jumps, a trick activates (Loop, Spinner). The Spinner offers a glide effect on hold — a survival mechanic.
Game cycle: Cinematic intro → Countdown → Match → Game Over → Replay or quit
In-Game Economy
Flappy World runs on a two-currency system:
Coins
Earned in-game. Used to buy cosmetics in the shop. Exchangeable for $token (coming soon).
$Token (Gems)
Blockchain currency on Solana. Obtained by exchanging coins or through mission rewards. Feature in development.
Coins have no financial value. Only the $token is an on-chain currency. The coin → $token exchange ratio will be defined during Web3 integration.
Shop & Cosmetics
The shop offers cosmetics that change appearance and visual effects without affecting game balance. Each item can be previewed before purchase.
Skins (Colors)
Green · Red · Pink · Blue · Purple · Orange · Multicolor (smooth color cycle) · Phosphor (glowing animation). Price: 10–80 coins.
Trails
Rainbow · Cloud · Miasma (toxic green bubbles). Particle effects left in the bird's wake. Price: 30–400 coins.
Jump Effects
Ring · Fart (green cloud) · Firework (colorful explosion). Animations triggered on each wing flap. Price: 30–80 coins.
Tricks
Pirouette (full loop every 3 impulses) · Spinner (vertical flip + glide mode on hold). Price: 60–100 coins.
Web3 Integration — Solana
Flappy World's tokenomics are designed to extend the game's lifespan and reward player loyalty and time invested, proportional to the challenges completed.
Token $token
Native Solana token of the Block'n Dice project. Flappy World is its first distribution vector. Earnable in-game without speculation.
In-game Swap
Integrated swap window (v0.19.6) to exchange coins for $token. Wallet connection to be implemented.
Adventure Mode
Daily run limit (3 runs / reset at 7am). Earning potential capped at 1,000 coins/day. Incentive to play regularly.
Player Profile
Coming soon: username and equipment visible to other players in the intro animation (the bird group will be made up of real profiles).
Reward System
Lottery
Random reward from a selection of cosmetic items or $token during special events.
Target Score
Reward triggered upon reaching a specific score or personal record. Encourages progression.
Missions
Daily or weekly challenges (e.g., collect 50 coins, chain 10 pipes). Reward in $token or shop item.
Periodic Distribution
Score snapshot over a period. Top players receive a share of the $token reward pool.
Roadmap
Phase 1 — Development
Playable prototype · Bird physics · Coin system · Top 10 scores · Cosmetics shop · Sound design · Mobile PWA
Phase 2 — Alpha
Player testing · Physics balancing · $token swap window · Technical documentation · Bug fixes
Phase 3 — Release
Itch.io deployment · Player profile · Adventure mode · Themed levels (beach, mountain, autumn)
Phase 4 — Web3
Solana wallet connection · $token distribution · On-chain missions · Global leaderboard · Themed shop by page
Technical Architecture
Flappy World is built in pure HTML5 / JavaScript, without any framework, rendered on a 400×600px canvas.
Game Engine
Fixed-step 60Hz loop (STEP accumulator = 16.67ms). Constant physics regardless of screen refresh rate. Native requestAnimationFrame rendering.
Graphics
Procedural pixel art drawn in Canvas 2D. Sprites coded in pure JavaScript (rectangles, arcs). Ready for drawImage() replacement.
Compatibility
PWA compatible with mobile and desktop. Adaptive viewport. Full-screen immersion. Native touch support.
Final Note
Human-sized project, in active development.
Flappy World is currently in Alpha phase (v0.20). Core gameplay is functional and playable. Web3 integration will come in phase 4, once the game is stabilized and tested by a player community. This document will evolve with the project.