🧠 Sudoku Console Game (Java)

Welcome to the Sudoku Console Game, a fully-functional Java-based terminal application with four difficulty modes, real-time validation, lives system, and leaderboard tracking — all powered by clean, object-oriented Java code.

---

📌 Project Highlights

• ✅ Java Console-based Game
• 🎯 Difficulty Modes: Easy, Medium, Hard, Extreme
• 🧠 Smart Sudoku Puzzle Generator with unique board each run
• 💾 Leaderboards saved to .txt files by difficulty
• ⏱️ Real-time Timer
• 🔁 Re-editing & Cell Locking logic
• ❌ Mistake tracking + Lives system
• 📁 Organized folder structure (results/, logic classes)

---

🎮 How to Play

1. Launch the game and enter your name
2. Select a difficulty:
   • easy
   • medium
   • hard
   • extreme
3. A unique Sudoku puzzle will be generated.
4. Input the row, column, and number to fill a cell.
5. Complete the board under the rules of your selected difficulty!

---

📝 Game Rules

• Fill the board such that each number 1–9 appears only once in each row, column, and 3x3 grid.
• Pre-filled cells cannot be edited
• Input format:
  Row index (0–8): Column index (0–8): Number (1–9):

---

🔒 Difficulty Constraints

Difficulty	Lives	Feedback	Re-editing	Mistake Effect
Easy	Infinite	✅ Yes	✅ Yes	Shows Correct/Wrong
Medium	Infinite	❌ No	✅ Yes	Silent Error
Hard	5 lives	❌ No	✅ Yes	Wrong answer costs 1 life
Extreme	3 lives	❌ No	❌ No	Cell locks + Game Over

---

🏆 Leaderboards

• Leaderboards are saved per difficulty in the results/ folder: results/ ├── leaderboard_easy.txt ├── leaderboard_medium.txt ├── leaderboard_hard.txt └── leaderboard_extreme.txt

Each record contains:

• Player Name
• Time Taken
• Difficulty

---

💻 How to Run

Compile:

javac Main.java
java Main

---

🌟 Uniqueness & Highlights

• Implements Extreme Difficulty mode with real penalty logic (locked cells, no re-editing, lives)
• User-specific leaderboard system
• Clean object-oriented Java code — perfect for showcasing your Java proficiency
• Clear input validation and gameplay rules
• Prepares for extension into GUI (JavaFX) and Web (React/JS) versions

---

📌 Author

Developed with passion and precision by Chinmaya Jena Console version completed in a single day with strong Java fundamentals. GUI version (JavaFX) and full web-based version (React + backend) in development. This project showcases fast development, structured coding, and readiness for scaling into full-stack apps.

---

🧩 Ready to Challenge Yourself?

Fire up the console and see how fast (and smart) you are with numbers! Good luck!

---