Buffer
Game.
Technical Specs
- Architecture: Kotlin Jetpack Compose
- AI Engine: 3-Tier Heuristic Matrix
- State Management: StateFlow + ViewModel
- Persistence: AndroidX DataStore Preferences
- Start Latency: AndroidX Core Splash API (0ms)
- UI Theme: #1A1D24 with #F58A27 Accents
Category
GAMEGallery
Project Narrative
Buffer is a high-speed, simultaneous-reveal logic game built natively for Android. It takes the core concept of Rock-Paper-Scissors and completely shatters it by introducing a 2-Round Memory Cooldown and a Heuristic AI Taunt Engine. You are not playing against a random number generator; you are playing against an algorithm that tracks your habits, analyzes your frequency, and actively trash-talks your blunders. The application is built entirely in Jetpack Compose, featuring state-driven rendering and a zero-latency tactical UI.
The Core Mechanics (The State Machine)
Players control two distinct actions simultaneously:
- The Right Hand (The State): Throw 1 to 5 fingers to set your state.
- The Left Hand (The Read): Throw 1 to 5 fingers to guess your opponent's state.
The "Buffer" (2-Round Cooldown)
When you play a number with your Right Hand, it enters your Buffer. You cannot legally play that number again for the next two rounds. This single rule forces the game to escalate from blind luck into algorithmic prediction. By Round 3, both players' available moves are constrained. You must manage your own legal options while reverse-engineering your opponent's remaining probability matrix. First to 3 points wins.
The Engine: 3-Tier Heuristic AI
The Bot in this game does not cheat; it simply out-thinks you. The AI is built on a custom heuristic engine with three distinct personality tiers:
Level 1: The Grunt
Functionally blind. Plays completely randomly.
Level 2: The Sniper
Mathematically perfect. It tracks your current Buffer and will never make an illegal guess. It also actively avoids guessing your previous throw.
Level 3: The Grandmaster
Tracks your soul. The Grandmaster cross-references your current available moves against your entire match history. It uses frequency analysis to predict the number you lean on when panicked, and employs a 20% "Double-Bluff" override.
The Psychological Taunt Engine
Inspired by the dynamic bots of Chess.com, Buffer features a zero-latency, offline Taunt Manager. The AI monitors the exact RoundResult state and reacts instantly:
- The Blunder Trap: If you waste your Read guessing a number that is currently locked in the Bot's Buffer (an impossible move), the engine detects the blunder and ruthlessly mocks your lack of working memory.
- The Bluff Reveal: If the Grandmaster successfully executes its Double-Bluff algorithm against you, it will explicitly tell you in the chat that it knew you were trying to outsmart it.
UI / UX Architecture
The application is built entirely in Jetpack Compose using modern Android development standards:
- State-Driven Rendering: Utilizing StateFlow and ViewModel, the UI organically morphs between "Selection Phase" and "Reveal Phase" on a single screen without jarring navigation changes.
- Tactical Aesthetic: Custom TacticalButton components, sharp corners (RoundedCornerShape(0.dp)), and a strict #1A1D24 dark theme accented with #F58A27 to mimic AAA-shooter loadout screens.
- Data Persistence: Integrated androidx.datastore.preferences to track user data and difficulty settings seamlessly.
- Zero-Latency Splash: Implementation of the modern AndroidX Core Splash Screen API for immediate, flash-free startup.
Installation Protocols
Buffer is a zero-dependency, fully offline game. Choose one of the verified installation pipelines below to deploy the package onto your device.
Direct Installation
Instantly retrieve and deploy the pre-compiled, production-ready package on your Android device.
- Enable "Install from Unknown Sources" in your Android system settings.
- Click the download action below to retrieve the direct verified APK package.
- Open the downloaded file and run the Android package installer.
Installation from GitHub
Audit the open-source Kotlin codebase, download public tags, or build the application from source.
- Access the official repository hosted on GitHub.
- Navigate to the Releases section to verify MD5/SHA256 checksums.
- Clone the repository to compile the source code via Gradle, or fetch pre-built assets.
Because this package is distributed directly and not signed through the Google Play Store, Android's Play Protect security layer may display a prompt flagging it as an "Unrecognized Developer." Sideloading is completely secure—simply click "More Details" followed by "Install Anyway" to complete the setup.