https://github.com/viet281101/gomoku

Online board game for multiplayer (1vs1) or single-player solo with AI -– Gomoku (Five in a Row)
https://github.com/viet281101/gomoku

board-game django django-game gomoku gomoku-ai gomoku-game gomoku-study multiplayer multiplayer-game online-multiplayer-game react-tsx typescript-game typescript-react

Last synced: about 2 months ago
JSON representation

Online board game for multiplayer (1vs1) or single-player solo with AI -– Gomoku (Five in a Row)

• Host: GitHub
• URL: https://github.com/viet281101/gomoku
• Owner: Viet281101
• License: mit
• Created: 2024-07-10T15:10:59.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-07-21T00:21:10.000Z (10 months ago)
• Last Synced: 2025-02-13T19:36:43.534Z (3 months ago)
• Topics: board-game, django, django-game, gomoku, gomoku-ai, gomoku-game, gomoku-study, multiplayer, multiplayer-game, online-multiplayer-game, react-tsx, typescript-game, typescript-react
• Language: TypeScript
• Homepage: https://viet281101.github.io/Gomoku/
• Size: 14.1 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Gomoku (Five in a Row)

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/Viet281101/Gomoku) ![Github language count](https://img.shields.io/github/languages/count/Viet281101/Gomoku) ![GitHub Created At](https://img.shields.io/github/created-at/Viet281101/Gomoku)

Gomoku is a classic strategy board game played by two players.

The game is typically played on a 15x15 grid, where players take turns placing black or white stones on the intersections.

The objective is to be the first to align five stones in a row horizontally, vertically, or diagonally.

The simplicity of the rules contrasts with the game's strategic depth, making it a challenging and engaging pastime.

[![alt text](gomoku_frontend/public/vite.svg)](https://vitejs.dev/) **&** [![alt text](gomoku_frontend/public/react.svg)](https://react.dev/)  **&** [![alt text](gomoku_frontend/public/typescript.svg)](https://www.typescriptlang.org/) **&** ![alt text](gomoku_frontend/public/tailwind.svg) **&** [![alt text](gomoku_frontend/public/django.png)](https://www.djangoproject.com/)

![demo_gomoku](https://github.com/user-attachments/assets/1543c009-8801-4a7f-9d6e-1e783f69d5cb)

### Install & Debug

Install project:

```bash

git clone https://github.com/Viet281101/Gomoku.git

cd Gomoku/

```

#### Backend (Django)

Install [Python](https://www.python.org/) then:

- Run virtual environment:

```bash

python3 -m venv env

source env/bin/activate

```

- Install [Django](https://www.djangoproject.com/download/) & libraries by using `requirements.txt` file:

```bash

pip install requirements.txt

cd gomoku_backend/

```

- Create & Apply migrations:

```bash

python manage.py makemigrations game

python manage.py migrate

```

- Create Django admin user & add more users:

```bash

python manage.py createsuperuser

```

then

```bash

python manage.py create_default_users

```

or

```bash

python manage.py shell < shell.py

```

- Run server django:

```bash

python manage.py runserver

```

#### Frontend (React TypeScript)

- Use `npm` to debug:

```bash

cd gomoku_frontend/

npm install

npm run dev

```