Kalah Game

Introduction

Kalah a.k.a Mancala is a generic name for a family of 2-player turn-based strategy board games played with small stones, beans, or seeds and rows of holes or pits in the earth, a board or other playing surface.

For further information please visit Wikipedia Kalah Game Page

Project

This project is a n player, m pits, k stones online multiplayer implementation of the original game.

Kalah-Game multi module project consists of the following modules:

kalah-backend : spring boot, maven, junit, lombok, docker, swagger, aspect, websocket (spring cloud - not implemented yet)
kalah-frontend : spring boot, maven
- kalah-ui : react, node, npm, webpack, websocket(sockjs, stompjs)
kalah-service-gateway: spring cloud(eureka, zuul, config) - not implemented yet

Usage

Using docker

cd kalah-game
docker-compose up

docker run -p8080:8080 bahadiryilmaz/kalah-backend
docker run -p3060:3060 bahadiryilmaz/kalah-frontend

Backend Swagger UI => http://localhost:8080/swagger-ui.html Frontend => http://localhost:3060/kalah

Build from source

Prerequisites:

Java 8
Maven 3
Node v10 & npm v6

git clone https://github.com/yilmazbahadir/kalah-game.git

cd kalah-game
mvn clean install

cd ./kalah-backend/target
java -jar kalah-backend-1.0-SNAPSHOT.jar

cd ./kalah-frontend/target
java -jar kalah-frontend-1.0-SNAPSHOT.jar

Backend Swagger UI => http://localhost:8080/swagger-ui.html

Frontend => http://localhost:3060/kalah

How to play

List games or create one
```
http://localhost:3060/kalah
```

Create a game

Game is configurable, you can set
* Number of players
* Number of pits
* Number of stones in each pit

List and join the created game

Set a player name. But inside the game assigned player ID will be used.

Play game - make a move
When game is finished