🏆 Labyrinth | Maze Explorer | Web Game 🚀

Author: Bocaletto Luca

---

---

Welcome to Labyrinth | Maze Explorer! 🎮
This is a fun and interactive web game where players solve randomly generated mazes by tracing a path using the W, A, S, D keys. The maze is generated dynamically, and you can save your solved maze as PNG, JPG, or PDF.

⭐ GAME HIGHLIGHTS ⭐

• 🏗️ Random Maze Generation using the recursive backtracking algorithm
• 🟩 Start Cell: Highlighted in Green (Top‑left corner, (0,0))
• 🟥 Finish Cell: Highlighted in Red (Bottom‑right corner)
• 🟦 Path Drawing: Use W, A, S, D to trace a blue path
• 🔄 Backtracking Allowed: Undo steps by retracing your path
• 🎉 Game Completion: Dialog prompts a choice to start a new maze or exit
• 📤 Export Options: Save maze as PNG, JPG, or PDF
• 🛑 Prevents Page Scrolling: Moving with WASD does not scroll the page

---

🎮 How to Play

1️⃣ Generate a Maze
Click the "Generate New Maze" button to create a new maze. The game will highlight the Start Cell (Green) and the Finish Cell (Red).

2️⃣ Move Through the Maze
Use the W, A, S, D keys to trace your path:

• W: Move Up ⬆️
• A: Move Left ⬅️
• S: Move Down ⬇️
• D: Move Right ➡️
  Your path is drawn in blue. If you backtrack, the last step is removed.

3️⃣ Complete the Maze
Once your blue path reaches the Finish Cell, a message will appear:

• ✅ Click OK to generate a new maze (clears previous solution)
• ❌ Click Cancel to exit the game

4️⃣ Export Your Maze
Use the export buttons below the canvas to download your solved maze as PNG, JPG, or PDF.

---

🚀 Features

✔️ Fully Interactive Maze Solver
✔️ Lightweight Web Game (No Installation Required)
✔️ Dynamic Path Tracing (Backtracking Supported)
✔️ Auto-Clearing Previous Solutions when generating new mazes
✔️ Prevent Default Page Scrolling when using movement keys
✔️ Built-in Export Options (PNG, JPG, and PDF)

---

🏗️ Technologies Used

• 🔵 HTML5 Canvas for rendering the maze
• 🎨 JavaScript for maze generation & interaction
• 📜 CSS for styling
• 🖼️ jsPDF for PDF export
• 🖱️ Event Listeners for keyboard movement controls

---

📤 Export Options

Want to save your maze? Use the built-in export buttons:

• 🖼️ PNG Export: Saves your maze as a high-quality PNG image
• 📸 JPG Export: Saves your maze as a JPG photo
• 📜 PDF Export: Saves your maze as a PDF file (powered by jsPDF)

---

💡 Roadmap

💡 Future Improvements:

• ⏳ Timed Mode ⏱️ (Challenge yourself to solve the maze quickly)
• 🏆 Leaderboard Support (Track best completion times)
• 🌐 Multiplayer Mode (Race against friends to solve mazes)

If you'd like to contribute, feel free to submit feature suggestions or pull requests! 😊

---

🎨 Screenshots

🔎 Example Maze Preview:
(Insert sample images of the maze in action)

📤 Exported Maze Example:
(Include an exported PNG/JPG/PDF sample)

---

📜 Author

👨‍💻 Bocaletto Luca

Made with ❤️ and JavaScript!
If you enjoy Labyrinth - Maze Explorer, feel free to ⭐ star the repository or contribute to its development. 🚀

---

🔗 License

This project is licensed under the GPLv3 License.
Feel free to use, modify, and distribute it freely! 😊

---