Wobbly Duck

Hop, dash and splash down an endless river as a wobbly little duck. A cheerful 2D endless runner for desktop and mobile browsers, published on Poki. Built with Phaser 3, TypeScript and Vite.

The game

Guide a chubby, squishy duck down a never-ending river. Jump over logs and rocks, double jump over crate stacks, and dash to smash crates. Collect corn kernels for points, then spend them on new ducks.

• Duckling Parade. Lost ducklings join a line behind you and copy your jumps a beat later. Each one multiplies your score (×2 up to ×7), but an obstacle that hits one knocks it out.
• Two buttons, lots of moves. Jump, double jump in the air, dash. Lily pads bounce you high.
• Eight corn kernels, from yellow (50) to crown (1,000), placed in trails, arcs and sky lines.
• It gets harder: speed ramps up and new patterns unlock at 200 m and 800 m.
• A changing world: from 450 m every run drifts from tropical islands into a mountain lake.
• Goals: a BEST flag floats in the river at your best distance. Passing your best score triggers a "New Record!" party.
• Skins shop: seven ducks bought with your total score (Classic, Pekin, Khaki, Tufted, Wigeon, Mallard, Mandarin), each with its own unlock celebration.
• Watch-an-ad revive: once per run after a crash, through Poki's rewarded ads.

Controls

The duck swims by itself. On a player's first run the river pauses at the first log and the first crate, and a callout shows exactly what to press; on later runs the DASH button (or the D key) glows whenever a crate is coming and the dash is ready.

Action	Desktop	Touch
Jump (press again in the air to double jump)	W, ↑ or Space	JUMP button (bottom-left), or tap the left half
Dash (smashes crates)	D or →	DASH button (bottom-right), or tap the right half
Start	Enter, a jump key or D	Play button, or any tap on the menu
Play again	Enter	Play Again button
Pause / resume	Esc or P	Pause button

Getting started

Needs Node.js 20+. The asset tools also need Python 3 with pillow and numpy.

npm install
npm run dev          # http://localhost:5173 (also printed as a LAN URL for phone testing)

Script	What it does
npm run dev	Dev server with hot reload
npm run typecheck	TypeScript check (must pass before committing)
npm run build	Production build into dist/
npm run preview	Serve the last production build
npm run build:poki	Poki build into dist-poki/ and a zip ready to upload (see below)

Debug mode: add ?debug to the URL to draw hit boxes, log Game Events to the console and expose the scene as window.__scene. Debug mode is stripped from the Poki build.

Poki build and versions

npm run build:poki builds with the real Poki HTML5 SDK and zips the result as wobbly-duck-poki-v<version>-<commit>.zip, with index.html at the zip root. The dev build uses a local stand-in instead (fake ads, events logged in debug mode).

• Version number: package.json version + git commit (e.g. v0.1.0+3f5c2d1). It shows small in the corner of the main menu and in the browser console, and it's in the zip name, so a bug report or screenshot always tells you which build it came from. A build made with uncommitted changes is marked -dirty.
• New release: commit, then npm version patch (or minor), then npm run build:poki, then upload the zip.
• The Poki build adds the SDK script and leaves out the debug tools and the in-game credit. The first run starts straight away with gameplayStart; later runs and resumes get a commercial break first. The SDK starts in parallel with the game (it can take seconds), and SDK calls queue behind it in order. It uses rewarded breaks for the revive, and sends Game Events. If the SDK is blocked (ad blocker) the game still plays, without revives.

How it's built

• Phaser 3.90 renders sprites and animation. There's no Phaser physics: the duck's buoyancy, jumps and collisions are hand-written and sub-stepped (≤ 1/120 s).
• All tuning lives in src/config.ts: speeds, jump, water, spawning, scoring, skins, prices, biomes, celebrations.
• Handcrafted patterns (src/game/Patterns.ts) are timed in seconds of travel, so fairness holds at any speed. Obstacle spacing, food arcs and the crate-stack heights were checked against the real jump physics and with in-game bots.
• The UI is a DOM overlay (index.html, src/ui/, src/style.css), not canvas text. It's crisp at any pixel density and respects phone safe areas.
• Portal code is isolated in src/platform/. Gameplay code never calls the Poki SDK directly.
• Sound effects are synthesised with Web Audio, so there are no audio files to download.

This is the beginning of the README. Read the rest at the original. Read the full README ↗