A single-player digital version of the classic Clue/Cluedo board game with AI opponents
Play the detective mystery game solo! ClueSolo brings the beloved board game experience to your browser with authentic 1949 CLUEDO styling, allowing you to practice deduction skills against AI opponents of varying difficulty levels.
The CLUEDO Classic Edition - Complete visual redesign!
- 🎨 Authentic 1949 CLUEDO theme - Vintage red, cream, and green colors from the original box
- ✅✗ Two-way deduction system - Track both what you know AND what you've ruled out
- 🎯 Smart category elimination - When suspect found, all others auto-eliminate
- 📊 Unified casebook grid - All cards in one streamlined table
- 🎲 25% more compact - Better fit on screens with optimized spacing
- 📁 Case File authenticity - Manila envelope styling with "CONFIDENTIAL" stamp
- Normal Play: Control your character and make all the deduction decisions
- AI Coach Mode: AI suggests optimal moves while you maintain control (perfect for learning!)
- 🌞 Basic (Easy): Simple "I saw it" logic, great for beginners
- 🧠 Smart (Medium): Advanced deductions with two-way elimination tracking
- 🔍 Sherlock (Hard): Probabilistic AI with hand capacity inference and Bayesian reasoning
- ✅ Checkmark - You own this card (or it's in the Case File)
- ✗ X-mark - This card is ruled out / eliminated
- ? Question mark - Unknown / maybe
- 🚩 Flag - Confirmed guilty (Case File only)
Track both positive AND negative information, just like playing with paper!
- Classic Clue-style unified deduction grid with all cards in one view
- Auto-populated hints in Coach Mode showing complete AI reasoning
- Deduction log displaying AI thought process (Smart & Sherlock modes)
- Probability bars for Sherlock difficulty showing likelihood
- Category elimination - See entire categories ruled out at once
- Persistent notes for tracking your own observations
- 📱 Fully responsive - works on desktop, tablet, and mobile
- 💾 Auto-save - your notes and grid persist between sessions
- 🎨 Authentic vintage CLUEDO theme with aged paper textures
- ⚡ Zero dependencies - single HTML file, works offline
- 🎯 No installation - just open and play
- 🚀 Optimized performance - 30% faster AI deductions
Visit: https://andreas-breidenthal.github.io/ClueSolo/
- Download
index.htmlfrom latest release - Double-click to open in any modern web browser
- Start playing!
- Choose your difficulty level (Basic, Smart, or Sherlock)
- Select number of opponents (2-5 AI players)
- Choose game mode (Normal Play or AI Coach)
- Pick your suspect character
- Roll dice to move around the mansion
- Make suggestions when you enter a room
- Track clues using the unified deduction grid
- Mark eliminations with ✗ when cards are ruled out
- Watch categories auto-eliminate when one is confirmed
- Make an accusation when you're confident
- Win by correctly identifying the murderer, weapon, and room!
- Mark both ✅ and ✗ - The more you eliminate, the faster you solve!
- Watch category elimination - When one suspect is guilty, all others are innocent
- Use Coach mode to learn the AI's two-way deduction strategy
- Read the deduction log (Smart/Sherlock) to understand advanced reasoning
- Check probability bars (Sherlock) to see which cards are most likely
- Start with AI Coach mode on Basic difficulty to learn the game
- Progress to Smart difficulty to see elimination logic in action
- Watch the deduction log to understand AI reasoning
- Use the notes field to track your observations
- Try Sherlock mode for probabilistic thinking challenges
This game was created to help a 10-year-old learn deduction and logical reasoning skills. The v2.0 two-way deduction system makes it an even better teaching tool for:
- Deductive reasoning - Process of elimination
- Positive vs negative information - What you know AND don't know
- Categorical thinking - When one is true, others are false
- Probability concepts (Sherlock mode)
- Strategic thinking - Efficient information gathering
- Pattern recognition - Hand capacity constraints
- Systematic note-taking - Organized tracking
Perfect for ages 8-14 with progressive difficulty levels!
- Pure HTML5 + CSS3 + Vanilla JavaScript
- No frameworks, no build process, no dependencies
- Single-file architecture for maximum portability
- Clean, commented code with section markers for easy navigation
The code is organized into clear sections:
[SECTION 1]Utilities & Error Handling[SECTION 2]Game Constants[SECTION 3]Player Class (enhanced with notOwners tracking)[SECTION 4]Main Game Class[SECTION 5]AI Logic (enhanced with category elimination)[SECTION 6]Game Flow Functions[SECTION 7]User Interface Prompts[SECTION 8]UI Rendering - Players & Cards[SECTION 9]UI Rendering - Unified Notebook Grid[SECTION 10]UI Rendering - Board[SECTION 11]Game Initialization
Use Ctrl+F and search for [SECTION X] to jump to any section.
The code includes detailed comments for non-coders. Common customizations:
- Colors: Search for "COLOR CUSTOMIZATION" to find authentic CLUEDO palette
- Game rules: Modify constants in
[SECTION 2] - AI behavior: Adjust logic in
[SECTION 5] - UI layout: Edit CSS in
<style>section - Fonts: Broadway (logo), Algerian/Copperplate (headers)
- Two-way tracking:
knownOwners+notOwnersMaps - Category intelligence: Auto-elimination of category siblings
- Unified rendering: Single grid function for all cards
- Enhanced metadata: Comprehensive card status tracking
- Optimized spacing: 25% more compact layout
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
See CHANGELOG.md for version history.
Add screenshots here showing:
- Vintage CLUEDO-themed game board
- Unified deduction grid with ✅ and ✗ marks
- AI Coach mode with two-way deduction
- Manila envelope Case File
- Category elimination in action
- ✅ Chrome/Edge (latest)
- ✅ Firefox (latest)
- ✅ Safari (latest)
- ✅ Mobile browsers (iOS Safari, Chrome Mobile)
Tested on: Desktop, tablet, and mobile devices
- None currently! Please report issues if you find any.
-
v2.0.0 (2026-02-03) - The CLUEDO Classic Edition
- Complete visual redesign to authentic 1949 CLUEDO theme
- Two-way deduction system (✅ + ✗)
- Unified casebook grid
- Enhanced AI with category elimination
- 25% more compact layout
-
v1.0.0 (2026-02-01) - Initial Release
- First public release with dark theme
- Basic deduction grid
- Three AI difficulty levels
See CHANGELOG.md for detailed version history.
- Inspired by the classic Clue/Cluedo board game by Hasbro (1949)
- Authentic color palette from vintage CLUEDO box design
- Original concept assistance from Microsoft Copilot
- Code organization and feature refinement by Claude (Anthropic)
- Built for educational purposes to teach deduction skills
This project is licensed under the MIT License - see the LICENSE file for details.
Note: This is a fan-made educational project. Clue/Cluedo is a trademark of Hasbro. This project is not affiliated with, endorsed by, or sponsored by Hasbro.
- Live Demo: Play ClueSolo
- Latest Release: v2.0.0
- Changelog: CHANGELOG.md
- Report Bug: GitHub Issues
- Request Feature: GitHub Issues
Have questions or feedback? Feel free to open an issue!
Made with ❤️ for learning and fun
Classic CLUEDO styling meets modern web technology