# Gomoku Game User Manual

## Introduction

Welcome to the Gomoku Game! This game is a classic board game where players take turns placing their stones on a 15x15 grid with the goal of getting five stones in a row, either horizontally, vertically, or diagonally. In this version of the game, you can play against an intelligent AI player and enjoy a visually appealing and immersive experience.

## Installation

To play the Gomoku Game, you need to install the required dependencies. Please follow the steps below:

1. Make sure you have Python installed on your computer. You can download Python from the official website: [https://www.python.org/downloads/](https://www.python.org/downloads/)

2. Open a terminal or command prompt and navigate to the directory where you have downloaded the Gomoku Game files.

3. Run the following command to install the required dependencies:

   ```
   pip install -r requirements.txt
   ```

   This command will install the Pillow library for image processing and the tkinter library for creating the graphical user interface.

## Running the Game

Once you have installed the dependencies, you can run the Gomoku Game by following these steps:

1. Open a terminal or command prompt and navigate to the directory where you have downloaded the Gomoku Game files.

2. Run the following command to start the game:

   ```
   python main.py
   ```

   This command will start the game and open a new window with the game board.

3. Use the mouse to click on the empty cells of the game board to place your stone. The AI player will automatically make its move after you.

4. The game will continue until one player gets five stones in a row or the game board is full. A message will be displayed to indicate the result of the game.

5. To start a new game, close the game window and run the `python main.py` command again.

## Game Features

The Gomoku Game offers several features to enhance your gaming experience:

### Theme-based GUI

Instead of a generic game board, the GUI of the Gomoku Game allows you to choose from different themes. Each theme has a unique design and visual style, such as a futuristic theme or a fantasy theme. To change the theme, you can modify the code in the `gui.py` file and replace the background and stone images with your desired images.

### Power-ups and Special Moves

To make the game more exciting, the Gomoku Game incorporates power-ups and special moves that you can use during gameplay. These power-ups and special moves can be earned or purchased using in-game currency. For example, a power-up could allow you to place two stones in a single turn, or a special move could let you swap the positions of two stones on the board. These features add an element of strategy and surprise to the game.

### Story Mode

In addition to playing individual games, the Gomoku Game includes a story mode where you can progress through different levels or challenges. Each level has unique objectives or rules, and you can unlock new features or characters as you advance. The story mode provides a sense of progression and engagement, making the game more immersive and enjoyable.

## Conclusion

Congratulations! You are now ready to enjoy the Gomoku Game. Have fun playing against the AI player and exploring the different themes, power-ups, and story mode. If you have any questions or encounter any issues, please refer to the documentation or reach out to our support team. Happy gaming!