{"id":26294850,"url":"https://github.com/bigevilbeard/simplepacmangame","last_synced_at":"2025-03-15T03:32:17.272Z","repository":{"id":281218006,"uuid":"944592911","full_name":"bigevilbeard/SimplePacManGame","owner":"bigevilbeard","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-07T16:35:32.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T17:24:29.432Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigevilbeard.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-03-07T16:11:13.000Z","updated_at":"2025-03-07T16:35:35.000Z","dependencies_parsed_at":"2025-03-07T17:24:35.337Z","dependency_job_id":"cf15e23c-0d21-4e42-afca-0f6ca2532fc0","html_url":"https://github.com/bigevilbeard/SimplePacManGame","commit_stats":null,"previous_names":["bigevilbeard/simplepacmangame"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigevilbeard%2FSimplePacManGame","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigevilbeard%2FSimplePacManGame/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigevilbeard%2FSimplePacManGame/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigevilbeard%2FSimplePacManGame/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigevilbeard","download_url":"https://codeload.github.com/bigevilbeard/SimplePacManGame/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681024,"owners_count":20330152,"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":[],"created_at":"2025-03-15T03:32:05.481Z","updated_at":"2025-03-15T03:32:17.249Z","avatar_url":"https://github.com/bigevilbeard.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Pacman Game\n\nA classic Pacman arcade game built with Python and Pygame. Navigate through the maze, collect dots, and avoid the ghosts!\n\n![Pacman Game Screenshot](pacman_image.png)\n\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true\u0026ref=main\u0026repo=bigevilbeard/SimplePacManGame)\n\n## Features\n\n- Classic Pacman gameplay mechanics\n- Animated Pacman character with mouth movement\n- Four colorful ghosts with AI movement\n- Maze with walls and collectible dots\n- Score tracking and lives system\n- Game over and win conditions\n\n## Requirements\n\n- Python 3.x\n- Pygame\n\n## Installation\n\n### Local Setup\n\n1. Clone this repository:\n   ```\n   git clone https://github.com/yourusername/pacman-game.git\n   cd pacman-game\n   ```\n\n2. Install the required dependencies:\n   ```\n   pip install pygame\n   ```\n\n3. Run the game:\n   ```\n   python pacman_game.py\n   ```\n\n### Using GitHub Codespaces\n\nYou can run this game directly in your browser using GitHub Codespaces:\n\n1. Click the \"Open in GitHub Codespaces\" button at the top of this README\n2. Wait for the Codespace to initialize\n3. Once ready, open a terminal and run:\n   ```\n   pip install pygame\n   python pacman_game.py\n   ```\n\nNote: To play the game in Codespaces, you'll need to use the \"Simple Browser\" or port forwarding if the game uses a web interface. For the standard Pygame version, you may need to use X11 forwarding or VNC to see the graphical output.\n\n## How to Play\n\n- Use the **arrow keys** to control Pacman's movement\n- Collect all dots in the maze to win\n- Avoid the ghosts - if they catch you, you'll lose a life\n- You have 3 lives to complete the game\n- Press **ESC** to quit the game\n- Press **R** to restart after game over or winning\n\n## How It Works\n\nThe game is built using Pygame and consists of several key components:\n\n### Game Structure\n- The game uses a grid-based maze represented by a 2D array\n- Each cell can be a wall (1) or a path with a dot (0)\n- The game runs at 60 FPS with a main loop handling updates and rendering\n\n### Pacman\n- Controlled by the player using arrow keys\n- Moves through the maze collecting dots\n- Features animated mouth opening and closing\n- Has collision detection with walls and dots\n\n### Ghosts\n- Four ghosts with different colors (Red, Pink, Cyan, Orange)\n- Move randomly through the maze\n- Change direction when hitting walls\n- Cause the player to lose a life upon collision\n\n### Scoring System\n- Each dot collected adds 10 points to the score\n- Game tracks remaining dots to determine win condition\n\n## Code Structure\n\n- `pacman_game.py`: Main game file containing all game logic\n- Game initialization and setup\n- Pacman and Ghost classes\n- Maze rendering and collision detection\n- Game loop and event handling\n\n## Development with GitHub Codespaces\n\nThis repository is configured for GitHub Codespaces, which provides a complete, preconfigured development environment in the cloud.\n\n### Benefits of using Codespaces:\n\n- No local setup required - start coding instantly\n- Consistent development environment for all contributors\n- Run the game directly in the cloud\n- Access your development environment from any device with a browser\n\n### Codespaces Configuration\n\nThe repository includes a `.devcontainer/devcontainer.json` file that:\n- Sets up a Python environment\n- Installs Pygame automatically\n- Configures VS Code with Python extensions\n- Sets up port forwarding\n\nTo view the graphical output in Codespaces, you may need to use X11 forwarding or a VNC setup. For advanced users, you can modify the devcontainer configuration to include these capabilities.\n\n## Customization\n\nYou can customize various aspects of the game by modifying the constants at the top of the file:\n- `WIDTH`, `HEIGHT`: Screen dimensions\n- `GRID_SIZE`: Size of each maze cell\n- `PACMAN_SPEED`, `GHOST_SPEED`: Movement speeds\n- `maze`: Layout of the game maze\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- Inspired by the classic Pacman arcade game\n- Built with Pygame, a set of Python modules designed for writing video games\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigevilbeard%2Fsimplepacmangame","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigevilbeard%2Fsimplepacmangame","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigevilbeard%2Fsimplepacmangame/lists"}