🎮 PyGame Zero Simple Game

A simple game created using PyGame Zero — a beginner-friendly game framework built on top of Pygame.

This project is perfect for those who are just getting started with game development in Python.

📦 Features

• 🎮 Simple Gameplay Mechanics: Easy-to-understand core gameplay
• 🕹️ Player Controls and Movement: Responsive input for smooth character movement
• 💥 Collision Detection: Detects interactions between game objects
• 🧮 Score Tracking: Keeps track of the player’s score during gameplay
• 🐾 Sprite Character Animations: Animated character sprites for visual appeal
• 🎵 Background Music and Sound Elements: Engaging audio experience during play
• 🔊 Toggle Background Music: Option to turn on/off background music
• 🔁 Basic Game Loop: Core loop handling game updates and rendering

🚀 Getting Started

Requirements

• Python 3.6+
• PyGame Zero

Installation

1. Clone the repository:

   git clone https://github.com/davutbayik/pygame-zero-simple-game.git
   cd pygame-zero-simple-game
   

2. Create and activate a virtual environment (Optional-Recommended):

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install the required packages:

   pip install -r requirements.txt
   

4. Run the game:

    pgzrun game.py
   

🕹 Controls

Key	Action
Arrow Keys	Move player
Space	Attack

🧠 How It Works

This game uses PyGame Zero, a beginner-friendly library that simplifies writing games in Python.

The core structure includes:

• draw() — Renders game elements on the screen every frame.
• update() — Updates game logic like movement, collisions, or score.
• Assets (like images and sounds) are loaded automatically from the images/ and sounds/ folders, based on filenames.

You define actors (e.g., the player or enemies) using Actor() and control them using keyboard input. PyGame Zero manages the game loop behind the scenes.

🎯 Goals

The primary goals of this project are:

• ✅ Demonstrate how to build a simple 2D game using Python and PyGame Zero
• ✅ Provide a hands-on learning example for beginners in game development
• ✅ Encourage experimentation by using a clean and minimal code structure
• ✅ Offer a starting point to expand with more features

🛠️ Customize

Feel free to customize and expand the game! Some ideas include:

• 🎨 Add more levels or scenes
• 🧠 Add simple AI for enemies
• 🏆 Create a high score table
• 🌎 Add support for different screen sizes or full-screen mode

Let your imagination guide you — it’s a great way to practice Python while having fun!

🖼 In-Game Screenshots

The images below shows in game screenshots from start menu and game loop.

🤝 Contributing

Contributions are welcome and appreciated! If you’d like to improve this project, here’s how you can help:

• 🐞 Report bugs or issues.
• 🌟 Suggest new features or improvements.
• 🔀 Fork the repo, make your changes, and submit a pull request.

Please make sure your code follows best practices and includes proper documentation where necessary.

📄 License

This project is licensed under the terms of the MIT License.
You are free to use, modify, and distribute this software as long as you include the original license.

📬 Contact

Made with ❤️ by Davut Bayık — feel free to reach out via GitHub for questions, feedback, or collaboration ideas.

---

⭐ If you found this project helpful, consider giving it a star!