CodeBreaker is a modern, high-fidelity web adaptation of the classic pen-and-paper game Cows and Bulls (the predecessor to Mastermind).
Unlike simple guessing games, CodeBreaker is a test of pure logic. The goal is to crack a secret numeric code by interpreting feedback from your previous guesses. It features a hacker-inspired dark UI, advanced game modes, and a "Detective" toolset to help you deduce the answer.
CodeBreaker now supports a full 1v1 Multiplayer Protocol:
- Lobby System: Create private rooms and invite friends via direct links.
- Real-Time Synchronization: Powered by Socket.IO for sub-millisecond guess updates.
- Comms Link (Chat): Integrated high-speed chat with unread message badges.
- Ready-Up Mechanic: Both players must acknowledge readiness before the mission starts.
- Visual Competition: Track your opponent's attempts in real-time with the dynamic VS bar.
The game scales from casual practice to impossible logic puzzles.
| Difficulty | Length | Repeats? | Attempts | Description |
|---|---|---|---|---|
| Rookie | 3 | ❌ | 10 | The perfect warm-up. |
| Standard | 4 | ❌ | 10 | The classic experience. |
| Expert | 5 | ❌ | 12 | For seasoned logicians. |
| Master | 4 | ✅ | 12 | Repeats allowed. Standard logic fails here. |
| INSANE | 6 | ✅ | 15 | The ultimate challenge. Good luck. |
- ⚡ Rush Mode (Timer): A 3-minute countdown to ramp up the pressure.
- ♾️ Infinity Mode: Removes the attempt limit and enables an infinite scrolling grid that generates new rows as you play.
- Smart Notepad: Right-click (PC) or Long-Press (Mobile) any number on the keypad to cross it out. This visual aid is crucial for elimination logic.
- Hint System: Stuck? Request a hint to reveal one correct digit (Limited to 2 per game).
- Stat Tracking: Persistent local storage tracks your Games Played, Win %, and Current Streak.
- Mute System: Dedicated audio controls for a focused deduction environment.
- Resign Protocol: Verified surrender mechanism to reveal the code if the logic becomes too heavy.
- Winner Confetti: Personalized victory celebrations for the successful operator.
CodeBreaker has been upgraded to a Premium Glassmorphic Design:
- Blurred Modals: "Field Manual" and "Comms Link" use advanced CSS backdrop filters for a frosty, modern feel.
- Responsive Architecture: A custom grid system ensures a pixel-perfect experience from desktop monitors down to the smallest mobile devices.
- Adaptive Header: A perfectly centered HUD that redistributes tools based on screen real estate.
- Dark Mode Native: Deep #121213 palette optimized for long-duration logic sessions.
The computer generates a secret code. You make a guess, and the system gives you feedback using colored dots:
- 🟢 BULL (Green Dot): Correct Number in one of the given Spots.
- 🟡 COW (Yellow Dot): Correct Number, Wrong Position.
- ⚫ GRAY (Empty Dot): That number does not exist in the code.
- ⚪ HOLLOW (Outline): Waiting for your next input.
⚠️ CRITICAL RULE: The order of the feedback dots is shuffled. They do not correspond to the position of the numbers in your guess! You must use pure deduction to link numbers to dots.
| Splash Screen | Gameplay (Insane) | Victory Screen |
|---|---|---|
 " |
 |
 |
This project uses a Decoupled Architecture for stability.
- Backend (Python/Flask): Handles the secret code generation, validation logic, and session management. The secret code is never sent to the client until the game ends, preventing cheating via "Inspect Element."
- Frontend (HTML/JS): * Golden Master Script: A single, robust JavaScript engine handles all game logic, timers, and UI updates across all difficulty levels.
- Responsive Design: Uses
100dvhand Flexbox to provide a native-app feel on mobile devices while maintaining a desktop-first precision experience.
- Responsive Design: Uses
- Visuals: Custom CSS animations (Shake effects), Canvas Confetti, and a responsive layout that handles "Safe Areas" on modern smartphones.
Want to run the logic engine on your own machine?
-
Clone the Repo:
git clone https://github.com/CaSh007s/codebreaker.git cd codebreaker -
Create Environment:
# Windows python -m venv venv venv\Scripts\activate # Mac/Linux python3 -m venv venv source venv/bin/activate
-
Install Dependencies:
pip install -r requirements.txt
-
Run the Server:
python app.py
Access the game at
http://127.0.0.1:5000.
Distributed under the MIT License. See LICENSE for more information.
Made with ❤️ and Logic