ronanboiteau/coinche

Multiplayer online Coinche game written in C#, using the .NET Core framework.

Coinche

This is a .NET online Coinche game. It requires 4 players to play. You can find the rules of this game on Wikipedia. If you want a more comprehensive version, here are the offical rules (in French), as defined by the Fédération Française de Belote.

Getting Started

Requirements

To build and run the project you need to install:

• .NET Core 2.0.2

How to run the server & clients

Running the server

To run the Coinche server, use your terminal to navigate to the Server/ folder located at the root of the repository & then run:

dotnet run

Running clients

To run Coinche clients, use your terminal to navigate to the Client/ folder located at the root of the repository & then run:

dotnet run

You can also use the following command if you want to run a client as an Artificial Intelligence:

dotnet run AI

You need to run 4 clients to start a Coinche game.

How to play

Once you've run the 4 clients, the game starts. You are now a player in a team of 2.

Bidding

You are given 8 cards with different IDs. ex.:

Here is your card deck:
| (18) 9 HEARTS | (2) 9 DIAMONDS | (21) Q HEARTS | (15) A CLUBS | (6) K DIAMONDS |

For the game to start, a player needs to make the highest bid (https://en.wikipedia.org/wiki/Coinche#Bidding). To make a bid you need to specify the value of your bid (80, 90, 100, 110, 120, 130, 140, 150 or 160) and a card suit (HEARTS, DIAMONDS, CLUBS or SPADES). Bidding example:

80 SPADES

To pass, you just need to type:

PASS

If every player has passed, the cards are re-drawn and the bidding starts again. The bidding stops when only one player bids and allf the other ones pass or if someone has surcoinche'd.

Game

The player who made the highest bid starts. He needs to type the ID (shown in the deck between parenthesis) of the card he wants to play.

18

After that, every player has to play. The one who wins the trick will increase the score of his team.

Once all the players are out of cards, the game ends. If the team who made the bid has at least the points of their contract and has more points than the other team, they win, and the other team looses.

Protocol

Server

Commands sent by the server to the clients.

Command	Description
MSG [message to send]	Send a message
DECK [cards IDs]	Send the player's deck
BID	Ask the player to bid
BID OK	Accept the player's bid
BID KO	Player's bid failed, ask him to bid again
BID STOP	Stop the bidding
BID RESET	Start another round of bidding when all the players have passed
PLAY	Ask the client to play a card
PLAY KO	Illegal play, ask the client to select another card
PLAY OK	The card has been played
END	End of the game

Client

Commands sent by the clients to the server.

Command	Description
BID N	Pass, don't bid
BID Y [bid]	Send a bid to the server. [bid] can be an amount of points along with a suit (ex: "80 SPADES"), "COINCHE" or "SURCOINCHE"
PLAY [card ID]	Send the card to play to the server

Unit tests

If you'd like to use Coinche's Xunit unit tests or create new tests for features you added, you can use the Test project inside the Test/ directory.

Use the command dotnet test to run Coinche's unit tests.