/BrokenChess

Primary LanguagePythonMIT LicenseMIT

BrokenChess

BrokenChess is a chess game implemented in Python using the Pygame library. It allows users to play chess with a graphical interface.

Table of Contents

  1. Introduction
  2. Features
  3. Installation
  4. Usage
  5. Contributing
  6. License

Introduction

BrokenChess is a Python-based chess game designed for learning and entertainment purposes. It offers a graphical user interface (GUI) to play chess against an AI opponent and includes basic chess rules and movements.

Features

  • Graphical chessboard with intuitive piece movements.
  • Player versus AI mode.
  • Basic AI opponent for single-player experience.
  • Highlight valid moves for selected pieces.
  • Simple and clean user interface.

Installation

To run BrokenChess on your local machine, follow these steps:

  1. Clone the repository:

    git clone https://github.com/AdRohal/BrokenChess.git
  2. Navigate to the project directory:

    cd BrokenChess
    
  3. Install the necessary dependencies using pip:

    pip install pygame
    
  4. Run the game:\

    python main.py
    

Usage

After starting the game, you will see a start screen with a "Start" button. Click on the button to begin playing BrokenChess. You can move pieces by clicking on them and then clicking on the destination square. The game will alternate turns between the player (white) and the AI opponent (black).

Contributing

Contributions to BrokenChess are welcome! Here's how you can contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature)
  3. Make your changes.
  4. Commit your changes (git commit -am 'Add new feature')
  5. Push to the branch (git push origin feature)
  6. Open a pull request.

License

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

---
This README.md file summarizes the BrokenChess project, its features, installation instructions, usage guidelines, contribution guidelines, and licensing information. You can copy and paste this template into your project's README.md file and customize it further as needed. Adjust the URLs and specific details according to your project's structure and requirements.