From 211ba3a4d9a095143688912ee32711a72f880b66 Mon Sep 17 00:00:00 2001 From: Sabrina <sabrinalap98@gmail.com> Date: Fri, 4 Apr 2025 18:15:41 +0200 Subject: [PATCH] add Readme --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..542fc04 --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# Pow 4 +**Author** +Lapaire Sabrina +**Name** +TP Power 4 of "programmation séquentiel" lesson + +## Rules of game +The goal of the game is align a sequence of 4 same pieces on a board. Each round, two players choose a column for place his piece and the piece fall the lowest the column. The winner is the first to realise an aligment of a sequence of 4 of his pieces in vertical, horizontal or diagonal. If the board is full, the game is a draw. + +## Composition +The board size is defined by a height (columns) and width (lines). Each players (include AI) has a piece "O" or "X". + +## Available mods +**Mod two players** +Two players can choose, each his round, the columns for place his pieces. + +**Mod Random AI** +One player play with a random AI. It places his piece in a random column. + +**Mod Smart AI** +One player play with a smart AI. It place his piece in a random column except if it can win on the next round or block the win of the player. + +## How to play ? +For play, the user execute the program `./puissance4` with following parameters : +- The game mod (1 for random AI, 2 for smart AI and 3 for two players) +- The height (lines) of the board +- The width (columns) of the board. + +When it's launched, the user or users must write the number of the colum who he chose when it's asked, and he presses the enter touch. + +For launch automatic tests, the user must write `make test` in the terminal (he must to make sure he is in the program folder) and press enter. + +For launch unit tests, the user must write `make unit tests`in the terminal (he must to make sure he is in the program folder) and press enter \ No newline at end of file -- GitLab