107 lines
2.6 KiB
Python
107 lines
2.6 KiB
Python
"""
|
|
This module offers a small place to start building game clients from.
|
|
|
|
You can use this for:
|
|
|
|
- Learning how the system works.
|
|
- Debugging a game server.
|
|
- Debugging a game that behaves weirdly.
|
|
|
|
This module lets you host a game, let online servers participate in it,
|
|
and then analyze the outcome.
|
|
|
|
|
|
You can build several things with this:
|
|
|
|
1. You can build an AI trainer that trains on existing players.
|
|
2. You can build an ELO evaluator that compares the performance of various
|
|
strategies.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import pyclient
|
|
|
|
# Import your game(s) here
|
|
from pyclient.games import TicTacToe
|
|
# ...
|
|
|
|
# Import your agent(s) here
|
|
from agents import Agent, AgentOfChaos
|
|
# from agents.my_agent import MyAgent
|
|
# ...
|
|
|
|
def main() -> int:
|
|
"""
|
|
Start a client, then use it to analyze one or more matches.
|
|
|
|
:return: Exit code
|
|
:rtype: int
|
|
"""
|
|
|
|
# Start the game engine
|
|
c = pyclient.PyClient(debug=True)
|
|
|
|
# Mix and match any agents you'd like.
|
|
# During development it's usually easiest to play against AgentOfChaos().
|
|
players : list[Agent] = [
|
|
AgentOfChaos(),
|
|
AgentOfChaos(),
|
|
]
|
|
|
|
# Play a given game with your players
|
|
result = c.play_game(
|
|
players=players,
|
|
start=TicTacToe.empty(),
|
|
)
|
|
|
|
# Print the game results to the terminal!
|
|
inspect_game(result)
|
|
|
|
return 0
|
|
|
|
|
|
def inspect_game(game : pyclient.GameReplay) -> None:
|
|
"""
|
|
Print a diagnostic of a played game to the terminal.
|
|
|
|
:param game: The results of a played game.
|
|
:type game: pyclient.GameReplay
|
|
"""
|
|
max_width = 40
|
|
hbar = max_width * '%'
|
|
|
|
def title(s : str) -> None:
|
|
"""
|
|
Show a title nice and clean in the middle
|
|
|
|
:param s: The title to display
|
|
:type s: str
|
|
"""
|
|
w = (max_width - len(s)) // 2
|
|
|
|
print(hbar)
|
|
print((w * ' ') + s.upper() + (w * ' '))
|
|
print(hbar)
|
|
|
|
# Show all moves made throughout the game
|
|
title("Turns taken")
|
|
for turn in game.turns:
|
|
print(f"Player {turn.player} : " + json.dumps(turn.action)[:max_width-12])
|
|
|
|
# Show all remaining variables in the finishing state of the game
|
|
title("Final state")
|
|
final_state = game.turns[-1].state
|
|
for k, v in final_state.to_dict().items():
|
|
print(f"{k} => {json.dumps(v)}")
|
|
|
|
# Some final (usually the most relevant) statistics
|
|
title("Result")
|
|
print(f"Total turns taken: {len(game.turns)}")
|
|
print(f"Result: {final_state.winner()}")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|