Bottle Sort Puzzle – Android Game (Java, Native UI)

Calming bottle-sort puzzle with 500 handcrafted levels, undo/restart/hints, dark mode, smooth canvas bottles, and ready hooks for AdMob/IAP monetization. Built entirely in Android Studio (Java, API 23+).Bottle Sort Puzzle is a complete, production-ready bottle sorting puzzle game where players tap bottles to pour colored liquid until every bottle contains only one color.The project includes a deterministic 500-level progression system, smooth animations, sound effects, dark/light themes, star-based scoring, and persistent player progress.The game is written entirely in pure Java using custom Canvas rendering. No external game engines or heavy third-party SDKs are used. This makes it lightweight, fast, and easy to customize or reskin for publishing on the Play Store.Perfect for developers who want to quickly launch a puzzle game with ads, expand gameplay, or rebrand the project.
Key Features
500 Solvable Levels with progressive difficulty (3–8 colors, 5–10 bottles).
Smart Hint System using BFS solver highlighting source and target bottles.
↩️ Unlimited Undo and instant restart for every level.
⭐ Star Rating System based on move efficiency.
Automatic Progress Save using SharedPreferences.
Dark Mode + Light Mode with in-app toggle.
Responsive Bottle Grid (3 or 4 columns depending on screen).
Custom BottleView with selection bounce, smooth pouring animation, shimmer effects, and win overlay.
Sound Effects via SoundPool (pour, click, win, error).
Level Select Screen with lock/unlock progression and star indicators.
⏸ Pause Menu, About screen, and How-to-Play overlay.
Share Intent to share the game.
⚙️ ProGuard Optimized release build.
Monetization Ready with prepared hooks for AdMob interstitials and in-app purchases.
Technical Details
IDE: Android Studio Giraffe / Koala or newer
Language: Java
Android Gradle Plugin: 8.12.3
JDK Compatibility: Java 8 (source/target)
Compile SDK: 36
Target SDK: 36
Minimum SDK: 23 (Android 6.0+)
Gradle: Wrapper included (auto download on first sync)
Dependencies:
AndroidX AppCompat
Material Components
ConstraintLayout
RecyclerView
CardView
No external game engines or heavy libraries are used.