Tablut game client in Python. Made for the Tablut challenge project for the 2022 FAIKR course module 1 of the master degree in AI (University Of Bologna)
Make sure you have Python 3 on your system, then install pipenv
:
pip install pipenv
Once you have cloned the repo, go into its root folder and run
pipenv install # installs required packages
pipenv install -d # installs development packages
You are now ready to run the client.
runmyplayer.sh
is a shell script that directly launches the client with a given role (etiher "WHITE" or "BLACK") and
a given ip address.
Alternatively, the client can be run using the following arguments:
usage: main.py [-h] [-p PORT] [-i IP] [-l] [-t MAX_TURNS] [-d DEPTH]
{BLACK,WHITE}
positional arguments:
{BLACK,WHITE} Player role (either 'BLACK' or 'WHITE')
options:
-h, --help show this help message and exit
-p PORT, --port PORT Server connection port (defaults to 5800 for WHITE and
5801 for BLACK)
-i IP, --ip IP Server IP address (defaults to localhost)
-l, --local Do not connect to server and run player against itself
locally
-t MAX_TURNS, --max-turns MAX_TURNS
Maximum number of turns for local game (implies
--local)
-d DEPTH, --depth DEPTH
Minmax tree maximum depth (default is 3, value <= 0 to
ignore depth cutoff)
Usually, the only two required arguments are the player role (always required) and the server IP address (could run on localhost, most likely the server is on a different computer).
Note that the client requires the pipenv environment to be active, meaning that you need to run pipenv shell
before
launching the client.
Refer to the reference repo to know how to run the game server yourself.