ドキュメント構造
- README.md コヨーテ AI competition のGitHubでのAI対戦のさせ方などが乗っています。
- cAc.md コヨーテAI competition のルールや,大会概要・環境構築が乗っています。
Singularityまたは、WSL2のPython3.12環境で以下のコマンドをたたいてください。
コマンドは
source ./setup.sh二回目以降でターミナル開いたときはSingularityのコンテナに入り、
source ./setup_session.shを行ってください。
AIの運用は基本的に開発者には、Websocket通信を行う必要はありません。 Python3.12のみを使って開発する場合は以下の指示に従ってください。 もし他言語や異なるPython環境をもちいて開発したい場合はWebsocket通信を行う必要があります。 その場合はWebsocket通信のセクションを参考にしてください。また不明点がある場合は、Discordにて運営へお知らせください。
AIの実装は、client/sample_arena_client.pyにを参考にしてrootディレクトリに[チーム名もしくはユーザー名].pyを作成してください。
AIの実装は、AI_player_actionメソッドをオーバーライドすることで行います。
このメソッドは、AIが行うアクションを決定するためのものです。
事前に作った AI でプレイしたい場合は、以下のように追加してください！
arena.py
from client.sample_arena_client import SampleClient as SampleClient
predefs = [
[SampleClient(player_name="PreAI1", is_ai=True), "PreAI1"],
[SampleClient(player_name="PreAI2", is_ai=True), "PreAI2"]
# ここに作ったクライアントを追加していく-> これが基本の設定になる
]
arena = Arena(total_matches=5, predefined_clients=predefs)
arena.run()その後実行
/$ python3 arena.py
WebSocket通信で行う場合も同様な関数を持つクラスを作成してください。
ただし継承するクラスはclient/sample_arena_client.pyのSampleClientではなく、client/websocket_client.pyのWebSocketClientを継承してください。このクラスは、WebSocket通信を行うためのクライアントクラスです。基本的にarena.pyでの実行と同じように実装することが出来ます。
- server の立ち上げ
/server$ python3 server.py
- client の立ち上げ
/client$ python3 main.py
Enter room ID (default: test-room):
Enter server port (default: 5000):
Enter player name (default: player1):
Engine.IO connection established
websocket-client package not installed, only polling transport is available
Namespace / is connected
Connected to server
Emitting event "join_room" [/]
Enter command (start, log, exit): Received event "room_message" [/]
Message from server: {'header': 'join_room', 'msg': 'player1 has joined the room!', 'room_id': 'test-room'}
これになったら、Enter を押す
Enter command (start, log, exit):
これが出てくるので、start と入力し、Enter
Enter number of games:
で対戦の数を入れる
山札内容
-10---------×1
-5----------×2
0-----------×3
1~5---------×4
10----------×3
15----------×2
20----------×1
×2----------×1 100 場の数の合計を二倍する
max→0-------×1 101 場に出ているカードの中で最大の数を１つだけ０にする
0(黒)-------×1 102 ラウンド終了時山札をシャッフルする
?-----------×1 103「コヨーテ」が宣言されたら、山札からあらたに１枚引いてその数に置き換わります
このコヨーテは六人用です
turn の数、誰がやったか、action(宣言した数)
[{'turn_count': 0, 'turn_player': 'PreAI1', 'action': 8},
{'turn_count': 1, 'turn_player': 'PreAI2', 'action': 9},
{'turn_count': 2, 'turn_player': 'PreAI1', 'action': 14},
{'turn_count': 3, 'turn_player': 'PreAI2', 'action': 17},
{'turn_count': 4, 'turn_player': 'PreAI1', 'action': 25}]
name : player の名前 card_info : None(observer 用なので開発者は気にしなくて大丈夫です) life : その人の life is_next : 次のターンの人か is_prev : 前のターンの人か
[
{'name': 'PreAI2', 'card_info': None, 'life': 2, 'is_next': True, 'is_prev': False},
{'name': 'AI_4', 'card_info': None, 'life': 1, 'is_next': False, 'is_prev': True}
]
自分から見える他の人の sum
-1 : coyote するときに返す その他の数字 : coyote するときに宣言できる数字
[-1, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]