Zuma.io: Marble Shooter - Portrait Puzzle Game for Android

Mechanics & Controls

Core Gameplay & Mobile Controls

Engineered from the ground up for ergonomic one-handed mobile play with responsive dual-mode aiming and tactical chain reaction dynamics.

Portrait Canvas (1080×1920)

Designed natively for comfortable one-handed mobile play with a fixed 1080×1920 logical canvas, perfectly adapted across all Android screen aspect ratios.

Safe area aware HUD overlays
Ergonomic lower-third thumb controls
Ultra-fluid 60 FPS viewport rendering

Dual Aiming Modes

Play whichever way suits your playstyle best with dual aiming mechanics that react instantly to player touch inputs.

Instant Tap: Tap anywhere to fire immediately
Drag-to-Aim: Trace trajectory line and release to shoot
Sub-millisecond touch event processing

Rapid Marble Swap

Keep the upper hand against relentless rolling tracks by swapping spheres on the fly right inside your shooter totem.

Tap center frog mascot to swap active & on-deck marbles
Instant response with zero shot lag
Visual cues for next upcoming projectile

Match-3+ & Cascades

Connect 3 or more consecutive marbles of the same hue to vaporize them from the rolling chain with dynamic particle bursts.

Magnetic rollbacks across chain gaps
Cascading combo multipliers up to 8×
Floating punchy score callouts: SCORE → CASCADE → COMBO

Dynamic Danger State

When the lead marble crosses 85% of track length, urgent visual vignettes and heart-racing audio heighten the thrill.

Pulsing red warning vignette on screen borders
Dynamic tension SFX and tempo-shifting music
Fully respects user Reduced Motion setting

Swallowing Drain Vortex

The golden skull threshold guards the end of the track. Fail to stop the chain, and marbles spiral into the vortex.

100% path distance triggers drain sequence
Marbles shrink and sink with 3D vortex animations
Optional Rewarded Continue pushes chain back 20%

Arcane Spheres

Special Marbles in the Chain

Level configurations introduce unique mystical marbles into the chain that unleash game-changing tactical effects when matched.

Bomb Marble

Detonates nearby marbles within a 2.5× marble-spacing radius along the track upon matching, obliterating clustered obstacles.

Slow Marble

Drops the entire rolling chain's speed to 30% of normal for 8 seconds, providing clutch breathing room for precision trick shots.

Reverse Marble

Forces all active chain segments backward along the track at 1.5× base speed for 3 seconds while pausing spawner output.

Lightning Marble

Calls down a divine celestial bolt that vaporizes every single marble of the most common alive color on the active board.

Rainbow Marble

Universal wildcard marble that matches seamlessly with any adjacent color, triggering otherwise impossible chain combos.

Ice Marble

Enclosed in a frozen crystal shell; resists matching until cracked by an initial projectile impact before it can be destroyed.

Armored Marble

Encased in tough protective plating; requires a direct impact to shatter armor before it can be inserted and cleared.

Player Arsenal

Player Tactical Boosters

Equip and trigger 4 active tactical powers from the HUD tray during high-stakes moments. Boosters are earned purely through gameplay and optional rewarded ads—no paywalls, no energy systems.

Bomb Booster

Arm and fire a high-explosive shot that directly clears a wide sector of marbles anywhere along the track.

Color Splash Booster

Re-colors surrounding marbles into uniform clusters to prime massive cascades and multi-match combos.

Lightning Booster

Unleashes an instant targeted lightning strike across the track to eliminate stubborn obstacle clusters.

Time Freeze Booster

Completely halts marble movement for a short window, giving you absolute freedom to line up precision skill shots.

Saga Progression

5 Mystical Worlds • 50 Campaign Levels

Journey through 50 meticulously balanced levels. Levels 1–10 are handcrafted to introduce mechanics; Levels 11–50 are deterministically generated via seeded RNG for 100% fair and repeatable track geometry.

World 1

Jungle

Levels 1–10

Dense foliage, ancient ruins, and handcrafted curves to master the fundamentals of marble shooting.

World 2

Temple

Levels 11–20

Stone labyrinths, dual paths, and the first appearance of frozen Ice Marbles.

World 3

Volcano

Levels 21–30

Blazing magma flows, accelerated track conveyor speeds, and durable Armored Marbles.

World 4

Sky Sanctuary

Levels 31–40

Floating aerial temples, tight spiral curves, and high-density puzzle layouts demanding trick shots.

World 5

Eclipse

Levels 41–50

Mystic twilight realms, intense multi-color distributions, and the ultimate test of speed and skill.

Milestone Boss Battles (Levels 10, 20, 30, 40, 50)

Test your mastery at the end of every world! Every 10 levels features an epic encounter governed by deterministic multi-phase boss controllers. Bosses summon armored marble shields, trigger sudden track speed surges, and rearrange rolling paths in real time. Defeating them unlocks the next realm and grants rare mastery stars.

