{"id":24778199,"url":"https://github.com/marsdevx/maze-escape","last_synced_at":"2025-10-12T01:32:07.153Z","repository":{"id":270778697,"uuid":"911341761","full_name":"marsdevx/maze-escape","owner":"marsdevx","description":"🎮 🧩 Simple 2D puzzle game built in C for Linux and macOS.","archived":false,"fork":false,"pushed_at":"2025-02-10T16:57:17.000Z","size":1349,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T03:11:26.743Z","etag":null,"topics":["2d","2d-game","42","c","c-programming","c-programming-game","clanguage","educational-game","educational-project","game-development","gamedev","linux","macos","maze-game","maze-generator","mlx","so-long"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marsdevx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-01-02T19:40:28.000Z","updated_at":"2025-04-01T16:48:57.000Z","dependencies_parsed_at":"2025-01-05T06:17:34.141Z","dependency_job_id":null,"html_url":"https://github.com/marsdevx/maze-escape","commit_stats":null,"previous_names":["marsdevx/game-in-c","marsdevx/maze-escape"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marsdevx/maze-escape","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmaze-escape","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmaze-escape/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmaze-escape/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmaze-escape/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marsdevx","download_url":"https://codeload.github.com/marsdevx/maze-escape/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmaze-escape/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279009768,"owners_count":26084648,"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","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["2d","2d-game","42","c","c-programming","c-programming-game","clanguage","educational-game","educational-project","game-development","gamedev","linux","macos","maze-game","maze-generator","mlx","so-long"],"created_at":"2025-01-29T08:17:55.654Z","updated_at":"2025-10-12T01:32:07.147Z","avatar_url":"https://github.com/marsdevx.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"imgs/logo.png\" width=\"320px\" alt=\"Maze Escape\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Last Commit](https://custom-icon-badges.demolab.com/github/last-commit/marsdevx/maze-escape?logoColor=white\u0026labelColor=2C2C2C\u0026label=Last%20Commit\u0026color=8A2BE2\u0026logo=mark-github)](https://github.com/marsdevx/maze-escape/commits/main \"Last Commit\")\n[![Platforms](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Platforms\u0026message=macOS%20|%20Linux\u0026color=D32F2F\u0026logo=device-desktop)](https://github.com/marsdevx/maze-escape \"Platforms\")\n\u003cbr\u003e\n[![Languages](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Languages\u0026message=C%20language\u0026color=748ADB\u0026logo=file-code)](https://github.com/marsdevx/maze-escape \"Languages\")\n[![Genre](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Genre\u0026message=Puzzle\u0026color=F47F42\u0026logo=goal)](https://github.com/marsdevx/maze-escape \"Genre\")\n[![Assets](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Assets\u0026message=%206%20\u0026color=15CDD3\u0026logo=file-media)](https://github.com/marsdevx/maze-escape/tree/main/textures \"Assets\")\n[![Levels](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Levels\u0026message=%204%20\u0026color=C2185B\u0026logo=filter)](https://github.com/marsdevx/maze-escape/tree/main/levels \"Levels\")\n[![License](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=License\u0026message=MIT\u0026color=00C853\u0026logo=law)](https://github.com/marsdevx/maze-escape/blob/main/LICENSE \"License\")\n\n\u003c/div\u003e\n\n---\n\n# 🧩 Maze Escape\n\nThis project is a simple **2D puzzle game** built for educational purposes using the **C language** and the **MiniLibX Graphics Library**. Designed to run on **Linux** and **macOS**, this open-source project showcases the basics of **game development** with **C**.\n\n*\t**2D game** using **XPM** images as assets.\n*\tIncludes 6 different asset packs and 4 challenging levels.\n*\tA perfect introduction to game development with C language.\n*\tLightweight and easy to customize for learning.\n\nExplore how C can bring games to life with this opensource puzzle game!\n\n---\n\n## 🖼️ Preview\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"imgs/preview.png\" alt=\"Preview\"\u003e\n\u003c/div\u003e\n\n---\n\n## 🛠️ Installation\n\nTo install this project, Launch the Terminal app on your system, and run the commands below. \u003cbr\u003e\n  - If a pop-up appears prompting you to download the Xcode Command Line Tools after the first command, click “Download” and then run the first command again.\n\n###  macOS\n\n1. **Clone repo**\n```bash\ngit clone https://github.com/marsdevx/maze-escape.git ~/Downloads/Maze-Escape\n```\n\n2. **Compile project**\n```bash\ncd ~/Downloads/Maze-Escape \u0026\u0026 make macos\n```\n\n### 🐧 Linux\n\n1. **Clone repo**\n```bash\ngit clone https://github.com/marsdevx/maze-escape.git ~/Downloads/Maze-Escape\n```\n\n2. **Compile project**\n```bash\ncd ~/Downloads/Maze-Escape \u0026\u0026 make linux\n```\n\n---\n\n## 🚀 Usage\n\n1. **Navigate to the Game Directory**\n```bash\ncd ~/Downloads/Maze-Escape\n```\n\n2. **Run the Game**\n```bash\n./maze_escape levels/lvl1 textures/pacman\n```\n\n3. **Customize Your Game**\n\nYou can modify the level and texture by changing the corresponding arguments in the command:\n\n- Levels: Replace `levels/lvl1` with one of the following:\n  - `levels/lvl1`\n  - `levels/lvl2`\n  - `levels/lvl3`\n  - `levels/lvl4`\n- Textures: Replace `textures/pacman` with one of the following:\n  - `textures/pacman`\n  - `textures/adventurer`\n  - `textures/chicken`\n  - `textures/pokemon`\n  - `textures/space-ship`\n  - `textures/time-adventure`\n\n---\n\n## ⚙️ Advanced Options\n\n### Add Your Own Map\n\nYou can add custom maps to the game, as long as they follow these rules:\n\n1. The map must be a `.ber` file.\n2. The map can only contain the following characters:\n\n| CHAR | OBJECT        |\n|------|---------------|\n| 1    | Wall          |\n| C    | Collectible   |\n| E    | Exit          |\n| P    | Player        |\n| 0    | Background    |\n\n#### Example of a valid map\n\n```\n11111111111\n10000P1C001\n11111011101\n10001000001\n101011111E1\n11111111111\n```\n\n### Add Your Own Textures\n\nYou can add custom textures to the game, as long as they follow these rules:\n\n1. The `textures` folder must contain **exactly 5 files**.\n2. All files must be in the `.xpm` format.\n3. The files must be named as follows:\n   - `bg.xpm` (background)\n   - `exit.xpm` (exit point)\n   - `item.xpm` (collectible items)\n   - `player.xpm` (player character)\n   - `wall.xpm` (walls)\n\n---\n\n## 📋 License\n\nAll the code contained in this repo is licensed under the [MIT License](LICENSE)\n\n```\nMIT License\n\nCopyright (c) 2025 marsdevx\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n---\n\n## ⭐ Support\n\nIf you like this project, don’t forget to ⭐ **star** it and **follow** me!  \nYour **support** helps me create more projects. 🚀  \n\n🔗 **Explore more of my work on [GitHub](https://github.com/marsdevx?tab=repositories) and discover other exciting projects!**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fmaze-escape","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarsdevx%2Fmaze-escape","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fmaze-escape/lists"}