Tic Tac Toe

🎮 Overview

This tic-tac-toe contract provides an example of building a game on WAX, complete with secure use of random values to determine game outcomes.

This will guide you how to make the Tictactoe game contract which run on Wax blockchain. Logic of the tictactoe game follow the eosio sample at Tic-tac-toe Game EOS tutorial, but we'll add more logic that support randomize the first turner and random game move if playing with bot.

Frontend Tutorial

Smart Contract Tutorial

How To Play

Tic Tac Toe is a classic game enjoyed by people of all ages. It's simple to learn but can be surprisingly strategic. Here's a step-by-step guide on how to play:

Visit game: https://tictactoe.wax.io/

1. Setup: Click Play Game

And choose `New Game`

2. Players: Tic Tac Toe is typically played by two players. One player is assigned "X" and the other "O".

3. Objective: The goal is to be the first to create a row of three of your marks (X's or O's) either horizontally, vertically, or diagonally.

4. Gameplay: Players take turns placing their mark (X or O) in an empty square on the grid.

5. Turns: The player assigned "X" usually goes first, followed by the player assigned "O". Players continue taking turns until one player wins or the grid is full (resulting in a tie).

6. Winning: A player wins the game if they successfully create a row of three of their marks either horizontally, vertically, or diagonally. If a player achieves this, they declare "Tic Tac Toe!" and are declared the winner.

7. Ties: If all squares are filled without either player achieving three in a row, the game ends in a tie.

Notes: The winner of the game will get a reward of 10 TIC token (the token issued by the game)

8. Rematch: Players can easily start a new game and beginning again.

🛠️ Technologies Utilized

• Vite: Elevate your development workflow with Vite, a toolset tailored for swift and efficient web project creation.
• WAXP Blockchain: Embrace the decentralized ethos with the WAXP blockchain, fostering secure, transparent smart contract interactions for gaming experiences.

🚀 Getting Started

Prerequisites

Ensure the following prerequisites are met before embarking on your journey:

Node.js (Version: 16.16.0) or Yarn (Version: 1.22.17) & npm (Version: 9.6.7) installed on your machine.

📋 Installation & Setup

1. Clone the Repository:

git clone [email protected]:worldwide-asset-exchange/tic-tac-toe-front-end.git

2. Navigate to the Project Directory:

cd tic-tac-toe-front-end

3. Install Dependencies:

npm install

OR

yarn

4. Configure Environment Variables: Create a .env file with the following configuration:

VITE_PUBLIC_URL=http://localhost:5173

5. Initiate Development Server:

npm run dev

OR

yarn run dev

6. Access & Engage: Navigate to http://localhost:5173 and immerse yourself in the blockchain-powered Tic Tac Toe experience.

🐳 Docker Integration

🛠️ Build & Launch Containers

Execute the following command in your terminal within the project directory:

docker-compose up --build

Access your application at http://localhost:5173 (or the designated port as specified in your docker-compose.yml).

🛑 Terminate Containers

To gracefully halt and remove containers, execute:

docker-compose down

🤝 Contributing

Open arms and open source! We encourage community contributions. Please feel free to submit issues, suggest enhancements, or create pull requests to foster collaborative growth.

📜 License

This repository operates under the MIT License. Kindly refer to the LICENSE.md file for comprehensive details and stipulations.