EscapeTheLabGame v1.1.1 — nugetz
pkg
WaelKamel/ EscapeTheLabGame v1.1.1
Escape The Lab - A fast-paced AI-powered puzzle game where you have 10 minutes to solve 20 challenging questions. Features: Multiple AI providers (OpenAI GPT-4o, Claude Sonnet, Gemini, DeepSeek) | User authentication with online leaderboards | Database-driven event prompts for seasonal games | Auto-save/resume | Power-ups (Speed Boost, Micro Hint) | Real-time streaming responses | Cloud prompt support | Question types: IQ puzzles, logic challenges, coding problems, and mysteries. Play solo or compete globally!
Get Started dotnet CLI PackageReference Package Manager
$ dotnet add package EscapeTheLabGameReadme 🎮 Escape The Lab - AI-Powered Puzzle Game
A fast-paced, AI-driven escape room where you have 10 minutes to solve 20 challenging questions . Compete globally, unlock achievements, and test your skills against an intelligent AI game master!
🚀 Quick Start
Installation (Global Tool)
dotnet tool install -g EscapeTheLabGame
escape-lab
Update
dotnet tool update -g EscapeTheLabGame
✨ Features
🤖 Multiple AI Providers (NEW!)
OpenAI GPT-4o-mini (default, fastest & cheapest)Claude Sonnet 4.5 (most intelligent)Google Gemini 2.0 DeepSeek
🌐 Online Features
User Authentication - Secure password-protected accountsGlobal Leaderboards - Compete with players worldwide via SupabaseProfile Stats - Track games played, best scores, and ranksCloud Database - Centralized user management
🎯 Database-Driven Events (NEW in v1.1.0!)
Seasonal Prompts - Auto Christmas, New Year, Halloween eventsEvent Scheduling - Start/end dates for time-limited gamesMultiple Game Modes - Different challenges for varietyAuto-Activation - Events activate/deactivate automatically
💾 Smart Game Management
Auto-Save - Progress saved after every answer & every minuteResume Anytime - Pick up exactly where you left offGame History - All sessions stored as JSON logs
Local + Cloud Backup - Dual storage for safety
🎮 Gameplay
⚡ Real-time Streaming - Typewriter effect for AI responses🎨 Colorful CLI - Vibrant, readable interface⏱️ Time Pressure - 10-minute countdown with warnings🎯 Power-Ups - Speed Boost (skip) & Micro Hint (clue)📊 Scoring & Ranks - 5 achievement levels
📋 Requirements
.NET 8.0 Runtime or higher - Download AI API Key (choose one):
🛠️ Setup
Install as Global Tool (Recommended) # Install
dotnet tool install -g EscapeTheLabGame
# Run
escape-lab
Configuration (Optional) The game works out-of-the-box but you can customize settings.
Option 1: Environment Variable (Easiest)
# Windows
set OPENAI_API_KEY=sk-proj-your-key-here
# Linux/Mac
export OPENAI_API_KEY=sk-proj-your-key-here
Option 2: Config File
Find and edit appsettings.json in the tool directory:
{
"OpenAI": {
"ApiKey": "your-openai-api-key-here",
"Model": "gpt-4o-mini"
},
"Supabase": {
"Url": "https://your-project.supabase.co",
"AnonKey": "your-anon-key"
}
}
🎮 How to Play
Install & Launch
dotnet tool install -g EscapeTheLabGame
escape-lab
Create Account (Optional but Recommended)
Register with username, email, and password
Your scores sync to global leaderboard
Track your stats and compete worldwide
Or play as Guest (local scores only)
Start a New Game
Game loads the current active event prompt from database
Falls back to cloud or local prompt if needed
10-minute timer starts immediately
Answer 20 Questions
IQ puzzles and pattern recognition
Logic challenges and mysteries
Coding problems and algorithms
Tech scenarios and debugging tasks
Use Power-Ups Wisely
Type Speed Boost to skip tough questions (once per game)
Type Micro Hint for helpful clues (once per game)
Beat the Clock
Auto-saves after every answer
Resume anytime if interrupted
Final score and rank at the end
Note: Progress auto-saves every minute and after each answer!
🎯 Question Categories The game includes 20 questions across 3 categories:
IQ Puzzles (8 questions): Pattern recognition, logic puzzles, spatial reasoningMystery Challenges (6 questions): Whodunit scenarios, contradiction detectionDev Challenges (6 questions): String manipulation, algorithms, SQL queries
🏆 Ranking System
0-5 : Junior Human Lifeform6-10 : Bug Hunter in Training11-15 : Senior Logic Warrior16-19 : Elite Engineer20 : Legendary Cyborg Architect
⚙️ Settings Access the Settings menu to:
Toggle Streaming Mode : Enable/disable real-time response streamingChange Time Limit : Adjust from 5 to 15 minutesView Current Settings : See all configuration options
📂 Game Data All game data is stored in organized folders:
GameHistory/ - Completed games
leaderboard.json : Top scores from all playersgame_[PlayerName]_[Timestamp].json : Complete game transcripts SavedGames/ - In-progress games
savegame_[PlayerName]_[Timestamp].json : Saved game states
💾 Auto-Save Feature NEW! The game automatically saves your progress!
Auto-saves after each answer - Seamless and instantAuto-saves every 1 minute - Never lose progressStartup detection - Resume or start fresh when launchingTime remaining is preserved exactlyAll answers and progress are automatically saved See AUTO_SAVE_GUIDE.md for complete guide.
☁️ Cloud Prompts Feature NEW! Load game prompts from the cloud!
Google Drive - 15 GB free storageOneDrive - 5 GB free storageDropbox - Easy direct linksGitHub Gist - Best for version control (recommended)Any web server - Full control
Update questions without rebuilding the app
Central management for teams
Multiple prompt versions for different events
Works offline with caching
{
"Prompt": {
"UseCloudPrompt": true,
"CloudPromptUrl": "YOUR_CLOUD_URL_HERE",
"CachePrompt": true,
"FallbackToLocal": true
}
}
See CLOUD_PROMPT_GUIDE.md and CLOUD_SERVICES_GUIDE.md for complete instructions!
🎨 CLI Commands
Type your answer and press Enter (auto-saves after each answer)quit or exit : Exit game (asks to save first)Speed Boost : Use skip power-upMicro Hint : Get a hint Note: Game auto-saves every minute and after each answer!
🔧 Troubleshooting
"API Key not configured" Error Make sure you've replaced YOUR_ANTHROPIC_API_KEY_HERE in appsettings.json with your actual Anthropic API key.
"Configuration file not found" Error Ensure appsettings.json is in the same directory as the executable. If running with dotnet run, it should be in the project root.
Connection Issues
Check your internet connection
Verify your API key is valid and has available credits
Check Anthropic API status at https://status.anthropic.com/
🌟 Tips for High Scores
Think fast but carefully - wrong answers count against youUse power-ups strategically - save them for the hardest questionsRead questions thoroughly - some have tricky wordingPractice makes perfect - patterns repeat across playthroughs
📝 License This is a demonstration project showcasing Claude AI integration in C# console applications.
🤝 Contributing Feel free to fork this project and customize the game:
Add new question categories
Modify the Game Master personality
Add multiplayer features
Create themed question sets
📧 Support
Built with ❤️ using Claude Sonnet 4.5