BeatBattle 🎵

A multiplayer music quiz game for Android where players compete to identify songs from short audio clips.

Course: TDT4240 – Software Architecture, NTNU
Group: 07

Tech Stack

Platform: Android (API 26+)
Framework: LibGDX 1.12.x
Backend: Firebase Firestore (real-time sync)
Music API: Deezer API (30s previews)
Language: Java

Architecture

The project follows a layered MVC architecture with ECS for entity management:

User Interface    →  Screens & reusable UI components
Game Logic        →  Session, round, scoring, state management
Domain            →  Player, Song, GameSession, Submission, etc.
Infrastructure    →  Firebase gateway, audio provider, adapters

Dependencies flow one-directionally: UI → Game Logic → Domain ← Infrastructure

Project Structure

BeatBattle/
├── android/              # Android launcher & manifest
├── core/                 # Shared game code
│   └── src/main/java/group07/beatbattle/
│       ├── ui/
│       │   ├── screens/          # JoinGameScreen, LobbyScreen, QuizScreen, etc.
│       │   └── components/       # AnswerOptionBtn, TimerView, PlayerList
│       ├── logic/
│       │   ├── session/          # Session creation & joining
│       │   ├── round/            # Round flow & timing
│       │   ├── scoring/          # Score calculation & streaks
│       │   ├── state/            # StateManager & concrete states
│       │   └── api/              # SessionGateway, LeaderboardRepository, AudioProvider
│       ├── domain/
│       │   └── model/            # Player, Song, Question, Submission, etc.
│       └── infra/
│           ├── persistence/      # Firebase Firestore implementation
│           ├── sync/             # Real-time listeners
│           ├── audio/            # Deezer / local audio playback
│           └── adapters/         # Interface implementations
├── assets/                # Game assets (sprites, sounds, fonts)
├── build.gradle           # Root build config
└── settings.gradle

Getting Started

Prerequisites

JDK 17+
Android SDK (API 26+)
Android Studio (recommended)

Setup

Clone the repo:

git clone git@git.ntnu.no:milospi/TDT4240gr07-BeatBattle.git
cd BeatBattle

Add your google-services.json to android/ (get from Firebase Console — not committed to git)
Open in Android Studio or build from terminal:
```
./gradlew android:assembleDebug
```
Run on emulator or device:
```
./gradlew android:installDebug
```

Branching Strategy

Branch	Purpose
`main`	Stable, releasable code only
`dev`	Integration branch — PRs merge here
`feature/<name>`	New features (e.g. `feature/lobby-screen`)
`bugfix/<name>`	Bug fixes

Rules:

Never push directly to main or dev
All changes go through Pull Requests with at least 1 reviewer
Keep feature branches short-lived

Team

Name	Role
Anja Pedersen
Julie Hoel
Karya Vindstad
Kristoffer Welle
Milos Pilipovic
Mostafa Saleh
Oda Aasen Kjerstad

milospi/TDT4240gr07-BeatBattle

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Contributors 6

Languages

Packages