Ball King

**Ball King — Pixel Hoops, No Mercy**

Ball King is a retro pixel-art basketball shooter built for quick sessions and score-chasing. Grab the ball on the left, slingshot it toward the hoop on the right, and chain hits for a combo bonus. Miss and it costs a life — three strikes and you're out.

Gameplay
- Side-view pixel court: ball starts bottom-left, hoop sits top-right
- Long press on the ball to aim, drag down-left to charge (slingshot), release to shoot
- Ball flies along a real parabolic arc with gravity
- Must drop straight through the rim from above to score (clean swish only)
- Backboard and rim collisions bounce the ball realistically — bricks and rim-outs count as misses
- Missing a shot costs one life and resets the ball to the start point
- Three lives total; zero lives ends the game

Scoring & Combos
- Each made basket: base 1 point × combo multiplier
- Combo multiplier grows with consecutive hits, capping at 5x
- Chain milestones: ON FIRE (8), UNSTOPPABLE (16), LEGEND STUFF (32)
- A missed shot resets the combo to zero
- Watch a rewarded ad to activate 2x points for the rest of the run

Pages & Navigation
- MainActivity (home: best score, play button, navigation to all sections)
- GameActivity (core gameplay with live HUD: score, combo, lives, pause, 2x button)
- HowToPlayActivity (step-by-step rules)
- HistoryActivity (recent game records ranked by score)
- StatsActivity (best score, games played, total points, hit rate, best combo)
- SettingsActivity (sound, vibration, reduce-motion toggles, privacy policy)
- Secondary pages return to home; home uses double-back-to-exit

UX Features
- Pure multi-Activity navigation with a shared sub-page base (top bar + back-to-home)
- Custom pixel dialog with typewriter text reveal and playful copy
- Miss toasts with tongue-in-cheek lines ("Air ball. The crowd goes silent.")
- Pause dialog with resume / restart / quit options (back button during game)
- Game over dialog with score, best, and revive / restart / home buttons
- Edge-to-edge adaptation for status bar and bottom system area
- Portrait-locked game screen to prevent SurfaceView rebuilds

Visual Design
- Pixel Classic (pixel_classic) theme: 8-bit palette, all-zero corner radius, hard pixel shadows
- Monospace fonts with ALL CAPS, no anti-aliasing for crisp pixel edges
- Soul colors: CRT Orange (#FF6B35) basketball + Phosphor Yellow (#FFBE0B) aim line & score
- Custom SurfaceView rendering at 60fps with a dedicated render thread
- Aim trajectory shown as glowing yellow pixel dots, updated in real time while dragging
- Particle burst on score (yellow/green) and miss (red)

Ad Integration
- TradPlus SDK integrated through an independent module(12-network mediation)
- Rewarded ad: revive one life on game over(once per session)
- Rewarded ad: activate 2x score mid-run(once per session)
- Interstitial ad: shown before restart on game over(once per session)
- Frequency-capped per session to stay Google Play policy-friendly
- Ad unit IDs injected via manifest meta-data; graceful fallback when ads not ready

Technical Notes
- Kotlin
- XML Layout + custom Views(PixelButton / PixelTextView / PixelDialog)
- MVVM architecture(ViewModel + StateFlow/SharedFlow)
- Multi-Activity structure
- SurfaceView self-drawn rendering with GameRenderer(no anti-alias, integer-pixel alignment)
- Coroutine-based fixed-step game loop(~60fps)
- Pure-function physics & scoring(AimTrajectory, Scoring)for unit testing
- SharedPreferences for statistics and history(JSON-serialized)
- Java 17
- minSdk 26 / targetSdk 36 / compileSdk 36
- Android 16KB memory page alignment (useLegacyPackaging = false)
- Pixel Classic theme with CRT orange+phosphor yellow color scheme
- Lint abortOnError disabled to avoid blocking on ad SDK dependencies

Accessibility
- WCAG AA contrast (on_background vs background =15:1)
- Minimum 12sp text, minimum 48×48dp touch targets
- Reduce-motion toggle to flatten frame animations
- Vibration toggle for shot / score / miss feedback