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
- Host: GitHub
- URL: https://github.com/ellypaws/tic-tac-go
- Owner: ellypaws
- Created: 2023-10-07T07:39:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-08T04:45:32.000Z (over 1 year ago)
- Last Synced: 2025-02-15T08:38:40.958Z (4 months ago)
- Topics: bubbletea, go
- Language: Go
- Homepage:
- Size: 42 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
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 |
## 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!