Documentación Técnica | Bounce Royale

Stack Tecnológico

Selección de herramientas pensada para rendimiento móvil, lógica arcade en tiempo real, monetización y escalabilidad multiplataforma.

⚡ Core Framework

Flutter como base principal para crear una interfaz fluida, responsiva y compilada de forma nativa para móviles.

🎮 Game Engine

Flame Engine para manejar el game loop, renderizado 2D, entidades, colisiones y comportamiento arcade.

💰 Monetización

Integración con anuncios recompensados, banners, interstitials y compras dentro de la app para desbloqueos o beneficios.

🌐 Multiplataforma

Código base preparado para Android e iOS, con adaptación visual y técnica para distintos tamaños de pantalla.

Sistemas del Juego

Bounce Royale combina físicas simples, control táctil, progresión visual y mecánicas competitivas para mantener partidas rápidas y adictivas.

🕹️ Control One-Tap

Sistema de entrada táctil diseñado para que el jugador controle saltos y rebotes con una interacción sencilla.

🧱 Colisiones

Lógica de rebote, obstáculos, paredes y detección de impacto para generar tensión en cada movimiento.

🔥 Modo Fever

Mecánica especial que premia la precisión del jugador al encadenar rebotes y activar momentos de alta intensidad.

🎁 Recompensas

Sistema de monedas, cajas misteriosas, cartas, skins y progresión para incentivar la repetición de partidas.

Dependencias Clave

Librerías y paquetes recomendados para la arquitectura del proyecto móvil, monetización, persistencia, audio y servicios externos.

flame

flame_audio

google_mobile_ads

in_app_purchase

shared_preferences

flutter_native_splash

games_services

package_info_plus

url_launcher

intl

cupertino_icons

flutter_localizations

Arquitectura del Proyecto

Estructura modular para separar el núcleo del juego, pantallas, servicios, economía, tienda, audio y persistencia local.

lib/
├── main.dart // Punto de entrada, configuración inicial y arranque de servicios
├── game/ // Núcleo del juego y lógica Flame
│   ├── components/ // Player, obstáculos, paredes, monedas, power-ups
│   ├── systems/ // Colisiones, física, spawning, fever, score
│   └── managers/ // GameManager, ArenaManager, MatchManager
├── screens/ // Menú principal, juego, tienda, ajustes, game over
├── services/ // Ads, compras, audio, storage, analytics, restore purchases
├── models/ // Skin, reward, loot box, player profile, purchase item
├── ui/ // Widgets reutilizables, botones, cards, overlays
└── l10n/ // Internacionalización y textos por idioma
                

Patrones de Diseño

Component-Based: entidades separadas para jugador, obstáculos, recompensas y elementos de arena.
Service Layer: servicios independientes para anuncios, compras, audio y almacenamiento.
Overlay UI: separación entre lógica Flame y pantallas Flutter para menús, tienda y ajustes.

Optimización

Object Pooling: reutilización de obstáculos y efectos para evitar picos de memoria.
Asset Optimization: imágenes comprimidas y audio optimizado para cargas rápidas.
Mobile Performance: ajustes para mantener fluidez en dispositivos de gama media.

Ficha Técnica

Resumen de sistemas internos y decisiones técnicas aplicadas para sostener la experiencia arcade.

Gameplay Core

Motor de física 2D para rebotes y colisiones.
Sistema de dificultad progresiva.
Control táctil de baja latencia.
Modo Fever basado en encadenamiento de acciones.

Economía y Progresión

Sistema de monedas y recompensas.
Cajas misteriosas y rarezas de skins.
Compras dentro de la aplicación.
Restauración de compras no consumibles.

Servicios

Publicidad recompensada e interstitials.
Persistencia local de progreso.
Soporte para políticas de privacidad y términos.
Preparación para integración con servicios externos.

Experiencia Mobile

Diseño orientado a pantallas verticales.
Interfaz adaptable a Android e iOS.
Animaciones ligeras y respuesta rápida.
Assets pensados para carga eficiente.

Arquitectura Técnica