# Air Hockey

> Turn two Android smartphones into a single giant Air Hockey table connected top-to-top over local Wi-Fi or Mobile Hotspot with millimeter bezel gap compensation, instant QR Code pairing, split-screen mode, 100-stage progression, Elo rating leaderboard, and solo play against 3-tier AI.

## Quick Facts
- **Developer:** VMellos Dev (`https://vmellos.dev/`)
- **Android Package ID:** `dev.vmellos.airhockey`
- **Distribution Status:** Production (Google Play)
- **Category:** Arcade (GameApplication)
- **Operating System:** Android 8.0+ (minSdk 26)
- **Latest Documented Version:** 2.0.4
- **Download Footprint:** < 6 MB
- **Languages:** en, pt-BR, es
- **Official Portal:** https://airhockey.vmellos.dev/
- **Google Play URL:** https://play.google.com/store/apps/details?id=dev.vmellos.airhockey
- **Privacy Policy:** https://airhockey.vmellos.dev/privacy (Markdown: https://airhockey.vmellos.dev/privacy.md)
- **Terms of Use:** https://airhockey.vmellos.dev/terms (Markdown: https://airhockey.vmellos.dev/terms.md)
- **Contact:** contact@vmellos.dev

## Key Features
- Extended Table: connect two phones top-to-top over local Wi-Fi or Mobile Hotspot with bezel gap compensation
- 100% offline peer-to-peer local multiplayer via TCP/UDP sockets and mDNS without internet or game servers
- Instant QR Code pairing (airhockey://connect) in under 1 second
- Single-device Split-Screen multiplayer mode
- Solo mode vs Smart AI (Easy, Medium, Hard) with 100-stage progression
- Dynamic Elo rating system starting at 1,000 points and optional Google Play Games Services v2 cloud saves and global leaderboards
- Ultralight download under 6 MB

## Pricing & Monetization
- **Base App:** Free to download
- **Advertising:** Non-intrusive Google AdMob banners on menus and frequency-capped post-match interstitials (never during active gameplay), governed by Google UMP consent.
- **In-App Purchase (`remove_ads` — one_time_non_consumable):** Permanent Ad Removal — One-time Google Play Billing purchase to permanently remove banner and interstitial ads.

## Privacy & Permissions Summary
- Local-first gameplay and peer-to-peer local Wi-Fi/Hotspot multiplayer with no proprietary game servers
- Local storage via Android Jetpack DataStore and Room SQLite; no mandatory account creation
- Camera permission used strictly on demand to scan local pairing QR codes; no photos or frames saved or transmitted
- Location permission scoped strictly to Android 12 and below (maxSdkVersion 32) for legacy Wi-Fi/mDNS discovery; Android 13+ uses NEARBY_WIFI_DEVICES with neverForLocation
- Optional Google Play Games Services v2 (OAuth / SnapshotsClient / Leaderboards) and Google AdMob/UMP + Play Billing (remove_ads)

## Frequently Asked Questions
### Does Air Hockey 2P work completely offline without internet?
Yes. Solo AI, single-device split-screen, and two-phone local Wi-Fi or Mobile Hotspot multiplayer run 100% locally via TCP/UDP sockets and mDNS without requiring an internet connection or external game servers.

### How does the two-phone Extended Table mode connect?
One player hosts a table and displays a pairing QR code (airhockey://connect). The second player scans the QR code on demand over the same local Wi-Fi or Mobile Hotspot to join in under a second with bezel gap compensation.

### Is Air Hockey free and how do ads or purchases work?
Air Hockey is free to download on Google Play. It includes non-intrusive menu banners and post-match interstitials via Google AdMob (never during active gameplay), which can be permanently removed via an optional one-time 'remove_ads' in-app purchase.

### What are the Android requirements and app size?
Air Hockey requires Android 8.0 or higher (API 26+) and has an ultralight download footprint under 6 MB.

## Official Links
- https://play.google.com/store/apps/details?id=dev.vmellos.airhockey
- https://github.com/vmellos/AirHockey
