A fully playable recreation of the classic Pacman arcade game built with Python and Pygame. Navigate the maze, eat all the pellets, dodge the ghosts, and try to achieve the highest score possible!
🎮 Classic Pacman gameplay experience
👻 Ghost enemies with basic AI path movement
💛 Smooth player controls using arrow keys
🧮 Real-time scoring system
💥 Game Over and Win screens
🔁 Ability to restart the game after it ends
🔊 Sound effects and background music (optional if implemented)
Language: Python
Library: Pygame (for rendering, events, collision detection, and audio)
pacman-game/
│
├── main.py # Main game loop and logic
├── assets/ # Sprites, images, and sound files
├── levels/ # Level layouts (optional)
├── README.md # Project documentation
└── requirements.txt # Python dependencies
Prerequisites
Python 3.x installed
Pygame library installed
Installation
git clone https://github.com/your-username/pacman-game.git
cd pacman-game
pip install -r requirements.txt
(or simply pip install pygame if requirements.txt is not provided)
python main.py
Use the Arrow Keys to move Pacman (⬆️⬇️⬅️➡️)
Collect all pellets to win
Avoid the ghosts — colliding with them will end the game
Your score increases as you collect pellets
🧠 Smarter ghost AI with pathfinding (A* or BFS)
💎 Power pellets that allow Pacman to eat ghosts
🎨 Multiple levels and maps
🌐 Leaderboard to track high scores
📱 Mobile or web-based version
🤝 Contributing
Contributions are welcome!
Fork the repository
Create a feature branch
Commit your changes
Submit a pull request
📄 License
This project is licensed under the MIT License . Feel free to use, modify, and distribute it.
💬 Acknowledgements
Inspired by the original Pac-Man (1980) arcade game by Namco
Built as a beginner-friendly Python game development project