System Requirements Document (SRD)

Project Name: starry-game

1. Introduction

The purpose of this System Requirements Document (SRD) is to outline the requirements for the mobile game app "Bubble Shooter Master", a project under the umbrella of starry-game. This document serves as a comprehensive guide for the development, design, and implementation of the game.

Bubble Shooter Master is a classic bubble shooter game designed for Android devices. The game aims to provide an engaging and colorful experience where players shoot bubbles to match and pop groups of three or more. The game will feature multiple levels, power-ups, a coin system, and monetization strategies to ensure both player satisfaction and project sustainability.

This document is tailored for USATarend, based in India (IN), and considers locale-specific defaults such as INR currency for in-game purchases and IST (Indian Standard Time) for daily rewards.

2. System Overview

Bubble Shooter Master is a mobile game that combines skill, strategy, and fun. The game will feature:

• A colorful, cartoon-style user interface.
• Smooth animations and sound effects for an immersive experience.
• Levels with increasing difficulty to keep players engaged.
• Power-ups and a coin system to enhance gameplay.
• Monetization through rewarded ads, interstitial ads, and an in-game shop.

The game will be optimized for low-end Android devices to ensure accessibility for a wide audience.

3. Functional Requirements

Core Features

• As a Player, I should be able to drag to aim and release to shoot a bubble.
• As a Player, I should see a dotted aiming line to guide my shots.
• As a Player, I should be able to match 3+ bubbles of the same color to pop them.
• As a Player, I should see bubbles fall when disconnected from the main cluster.
• As a Player, I should be able to progress through at least 50 levels with increasing difficulty.
• As a Player, I should encounter different bubble patterns in each level.
• As a Player, I should be able to use power-ups like Bomb Bubble, Rainbow Bubble, and Fireball.
• As a Player, I should earn points for popping bubbles and receive bonuses for combos.
• As a Player, I should be able to access the following game states: Start Screen, Gameplay Screen, Pause Menu, Game Over Screen, and Level Complete Screen.
• As a Player, I should experience smooth and responsive touch controls.
• As a Player, I should be able to watch rewarded ads to continue playing after losing.
• As a Player, I should see interstitial ads between levels.
• As a Player, I should hear background music and sound effects, with an option to toggle sound on/off.
• As a Player, I should receive daily rewards to encourage regular gameplay.
• As a Player, I should earn coins and spend them in the in-game shop.
• As a Player, I should be able to save my progress.
• As a Player, I should be able to share my score and invite friends to play.

4. User Personas

1. Player

• Description: The primary user of the game.
• Goals: To enjoy the game, progress through levels, and achieve high scores.
• Motivations: Fun, challenge, and rewards.
• Pain Points: Laggy performance, unresponsive controls, and lack of engaging content.

2. Admin

• Description: The game administrator responsible for managing updates, ads, and analytics.
• Goals: To ensure smooth operation and monitor monetization performance.
• Motivations: High player retention and revenue generation.
• Pain Points: Complex backend systems and poor analytics tools.

5. Visuals Colors and Theme

Color Palette

• Background: #A3DFF2 (Soft Sky Blue)
• Surface: #F7E8A9 (Warm Sand Yellow)
• Text: #2B2B2B (Deep Charcoal)
• Accent: #FF6F61 (Vibrant Coral)
• Muted: #B2B2B2 (Soft Gray)

The theme will feature a soft gradient background resembling a sky or jungle, with vibrant bubble colors (red, blue, green, yellow, purple) to maintain a playful and engaging aesthetic.

6. Signature Design Concept

The home screen of "Bubble Shooter Master" will feature an interactive floating bubble cluster. The bubbles will gently sway and bounce as if floating in a soft breeze. When a player taps on a bubble, it will pop with a satisfying animation and sound, revealing the menu options (e.g., Play, Shop, Settings).

Key Features:

• Dynamic Animations: The bubble cluster will respond to touch, creating a playful and interactive experience.
• Color Transitions: The background gradient will subtly shift colors over time, creating a calming effect.
• Micro-Interactions: Hovering over menu options will cause them to glow and slightly enlarge.

This design will make the game feel alive and immediately captivate the player’s attention.

7. Non-Functional Requirements

• The game must load within 5 seconds on low-end Android devices.
• The app size should not exceed 50 MB.
• The game should maintain a consistent frame rate of 60 FPS.
• The codebase must be clean, modular, and well-documented.
• The game should support Android versions 5.0 (Lollipop) and above.

8. Tech Stack

Frontend

• Unity (C#) for game development.

Backend

• Python with FastAPI for managing player data and analytics.

Database

• MySQL for storing player progress and shop data.

AI Tools

• Google Nano Banana for generating in-game assets like bubble designs.

Orchestration

• Docker for local development.

9. Assumptions and Constraints

• Players will primarily use Android devices with touch controls.
• The game will be free-to-play with optional in-app purchases.
• Monetization will rely on ads and in-game purchases.
• The game will not require an internet connection for core gameplay but will need it for ads and saving progress.

10. Glossary

• Bubble Shooter: A game where players shoot bubbles to match and pop groups of three or more.
• Power-ups: Special items that provide advantages during gameplay.
• Interstitial Ads: Full-screen ads displayed between levels.
• Rewarded Ads: Ads that players can watch to earn rewards.
• Daily Rewards: Incentives given to players for logging in daily.