From e809998d3e48c2c039d489115abbda75102b1b10 Mon Sep 17 00:00:00 2001 From: Kiyotoko Date: Sat, 28 Sep 2024 16:00:53 +0200 Subject: [PATCH] Add options to readme --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 41 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 572be86..fc71517 100644 --- a/README.md +++ b/README.md @@ -39,24 +39,59 @@ For building it on your own: 1. Clone this repository or download the latest release: `git clone https://github.com/seekers-dev/seekers-py.git` 2. Run the setup script: `bash setup.py` (linux) or `.\setup.bat` (win32) -### Create server and run clients +### Run seekers -This will: -* start a Seekers Game -* run a gRPC server by default +If you want to run the seekers game with the AI files, you should run the following command: ```shell python seekers.py ``` -### Run one single client +This script has the following options on the command line: -⚠ You will need a separate server running. This can be the server above, or, for example, [the Java implementation](https://github.com/seekers-dev/seekers-api). +```log +options: + -h, --help show this help message and exit + --no-grpc Don't host a gRPC server. + --no-kill Don't kill the process after the game is over. + --debug Enable debug mode. This will enable debug drawing. + --address ADDRESS, -a ADDRESS + Address of the server. (default: localhost:7777) + --config CONFIG, -c CONFIG + Path to the config file. (default: config.ini) + --config-override CONFIG_OVERRIDE, --override CONFIG_OVERRIDE, -o CONFIG_OVERRIDE + Override a config option. Use the form option=value, + e.g. global.seed=43. + --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}, + --log {DEBUG,INFO,WARNING,ERROR,CRITICAL}, + -l {DEBUG,INFO,WARNING,ERROR,CRITICAL} +``` + +### Run a client + +> [!NOTE] +> You will need a separate server running. This can be the server above, or, for example, [the Java implementation](https://github.com/seekers-dev/seekers-api). ```shell python client.py ``` +This script has the following options on the command line: + +``` +options: + -h, --help show this help message and exit + --address ADDRESS, -a ADDRESS + Address of the Seekers game. (default: localhost:7777) + --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}, + --log {DEBUG,INFO,WARNING,ERROR,CRITICAL}, + -l {DEBUG,INFO,WARNING,ERROR,CRITICAL} + --careful Enable careful mode for the gRPC clients. This will + raise an exception and stop the client when errors + occur that otherwise would be ignored. +``` + + ## License You can, and are invited to, use, redistribute and modify seekers under the terms