An open API service indexing awesome lists of open source software.

https://github.com/ellypaws/tic-tac-go

Tic-Tac-Toe game that uses bubbbletea and bubblezone components
https://github.com/ellypaws/tic-tac-go

bubbletea go

Last synced: 2 months ago
JSON representation

Tic-Tac-Toe game that uses bubbbletea and bubblezone components

Awesome Lists containing this project

README

        

# Tic-Tac-Toe Game

This is a simple command-line Tic-Tac-Toe game implemented in Go using the Bubble Tea framework, along with BubbleZone for mouse controls. You can play the game in your terminal with your keyboard or mouse.

## Usage

1. Clone the repository:

```bash
git clone https://github.com/your-username/tic-tac-toe.git
```

2. Change the directory to the project folder:

```bash
cd tic-tac-toe
```

3. Build and run the game:

```bash
go build
./tic-tac-toe
```

4. Use the following controls to play:

- Arrow keys: Move the cursor
- Enter: Place your symbol (X or O) on the selected cell
- Q: Quit the game

Alternatively, you can use your mouse to interact with the game board:

- Move your mouse cursor to select a cell.
- Left-click to place your symbol in the selected cell.

5. Win the game by getting three of your symbols in a row horizontally, vertically, or diagonally.

6. Enjoy playing Tic-Tac-Toe!

## Game Rules

- The game is played on a 3x3 grid.
- Player X starts the game.
- Players take turns to place their symbol (X or O) on an empty cell.
- The game ends when one player wins or when the board is full (a draw).
- To win, a player must have three of their symbols in a row horizontally, vertically, or diagonally.
- If the board is full and no player has won, the game is a draw.

## Controls

Keyboard Controls:
- Use arrow keys to move the cursor to select a cell.
- Press Enter to place your symbol in the selected cell.
- Press Q to quit the game at any time.

Mouse Controls (BubbleZone):
- Move your mouse cursor to select a cell.
- Left-click to place your symbol in the selected cell.

### Keys

| Key | Action |
|-------------------------------------------|-------------------------------|
| / | Move cursor horizontally |
| / | Move cursor vertically |
| Enter / 🖱️ | Place symbol in selected cell |
| Q | Quit the game |

Go Gopher climbing a ladder.

## Todo
- [x] Implement AI for single-player mode
- [x] Difficulty levels for AI
- [ ] Neural network

Enjoy the game and challenge your friends or the AI (coming soon) in this classic game of Tic-Tac-Toe!