Autogames

• Overview
• Install
• Example
• Usage
  • Where should I write?
  • Start game
    • Python
    • C
    • Human mode
• Available games
  • tictactoe
  • Othello
• Available environments
  • OS
  • Languages

Overview

You can try your own game AI program with a lot of boardgames and programming languages.

Install

git clone https://github.com/HiroIshida/autogames.git
cd autogames
pip install --user .

Example

For example, you can try othello demo. Two computer agents automatically fight against each other.

# server of othello game
autogames_server --game othello_game --port 65432 &
sleep 0.3
# computer player1 with Python
python autogames/client/python/client.py --port 65432 --agent-file example_agent_othello &
sleep 0.3
# computer player2 with Python
python autogames/client/python/client.py --port 65432 --agent-file example_agent_othello &

You can fight against computer agents as a player.

# server of othello game
autogames_server --game othello_game --port 65432 &
sleep 0.3
# computer player with Python
python autogames/client/python/client.py --port 65432 --agent-file example_agent_othello --timeout 30 &
sleep 0.3
# human player (you)
python autogames/client/python/client.py --port 65432 --agent-file human_agent --timeout 30

or you can type ./autogames/test/check_human_mode.sh

Usage

Where should I write?

You can use think function in autogames/client/(LANGUAGE)/agents/(AGENT_FLIE) for the main function of game algorithm

Example implementation of othello agent is like below. (autogames/client/python/agents/example_agent_tictactoe.py)

def think(self):
    return (random.randint(0, 2), random.randint(0, 2))

Start game

First, you create game server. (You can call the commands below in eigher single or different terminals.)

# Start game server. you can list up game types (GAME_TYPE) by autogames_server --list
autogames_server --game (GAME_TYPE) --port 65432 &

Then, you can create game agent with many languages.

Python (recommended)

# Create game player. AGENT_FLIE is the file name in agents dir (e.g. example_agent_othello)
python autogames/client/python/client.py --port 65432 --agent-file (AGENT_FLIE) &

C

# compile C program
cd autogames/client/c/;
# AGENT_FLIE: e.g. example_agent_tictactoe.c
make client_c AGENT_FILE=(AGENT_FLIE);
cd -;
# your agent
./autogames/client/c/client_c 65432 &

Human mode

# human mode. You can play game interactively.
python autogames/client/python/client.py --port 65432 --agent-file human_agent --timeout 30

NOTE: In the human mode, you should make timeout arguments in the both client longer, because human thinks for longer time than computers.

Available games

tictactoe

• 三目並べ(sanmoku narabe) in japanese　（この辺にゲームの画像貼る）

   0 1 2
 0|X|O|X|
 1|O|X|O|
 2|X|O|X|

• （言語間で名前が統一された）変数や関数の用途を説明する
• どういう情報をsocket通信したらよいかを説明する（？）。ユーザ向けではないが。
• JSON style used in socket communication (for developer)

{"field": [[0, 0, 0], [0, 0, 0], [0, 0, 0]], "move": null}

• これは、実際にtest.jsonを作ってどこかのディレクトリに置き、travisのテストに利用したほうがいいかも。

Othello

• オセロ、リバーシ(othello game)

   0 1 2 3 4 5 6 7
 0| | | | | | | | |
 1| | | | | | | | |
 2| | | | | | | | |
 3| | | |X|O| | | |
 4| | | |O|X| | | |
 5| | | | | | | | |
 6| | | | | | | | |
 7| | | | | | | | |

• Json style used in socket communication (for developer)

{"field": [[0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 1, -1, 0, 0, 0], [0, 0, 0, -1, 1, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0], [0, 0, 0, 0, 0, 0, 0, 0]], "move": null}

• これは、実際にtest.jsonを作ってどこかのディレクトリに置き、travisのテストに利用したほうがいいかも。

Available environments

OS

• Linux:
  • Ubuntu 16.04
• Windows
  • No data
• Mac
  • No data

Languages

• Python 2.7
• Python 3.6
• C (gcc 5.4.0)