https://github.com/lamiasristy/tic_tac_toe

This project is a Tic_Tac_Toe game.
https://github.com/lamiasristy/tic_tac_toe

Last synced: 3 days ago
JSON representation

This project is a Tic_Tac_Toe game.

• Host: GitHub
• URL: https://github.com/lamiasristy/tic_tac_toe
• Owner: LamiaSristy
• Created: 2020-09-07T07:34:34.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-10-01T19:56:07.000Z (over 4 years ago)
• Last Synced: 2025-01-07T04:06:17.084Z (19 days ago)
• Language: Ruby
• Size: 18.6 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Tic_Tac_Toe

In this project I have created a very popular game, Tic-Tac-Toe. It consists of making a sequence of three symbols in either a row, column or diagonal in a 3x3 board, using Ruby OOP principles.

## Live Code

[![Run on Repl.it](https://repl.it/badge/github/@lamiasristy/TicTacToe)](https://repl.it/@lamiasristy/TicTacToe)

# How to play:

1. Enter the first player's name.

2. The firrst player enter the sign; This should only be one character.

3. Select the second player's name, following the instruction given on step 1. The names should be unique.

4. The second player gets to choose a sign but it has to be different from the first player's sign.

5. The game will begin. The Tic-Tac-Toe board will be printed with empty rows and columns.

6. To win this game one player must make a sequence of three signs either on rows, columns or diagonals.

7. The selected player gets to choose the position where they want to place their sign, by inputting a position. The input should be equal to or in between 1 to 9 integer values.

8. After that, the position will be validated and recorded. Afterwards, the second player will be selected to take a turn.

9. The selected position can't be chosen twice.

10. The game will take turns until a player wins or no more positions are available on the board, in this case it will be a draw.

11. The Game will ask to start again or not to the user.

## Game-Instruction:

This is a tic-tac-toe game built with ruby and oop principles:

    In this project, all the logic and manipulation are in the files inside lib folder.

    ---------------------------------------------------------------------------------------------------------------------

    In this game project there are 3 main files 

    1- main.rb: This file is responsible for getting validated inputs from the user, outputting messages, and calling all the required methods.

    2- player.rb: This file is responsible for storing player variables such as (name, sign).

    3- board_game.rb: This file is responsible for the creating the board, and applying the coordinates.	  

    ---------------------------------------------------------------------------------------------------------------------

    The game consists of 6 steps:

    1- get the players' names and validate that they are unique.

    2- get player one's sign and validate that it's a single character.

    3- get player two's sign and validate that it's a character and unique from player one's sign.

    4- display the board and ask for a move.

    5- validating the given move by checking that the coordinates are not already taken and that they are equal to or between 1-9. This process runs for both players.

    6- checks for the win conditions. If any player wins, it will display the player that won, else it will display "it's a draw".

    7- After the result the game asks if the player want to start again by inputting Y/N. If its a Y then it will start the game again.

## Built With

- Ruby

- VS Code

## Getting Started

### Prerequisites

To get this project up and running, you must already have ruby installed on your computer.

### Installation

**To get this project set up on your local machine, follow these simple steps:**

1. Open Terminal.

2. Navigate to your desired location to download the contents of this repository.

3. Copy and paste the following code into the Terminal:

    git clone https://github.com/LamiaSristy/Tic_Tac_Toe

4. Hit enter.

5. Once the repository has been cloned, navigate inside the repository and type:

    bin/main.rb

    This will run the game and you will be able to play it using the terminal.

6. Have fun!

## Author Details::

👤 **Lamia Sristy**

- Github: [@LamiaSristy](https://github.com/LamiaSristy)

- Linkedin: [@LamiaSristy](https://www.linkedin.com/in/lamia-hemayet-sristy/)

- E-mail: Email  

- Twitter: [@LamiaSristy](https://twitter.com/lsristy1)

## Show your support

Give ⭐ Star me on GitHub — it helps!

## 📝 License

This project is [MIT](lic.url) licensed.