{"id":28796217,"url":"https://github.com/bocaletto-luca/labyrinth","last_synced_at":"2026-04-21T16:37:48.542Z","repository":{"id":296770941,"uuid":"994423796","full_name":"bocaletto-luca/Labyrinth","owner":"bocaletto-luca","description":"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","archived":false,"fork":false,"pushed_at":"2025-06-10T10:41:17.000Z","size":54,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-10T11:37:23.190Z","etag":null,"topics":["bocaletto-luca","css3","game","html5","javascript","labyrinth","labyrinth-game","labyrinth-generator","maze","opensource","responsive","singleplayer","webapp","webgame"],"latest_commit_sha":null,"homepage":"https://bocaletto-luca.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bocaletto-luca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-01T22:36:55.000Z","updated_at":"2025-06-10T10:41:21.000Z","dependencies_parsed_at":"2025-06-02T08:39:00.486Z","dependency_job_id":"8268798c-ec88-49ab-9102-8c1a80bfbb86","html_url":"https://github.com/bocaletto-luca/Labyrinth","commit_stats":null,"previous_names":["bocaletto-luca/labyrinth"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bocaletto-luca/Labyrinth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FLabyrinth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FLabyrinth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FLabyrinth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FLabyrinth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bocaletto-luca","download_url":"https://codeload.github.com/bocaletto-luca/Labyrinth/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FLabyrinth/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260477919,"owners_count":23015068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bocaletto-luca","css3","game","html5","javascript","labyrinth","labyrinth-game","labyrinth-generator","maze","opensource","responsive","singleplayer","webapp","webgame"],"created_at":"2025-06-18T03:11:39.335Z","updated_at":"2026-04-21T16:37:48.527Z","avatar_url":"https://github.com/bocaletto-luca.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏆 Labyrinth | Maze Explorer | Web Game 🚀  \n#### Author: Bocaletto Luca\n---\n\n[![Test Online](https://img.shields.io/badge/Test%20Online-Click%20Here-brightgreen?style=for-the-badge)](https://bocaletto-luca.github.io/Labyrinth/)\n\n---\n\nWelcome to **Labyrinth | Maze Explorer**! 🎮  \nThis 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**.  \n\n⭐ **GAME HIGHLIGHTS** ⭐  \n- 🏗️ **Random Maze Generation** using the recursive **backtracking algorithm**  \n- 🟩 **Start Cell:** Highlighted in **Green** (Top‑left corner, (0,0))  \n- 🟥 **Finish Cell:** Highlighted in **Red** (Bottom‑right corner)  \n- 🟦 **Path Drawing:** Use **W, A, S, D** to trace a **blue path**  \n- 🔄 **Backtracking Allowed:** Undo steps by retracing your path  \n- 🎉 **Game Completion:** Dialog prompts a choice to start a **new maze** or **exit**  \n- 📤 **Export Options:** Save maze as **PNG, JPG, or PDF**  \n- 🛑 **Prevents Page Scrolling:** Moving with WASD does not scroll the page  \n---\n\n## 🎮 How to Play  \n\n**1️⃣ Generate a Maze**  \nClick the **\"Generate New Maze\"** button to create a new maze. The game will highlight the **Start Cell (Green)** and the **Finish Cell (Red)**.\n\n**2️⃣ Move Through the Maze**  \nUse the **W, A, S, D keys** to trace your path:  \n- **W**: Move **Up** ⬆️  \n- **A**: Move **Left** ⬅️  \n- **S**: Move **Down** ⬇️  \n- **D**: Move **Right** ➡️  \nYour path is **drawn in blue**. If you backtrack, the last step is removed.\n\n**3️⃣ Complete the Maze**  \nOnce your blue path reaches the **Finish Cell**, a message will appear:  \n- ✅ Click **OK** to generate a **new maze** (clears previous solution)  \n- ❌ Click **Cancel** to **exit the game**  \n\n**4️⃣ Export Your Maze**  \nUse the **export buttons** below the canvas to **download your solved maze** as PNG, JPG, or PDF.\n\n---\n\n## 🚀 Features  \n\n✔️ **Fully Interactive Maze Solver**  \n✔️ **Lightweight Web Game** (No Installation Required)  \n✔️ **Dynamic Path Tracing** (Backtracking Supported)  \n✔️ **Auto-Clearing Previous Solutions** when generating new mazes  \n✔️ **Prevent Default Page Scrolling** when using movement keys  \n✔️ **Built-in Export Options** (PNG, JPG, and PDF)  \n\n---\n\n## 🏗️ Technologies Used  \n\n- 🔵 **HTML5 Canvas** for rendering the **maze**\n- 🎨 **JavaScript** for **maze generation \u0026 interaction**\n- 📜 **CSS** for styling\n- 🖼️ **jsPDF** for **PDF export**\n- 🖱️ **Event Listeners** for **keyboard movement controls**\n\n---\n\n## 📤 Export Options  \n\nWant to save your maze? Use the built-in **export buttons**:  \n\n- 🖼️ **PNG Export:** Saves your maze as a **high-quality PNG image**  \n- 📸 **JPG Export:** Saves your maze as a **JPG photo**  \n- 📜 **PDF Export:** Saves your maze as a **PDF file** (powered by `jsPDF`)  \n\n---\n\n## 💡 Roadmap  \n\n💡 **Future Improvements:**  \n- ⏳ **Timed Mode** ⏱️ (Challenge yourself to solve the maze quickly)  \n- 🏆 **Leaderboard Support** (Track best completion times)  \n- 🌐 **Multiplayer Mode** (Race against friends to solve mazes)  \n\nIf you'd like to contribute, feel free to submit **feature suggestions** or **pull requests**! 😊  \n\n---\n\n## 🎨 Screenshots  \n\n🔎 **Example Maze Preview:**  \n*(Insert sample images of the maze in action)*  \n\n📤 **Exported Maze Example:**  \n*(Include an exported PNG/JPG/PDF sample)*  \n\n---\n\n## 📜 Author  \n\n**👨‍💻 Bocaletto Luca**  \n\nMade with ❤️ and **JavaScript**!  \nIf you enjoy Labyrinth - Maze Explorer, feel free to ⭐ star the repository or contribute to its development. 🚀  \n\n---\n\n## 🔗 License  \n\nThis project is licensed under the **GPLv3 License**.  \nFeel free to use, modify, and distribute it **freely**! 😊  \n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbocaletto-luca%2Flabyrinth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbocaletto-luca%2Flabyrinth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbocaletto-luca%2Flabyrinth/lists"}