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

https://github.com/joffrey-bion/seven-wonders

A digital version of the 7 Wonders board game
https://github.com/joffrey-bion/seven-wonders

board-game game seven-wonders

Last synced: 4 months ago
JSON representation

A digital version of the 7 Wonders board game

Awesome Lists containing this project

README

        

# Seven Wonders Online

[![Online Status](https://img.shields.io/website?up_message=online&url=http%3A%2F%2Fseven-wonders.hildan.org)](http://seven-wonders.hildan.org)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/joffrey-bion/seven-wonders/blob/master/LICENSE)

A digital version of the [7 Wonders board game](https://en.wikipedia.org/wiki/7_Wonders_(board_game)).

> :warning: **DISCLAIMER:** We do not own the rights on the 7 Wonders game concept and rules,
> nor on the assets used here. This is a pet project, not intended to be sold.

## Try it!

You can play it for free on http://seven-wonders.hildan.org.

:construction: The game is still under development.
It is possible that you experience a server restart when new versions are released.

### Self-hosted

The game is published as a [Docker image on DockerHub](https://hub.docker.com/r/hildan/seven-wonders-server).

If you have [Docker](https://www.docker.com/) installed, you can run the server on your own machine by running:

```
docker run -p 80:80 hildan/seven-wonders-server
```

And then go to `http://localhost` in your browser to play (add some bots if you're alone).

## Technicalities

This project is written 100% in Kotlin. You can find the history of the technical decisions in the
[decisions history](doc/decisions_history.md) document.

This project uses websockets and STOMP for the communication between frontend and backend.
For this, it uses the [krossbow](https://github.com/joffrey-bion/krossbow) multiplatform library.

## How does it look?

The game contains all the features of the actual board game:

- Play cards, discard, or upgrade your wonder
- Buy resources from your neighbours
- Special bonuses: pick from discarded cards, play your last 2 cards, copy neighbour guild etc.

There are also some features you can only get online:

- Add bots to play with you, even if you're less than the minimum 3 players
- The game greys out the cards you can't afford and the actions you can't perform
- You can see a preview of the cost of each action (play or upgrade)
- Save time to compute the score!

Some screenshots:

| Basic board | Hover to see your hand|
| --- | --- |
| ![Basic board](doc/screenshots/basic-board.png?s=250) | ![Hand hover](doc/screenshots/hand-hover2.png) |

Preview your opponents' boards:

| In front | Left neighbour | Right neighbour |
| --- | --- | --- |
| ![Board preview 1](doc/screenshots/neighbour-preview1.png?s=300) | ![Board preview 2](doc/screenshots/neighbour-preview2.png?s=200) | ![Board preview 3](doc/screenshots/neighbour-preview3.png) |