SQUEEK RUNNER

2D Pixel Art Web3 Hamster Arcade Game

PROJECT OBJECTIVE

Build a fully playable 2D pixel-art arcade game called SQUEEK RUNNER, inspired by retro arcade games, bottle-flipping physics mechanics and the hamster-powered mining narrative of Squeekchain.

This must be a real interactive browser game, not a static landing page or a dashboard mockup.

The game must support desktop browsers and mobile browsers.

Official ecosystem: https://squeekchain.com/

Official developer documentation: https://docs.squeekchain.com/

Official API: https://api.squeekchain.com/v1

---

1. VISUAL IDENTITY

Create an original 16-bit pixel-art arcade visual style.

Theme:

• Retro underground hamster mining facility.
• Dark green and black environment.
• Neon green power effects.
• Pixel-art mechanical hamster wheel.
• Cute, recognizable hamster character.
• Retro arcade typography and HUD.

Use original sprite sheets and animations.

Required hamster animations:

• Idle
• Running
• Fast running
• Charging
• Jumping
• Rotating in the air
• Landing
• Perfect landing
• Failure
• Fever mode

The hamster must be visually animated using sprite frames, not just CSS scaling.

Create an original Squeekchain-inspired character without copying unauthorized artwork.

2. CORE GAMEPLAY

The central game scene contains a hamster running inside a mechanical wheel.

Implement three primary input actions:

TAP:

• Clicking the hamster starts running.
• Each valid tap generates a small amount of virtual energy.
• Increase wheel speed and running animation speed.

HOLD:

• Holding the mouse or finger charges sprint energy.
• Show a dynamic charging bar.
• The hamster accelerates.
• Add visual effects and screen feedback.
• Charging has a maximum duration.

RELEASE:

• Releasing launches the hamster into the air.
• Use a physics-based trajectory.
• Apply gravity and angular rotation.
• Evaluate landing angle, landing speed and stability.
• Generate different landing results.

3. LANDING SYSTEM

Implement three landing results:

MISS:

• Combo resets.
• No loss of previously earned permanent score.

NICE:

• Successful landing.
• Standard score multiplier.

PERFECT:

• Landing within the ideal angle and velocity window.
• Higher score multiplier.
• Special particle effects and sound.

Implement a forgiving but skill-based landing window.

4. COMBO AND FEVER MODE

• Consecutive successful landings increase Combo.
• Five consecutive successful landings activate Fever Mode.
• Fever Mode lasts 10 seconds.
• Add faster hamster animation.
• Add screen effects and pixel particles.
• Increase game score multiplier.
• Display a countdown timer.

5. GAME ECONOMY

Create two separate internal game values:

POWER:

• Virtual game power generated by running and gameplay.
• Used for progression and game statistics.

SCORE:

• Earned through successful actions.
• Used for upgrades, cosmetic unlocks and leaderboards.

Do not represent virtual game power as official Squeekchain mining work.

Do not independently mint SQK.

6. GAME SCREENS

HOME:

• Main hamster wheel scene.
• Animated hamster.
• RPM display.
• Virtual Power display.
• Charging bar.
• Sprint interaction.
• Combo counter.
• Fever Mode.
• Score.
• Squeekchain live block progress.

UPGRADE:

• Wheel Speed.
• Energy Capacity.
• Sprint Boost.
• Recovery.
• Combo Bonus.

LEADERBOARD:

• Daily Score.
• Weekly Score.
• Total Distance.
• Best Combo.

HAMSTER COLLECTION:

• Classic Hamster.
• Miner Hamster.
• Golden Hamster.
• Cyber Hamster.
• Squeektoshi Special.

CHAIN DASHBOARD:

• Current Squeek block height.
• Official work progress.
• Official cumulative work units.
• SQK supply and issuance.
• Official hamster RPM and status.

7. SQUEEKCHAIN INTEGRATION

Use the official read-only API.

Endpoints:

GET /v1/status

GET /v1/core

GET /v1/economy/state

GET /v1/accounts/{address}

GET /v1/squeeks/{tokenId}

Implement:

• Real-time data display.
• Polling with appropriate intervals.
• Loading states.
• Error handling.
• Unavailable data states.
• Rate-limit handling.
• Response schema validation.

Do not query the API every animation frame.

The official API currently serves the documented Sepolia deployment. Clearly identify testnet information where applicable.

Do not confuse player clicks with actual WHEELY9000 sensor measurements.

8. WALLET CONNECTIVITY

Prepare wallet integration using Wagmi and Viem.

Support:

• MetaMask.
• WalletConnect-compatible wallets.
• Wallet address display.
• Squeek NFT ownership lookup.
• Squeek account information.

Wallet connectivity must be optional for the basic game.

Do not request private keys or seed phrases.

Do not implement unauthorized SQK minting or token transfers.

9. TECHNICAL STACK

Frontend:

• React
• TypeScript
• Phaser 3

Game:

• Sprite sheet animation.
• Arcade Physics.
• Pointer and touch controls.
• Responsive game viewport.
• Particle effects.

Blockchain:

• Viem
• Wagmi
• Official Squeekchain API.

Backend:

• Node.js.
• PostgreSQL.
• Server-side score validation.
• Anti-cheat protection.
• Persistent player progression.

10. RESPONSIVE DESIGN

Desktop:

• Keyboard, mouse and pointer support.
• Full game interface.
• Optimized widescreen layout.

Mobile:

• Touch and long-press support.
• Responsive game viewport.
• No accidental browser scrolling.
• No context menu interrupting long presses.
• Support both portrait and landscape layouts.

Handle visibility changes and pause the game when the browser enters the background.

11. SECURITY AND FAIR PLAY

• Never trust client-submitted scores.
• Validate score submissions on the server.
• Add request rate limiting.
• Prevent simple replay and duplicate submissions.
• Separate game points from blockchain balances.
• Never fabricate official blockchain information.

12. DELIVERABLES

Deliver a complete playable MVP including:

1. Main pixel-art game scene.
2. Animated hamster and mechanical wheel.
3. Click-to-run mechanics.
4. Hold-to-charge mechanics.
5. Release-to-sprint physics.
6. Landing evaluation.
7. Combo and Fever Mode.
8. Score and Power system.
9. Upgrade shop.
10. Responsive desktop and mobile controls.
11. Squeekchain public data integration.
12. Leaderboard foundation.

Include:

• Complete source code.
• README.
• Installation instructions.
• Local development instructions.
• Deployment instructions.
• A list of completed and unfinished features.

IMPORTANT: Prioritize actual gameplay and polished interaction over decorative dashboards.

Build and test the playable game before adding optional advanced blockchain features.