https://github.com/alna0770/pacman

https://github.com/alna0770/pacman

algorithm-challenges game-development java pacman-game solving-problems

Last synced: 8 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/alna0770/pacman
• Owner: ALNA0770
• Created: 2024-11-28T11:34:38.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-28T11:58:20.000Z (over 1 year ago)
• Last Synced: 2025-10-30T01:21:57.228Z (9 months ago)
• Topics: algorithm-challenges, game-development, java, pacman-game, solving-problems
• Language: Java
• Homepage:
• Size: 2.99 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          

---

  

  
PAC-MAN Game
  

  


---

### **Introduction**  

Welcome to the **Pac-Man Game**, a classic arcade experience recreated using **Java** and **Swing**. Navigate the maze, eat all the pellets, and avoid the spooky ghosts to win!  

---

### **✨ Features**  

- 🎮 **Play as Pac-Man**: Control Pac-Man to collect points and avoid dangers.  

- 👻 **Dynamic Ghosts**: Dodge the colorful ghosts patrolling the maze.  

- 🏆 **Scoring System**: Earn points for every pellet eaten.  

- 🕹️ **Simple Controls**: Navigate using arrow keys for an easy-to-learn, fun-to-play experience.  

- 💀 **Challenge**: Survive as long as you can and beat your high score.  

---

### **🎮 How to Play**  

1. **Controls**:  

   - ⬆️ **Up Arrow**: Move up.  

   - ⬇️ **Down Arrow**: Move down.  

   - ⬅️ **Left Arrow**: Move left.  

   - ➡️ **Right Arrow**: Move right.  

2. **Objective**:  

   - 🍒 Collect all food pellets to win.  

   - 🛑 Avoid ghosts at all costs!  

3. **Game Over**:  

   - 💔 The game ends when Pac-Man loses all lives.  

---

  

    

  
Getting Started
  

  


---

### **🔧 Prerequisites**  

- **Java Development Kit (JDK)**: Version 8 or higher.  

- **Java IDE**: Any IDE like IntelliJ IDEA, Eclipse, or VS Code.  

---

### **🚀 Installation Guide**  

1. **Clone the Repository**:  

   ```bash  

   git clone https://github.com/your-username/pacman-game.git  

   cd pacman-game  

   ```  

2. **Assets**:  

   - Ensure these image files are available:  

     - `wall.png`  

     - `blueGhost.png`  

     - `orangeGhost.png`  

     - `pinkGhost.png`  

     - `redGhost.png`  

     - `pacmanUp.png`  

     - `pacmanDown.png`  

     - `pacmanLeft.png`  

     - `pacmanRight.png`  

3. **Run the Game**:  

   - Open the project in your IDE.  

   - Compile and run the `PacMan` class.  

---

  

    

  
Gameplay Preview
  

  


Add screenshots or gameplay GIFs in this section to showcase the game.  

---

### **🛠️ Project Structure**  

```  

pacman-game/  

│  

├── src/                      # Source code directory  

│   ├── PacMan.java           # Main game file  

│   ├── (Other Java files if necessary)  

│  

├── resources/                # Game assets  

│   ├── wall.png  

│   ├── blueGhost.png  

│   ├── orangeGhost.png  

│   ├── pinkGhost.png  

│   ├── redGhost.png  

│   ├── pacmanUp.png  

│   ├── pacmanDown.png  

│   ├── pacmanLeft.png  

│   ├── pacmanRight.png  

│  

├── README.md                 # Readme file  

└── LICENSE                   # License file (optional)  

```  

---

  

    

  
Future Enhancements
  

  


- 🌟 **Smarter Ghost AI**: Implement pathfinding to chase Pac-Man.  

- 🎯 **Power-Ups**: Add special items for temporary abilities.  

- 🗺️ **Levels**: Introduce multi-level gameplay with increased difficulty.  

- 🔊 **Sound Effects**: Add sounds for a more immersive experience.  

---

### **📜 License**  

This project is licensed under the [MIT License](LICENSE).  

---

### **👨‍💻 Contributors**  

- **Developer**: [Your Name](https://github.com/your-username)  

Feel free to fork, star ⭐, or contribute to this project!  

---

  

  
Thank You for Playing!