Skip to content

Latest commit

 

History

History
73 lines (42 loc) · 2.4 KB

README.md

File metadata and controls

73 lines (42 loc) · 2.4 KB

Five in a Row / Caro Game (Vietnamese version)

A Python implementation of the Vietnamese game: Five in a Row or Caro Game, built with the Tkinter library. The game is played on a 30x30 grid and allows two players to take turns placing their marks (X and O). The first player to get an unblocked sequence of five in a row wins the game. The first player to reach 3 wins first wins the match.

Features

  • Interactive Gameplay: Players alternate turns by clicking on the grid.
  • Win Detection: Automatically checks for a winner after every move.
  • Blocked Rule: A sequence of five that is blocked on both ends does not count as a win.
  • Restart Option: After a win, players can restart the game by clicking on the board.
  • Score Tracking: Displays the total wins for each player when the game is finished.
  • Winning Condition: Player needs to win 3 games from the opponent to win the match.

How to Play

  1. Start the Game: Run the Python script to open the game window.

  2. Make a Move: Click on any cell to place your mark (X or O). Players alternate turns.

  3. Win the Game: Form a sequence of five unblocked marks in:

    • Horizontal
    • Vertical
    • Diagonal (both directions)

  4. Restart: After a win is announced, click on the board to reset the game.

  5. Finish: The first player to reach 3 wins will win the match and the game is finished.

How to Run

  1. Save the game script as five_in_a_row.py.

  2. Open a terminal or command prompt.

  3. Navigate to the directory containing the script.

  4. Run the following command:

    python five_in_a_row.py

Code Overview

  • Game Board: A 30x30 grid is drawn using the Canvas.

  • Turn Management: Alternates between "X" and "O" after each valid move.

  • Win Detection:

    • Checks for sequences of 5 in all directions (horizontal, vertical, diagonal).
    • Ensures sequences are not blocked on both ends using the is_blocked function.

  • Restart and Quit:

    • The game restarts when clicking the board after a win.
    • Total scores are displayed when the game is finished.
    • The game is closed automatically when the game is finished.

Customization

  • Board Size: Adjust WIDTH and HEIGHT to customize the size of the board.
  • Cell Size: Modify the size of each cell by adjusting the CELL variable.

Author

This game is written by Hoan Phung