Skip to content

Commit

Permalink
Merge pull request #27 from TINF21CS1/installation_manual
Browse files Browse the repository at this point in the history
Installation manual
  • Loading branch information
Petzys authored Mar 20, 2024
2 parents da011bd + c48467a commit 69eda0b
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 1 deletion.
10 changes: 9 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,18 @@
This is a simple TicTacToe game written in Python. IT can be played by two players in a GUI. However, it only works on Windows.

## Installation

- Install [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- Clone the repository: `git clone https://github.com/TINF21CS1/TicTacToeKojote.git`
- Alternative to installing Git and cloning the repository: Press the green `Code`-Button on the GitHub Repository in the Browser and click `Download ZIP`. Afterwards, right click the ZIP-file and click unzip.
- Install Python 3.11 or higher from [python.org](https://www.python.org/downloads/)
- Install the required packages by running `pip install -r requirements.txt` from the root directory of the project
- Run the game by executing `python main.py` from the root directory of the project
- To play against other players in the network, you have to configure your local firewall to allow incoming traffic on port 8765
- Alternatively, you can turn off the firewall on both clients

## Features

- Play TicTacToe with a friend online
- Play TicTacToe with a friend offline
- Play TicTacToe against an AI (weak or strong)
Expand All @@ -16,11 +23,12 @@ This is a simple TicTacToe game written in Python. IT can be played by two playe
- View your game statistics whenever you are connected to a server

## How to play

- **Manage your player profiles:** View Use Case 1: Manage Player Profiles
- **Play against AI:** View the corresponding [sequence diagram](docs/sequence_diagrams/play_vs_ai.png)
- **Play against another player locally:** View the corresponding [sequence diagram](docs/sequence_diagrams/play_locally.png)
- **Host an online game:** View Use Case 3.1: Host Game
- **Join an online game:** View Use Case 3.2: Join Game
- **Leave an online game:** View Use Case 3.3: Leave Game
- **Send Chat messages:** View Use Case 4: Chat
- **Display the statistics:** View Use Case 5: Display Statistics
- **Display the statistics:** View Use Case 5: Display Statistics
Binary file modified docs/sequence_diagrams/play_locally.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/sequence_diagrams/play_locally.puml
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Client->p: Display Multiplayer Menu
p->Client: Click Create local Game Button
Client->p: Display Profile selection screen
p->Client: Select Profiles for both players
Client->Client: Host Server locally
p->Client: Click Start Game Button
Client->p: Display Playfield

Expand Down

0 comments on commit 69eda0b

Please sign in to comment.