https://github.com/bocaletto-luca/labyrinth
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. By Bocaletto Luca
https://github.com/bocaletto-luca/labyrinth
bocaletto-luca css3 game html5 javascript labyrinth labyrinth-game labyrinth-generator maze opensource responsive singleplayer webapp webgame
Last synced: about 2 months ago
JSON representation
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. By Bocaletto Luca
- Host: GitHub
- URL: https://github.com/bocaletto-luca/labyrinth
- Owner: bocaletto-luca
- License: gpl-3.0
- Created: 2025-06-01T22:36:55.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-10T10:41:17.000Z (about 1 year ago)
- Last Synced: 2025-06-10T11:37:23.190Z (about 1 year ago)
- Topics: bocaletto-luca, css3, game, html5, javascript, labyrinth, labyrinth-game, labyrinth-generator, maze, opensource, responsive, singleplayer, webapp, webgame
- Language: JavaScript
- Homepage: https://bocaletto-luca.github.io/
- Size: 52.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🏆 Labyrinth | Maze Explorer | Web Game 🚀
#### Author: Bocaletto Luca
---
[](https://bocaletto-luca.github.io/Labyrinth/)
---
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**! 😊
---