PokemonMelee

Welcome to the PokemonMelee repository! This project is a strategic Pokémon battle game created as part of the Mini-Project for the course Python for Computational Problem Solving (UE23CS151A). Our game combines immersive gameplay with skill, strategy, and creativity.

---

👥 Team Members

• Noel George Jose - PES1UG23AM197
• Pranav Hemanth - PES1UG23CS433
• Pranav Rajesh Narayan - PES1UG23CS435
• Pragathi Panchangam - PES1UG23CS424

Guided by Prof. Sowmya Shree P, Dept. of CSE, PES University.

---

📋 Project Description

PokemonMelee is a Pokémon battle game built in Python. Players engage in turn-based battles where they can attack, emote, scan Pokémon stats, or run. Our implementation combines GUI elements with database management, ensuring an engaging user experience.

Key Features

• Home Screen: Start the game, set player names, reset variables, and toggle sound.
• Battle Screen: Execute attacks, emote during battles, scan player and Pokémon stats, and retreat to the home screen.
• End Screen: Displays game results with options to replay or exit.

Technical Highlights

• GUI created using pygame and tkinter.
• Database management using pandas and CSV files.
• Modular programming with a custom module pokedex.py for Pokémon data.
• Object-Oriented Programming (OOP) for game mechanics.
• Cross-platform compatibility using the os module.

---

🚀 Built With

• Python
• Pygame (including sub-modules)
• Tkinter (including sub-modules)
• Pandas
• Random
• Os
• Functools

---

📡 Setup Instructions

Installation

1. Download all files, including assets.

2. Install the required libraries using:

   pip install -r requirements.txt

3. Run the game:

   python game.py

Note: (Optional) Add the provided font in /assets/ to your system fonts for optimal presentation.

---

⚙️ Project Structure

• game.py: Main game logic and GUI.
• pokedex.py: Custom module for Pokémon data.
• Assets: Contains sprites, music, and font files.

---

🔧 Gameplay Highlights

Home Screen

• Begin: Start the game.
• Options: Reset game variables and set player names.
• Exit: Close the game window.
• Speaker: Toggle game music on/off.

Battle Screen

• Fight: Choose an attack and deal damage.
• Emote: Show your feelings mid-battle. (Totally didn't run out of ideas for alternative options)
• Scan: Display player name, Pokémon stats (health, damage).
• Run: Exit to the home screen.

End Screen

• Displays the winner and provides an option to exit.

---

🔍 Contributing

We welcome contributions! To get started:

1. Fork the repository.
2. Create your feature branch:

   git checkout -b feature/AmazingFeature

3. Commit your changes:

   git commit -m "Add some AmazingFeature"

4. Push to the branch:

   git push origin feature/AmazingFeature

5. Open a pull request.

---

🎵 Bibliography

• Pygame Documentation
• Pandas Documentation
• Tkinter Documentation
• Pokémon sprites sourced from PokeAPI and PokemonDB.
• Battle Music by Pokeli.
• Home Music by Frank Tedesco.

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy Gaming!