#Put your AI folder in folder ./ai

Game Rule

Please follow this link

Game Options

Start the game by running SixNimmt.py and feed the path to the AIs that you want to use for the game.

python SixNimmt.py ai/example/exampleai.py ai/example/exampleai.py

There's a fast way to use the same AI for more than once: prefix the number and * before the path.

python SixNimmt.py 2*ai/example/exampleai.py

The default mode is tournament mode. In this mode, the game will end as long as a player reaches a certain score. The default value of this score is 100, and you can change it by passing the value to --score or -s argument.

python SixNimmt.py 2*ai/example/exampleai.py -s 300

There's another mode called official mode. In this mode, one set of cards is generated and every player will receive every hand in this set once. This is fairer than the tournament mode. You can set how many rounds you want to do this by passing the value to --rounds or -r argument, the default value is 1.

python SixNimmy.py 2*ai/example/exampleai/py -r 3

The random seed is generated randomly by default. However, if you want to use the same seed for testing purpose, you can specify the seed you want to use with --seed argument. The game will behave the same if the seed is specified.

python SixNimmy.py 2*ai/example/exampleai/py --seed 123

If you don't need the info to the stdout generated by the game, you can pass --quiet or -q to get rid of it.

python SixNimmt.py 2*ai/example/exampleai.py -q

Comunication Protocol:

All the communications are by stdin and stdout.

Every packet from the game to the ai are in the following form:

<HEADER>|<SUBHEADER>|<DATA>

<HEADER> could be either INFO or CMD. INFO requires no response from the AI client, whereas CMD requires a single line of respose from stdout from the AI client.

<SUBHEADER> is the type of the request. It defines what kind of message the game is sending.

<DATA> is the corresponding data for <SUBHEADER>, which will be explained below.

Message explanation

The detailed message type and data are listed in this section.

INFO|SETUP|<DATA>:

This is a initialization message for AI. <DATA> is a dictionary with 2 keys(for now).

• "name": the official name you will have when you receive data in the future
• "playerNum": the total number of players

example:INFO|SETUP|{"name":"p1", "playerNum":2}

INFO|NEWGAME|<DATA>:

Send the signal that a new game is generated. <DATA> is a list of cards that you will start with. This packet is private to the players.

example:INFO|NEWGAME|[1,2,3,4,5,6,7,8,9,10]

INFO|GAME|<DATA>:

Send the info of the game data. This packet will be sent before every new round. <DATA> is a dictionary where there are 2 keys:

• "rows": a list of four lists, representing four rows of the current game
• "players": a dictionary of all the players, in which the key is the name of the player and the value is their score

example:INFO|GAME|{"rows":[[1],[2],[3],[4]],"players":{"p1":0, "p2":1}}

INFO|MOVE|<DATA>:

Send the info of a move of the round of all players. <DATA> is a dictionary where the keys are the players' names and the corresponding value is the cards they play.

example: INFO|MOVE|{"p1":1, "p2":2}

INFO|SCORE|<DATA>:

Send the info of the score the player gets. This packet happens after a player puts the sixth card of a row, or a player puts the smallest card and picks a row from the game. <DATA> is a dictionary where there are 3 keys:

• "player": the player that gets the score
• "cards": a list of cards the player gets
• "score": the total score the player gets

example:INFO|SCORE|{"player":"p1", "cards":[1,2], "score":2}

INFO|GAMEEND|<DATA>:

Send the info that the game ends. The program should quit when received this message. <DATA> is a dictionary with the final score.

example:INFO|GAMEEND|{"p1":105, "p2":78}

CMD|PICKCARD:

Request the player to pick a card from their hand. They response should be a number in stdout with '\n' in the end.

CMD|PICKROW:

Request the player to pick a row of the current game. This only happens if a player plays the smallest card among all players and the card is smaller than the smallest card of all the end card in rows. The response should be 0-3 with '\n' in the end.