Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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: 4 days ago
JSON representation

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

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
```