Player Experience

Accessibility, Graphics & Haptics

Built with total comfort, accessibility, and battery optimization in mind for all Android players.

Colorblind Accessible

Every marble color is stamped with a distinct, unmistakable geometric glyph and pattern. Players never have to rely on color hue alone to identify matches.

Tested across Protanopia, Deuteranopia, and Tritanopia.

Reduced Motion Mode

A one-tap toggle in Settings disables camera zoom-punches, screen shake, pulsing vignettes, and heavy explosions without affecting the underlying deterministic physics.

Full comfort for motion-sensitive players.

3 Visual Quality Tiers

Choose between Low (rasterized effects, max battery), Medium (default full particle fidelity), and High (ambient glow & bloom highlights).

Includes Adaptive Quality Engine for auto-stepping.

Atmospheric Audio

Full original soundtrack featuring dedicated themes for Home Lobby, Saga Map, Stage Exploration, Danger Tension, Boss Battles, and Victory.

Independent music & SFX volume sliders + mute toggles.

Tiered Smart Haptics

4 distinct vibration feedback levels (Selection, Light, Medium, Heavy) featuring cooldown rate-limiting and interrupt priority to prevent vibration queue flooding.

Tactile satisfaction on every marble pop.

100% Offline-Playable

The entire 50-level campaign, star progression, settings, and gameplay function seamlessly with no internet connection required.

No login, no cloud dependency, no paywalls.

Engineering Excellence

Engine Architecture & Tech Stack

A clean separation between authoritative pure-Dart simulation and the 1080×1920 Flame visual rendering layer.

Flutter 3.44.1

Cross-platform framework

Flame Engine

2D Game Presentation

Pure Dart 3.12.1

1/120s Deterministic Sim

Android Native

Min SDK 21 • Target SDK 34

Google UMP

GDPR & CCPA Consent

239 Unit Tests

100% Deterministic QA

lib/ ├── config/ Compile-time environments (dev, staging, prod) & security gating ├── core/ Pure-Dart authoritative simulation running at a deterministic 1/120s step │ ├── analytics/ Privacy-minimal abstract telemetry seams (GameplayAnalytics) │ ├── boss/ Deterministic multi-phase boss controllers (Levels 10, 20, 30, 40, 50) │ ├── levels/ Handcrafted levels (1–10) & deterministic seeded generator (11–50) │ ├── models/ Immutable models for marbles, chains, levels, paths, and scores │ ├── systems/ Arc path interpolation, collision broadphase, and scoring rules │ └── theme/ Central design tokens, palettes, typography, and visual rules ├── flame/ Fixed-resolution 1080×1920 Flame presentation layer │ ├── components/ Animated shooter frog, marble chain presenter, track textures │ └── effects/ Zero-allocation pooled VFX layer (particles, pops, shockwaves) ├── services/ Encapsulated persistence, audio, UMP/AdMob, in_app_review, in_app_update └── ui/ Flutter screens (Home, Saga Map, Settings) and HUD overlays

In-App Review

Google Play In-App Review (in_app_review) intelligently prompts players on 3-star milestone victories.

In-App Updates

Google Play In-App Updates (in_app_update) checks for seamless flexible or immediate game updates.

Native Share Sheet

System Share Sheet (share_plus) allows players to challenge friends with their stars and high scores.

Secure URL Launcher

Sandboxed launching of the official HTTPS privacy policy and legal resources (url_launcher).

Store Readiness

Google Play Store Metadata

Pre-cleared, policy-compliant metadata ready for deployment on the Google Play Console.

Official App Title (24 / 30 chars)

Zuma.io: Marble Shooter

Alt: Zuma.io - Marble Puzzle

Short Description (74 / 80 chars)

Aim, match marbles, and stop the chain! Blast through 50 fun puzzle levels.

Category & Content Rating

Category: Games → Puzzle / Action-Puzzle

IARC Rating: Everyone / PEGI 3 / USK 0

In-App Purchases: None (No IAP)

Categorization Tags

Puzzle Marble Shooter Match 3 Casual Single Player Offline Stylized

Full Store Description Preview

Embark on an ancient puzzle adventure with Zuma.io, the thrilling portrait marble-shooter game designed for puzzle lovers! Aim your frog totem, match vibrant spheres, and blast through rolling marble chains before they reach the sacred temple. Can you master the paths, trigger explosive combos, and conquer all 50 challenging levels across 5 mystical worlds?

Privacy by Design

Zuma.io collects zero personal data, requires no user account, and saves all game progress 100% locally on your device. Compliant with GDPR, CCPA, and Google Play Families Policy with transparent in-game consent controls.

Read Official Privacy Policy & Data Safety

Zuma.io Marble Shooter