aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIlion Beyst <ilion.beyst@gmail.com>2022-07-23 00:38:44 +0200
committerIlion Beyst <ilion.beyst@gmail.com>2022-07-23 00:38:44 +0200
commit5e560b23f8305c3a700ef722ea3ba278bc30fbca (patch)
treeb210ba0a16b966179201b4d05fda3d6870905f1f
parent500061375cae4700cb13a50705f627ba06835038 (diff)
downloadplanetwars.dev-5e560b23f8305c3a700ef722ea3ba278bc30fbca.tar.xz
planetwars.dev-5e560b23f8305c3a700ef722ea3ba278bc30fbca.zip
update README
-rw-r--r--README.md1
-rw-r--r--planetwars-client/README.md24
2 files changed, 25 insertions, 0 deletions
diff --git a/README.md b/README.md
index c7d98af..89c5d66 100644
--- a/README.md
+++ b/README.md
@@ -17,5 +17,6 @@ Project layout:
- `planetwars-server`: rust webserver
- `planetwars-matchrunner`: code for running matches
- `planetwars-rules`: implements the game rules
+- `planetwars-client`: for running your bot locally
- `web/pw-server`: frontend
- `web/pw-visualizer`: code for the visualizer
diff --git a/planetwars-client/README.md b/planetwars-client/README.md
new file mode 100644
index 0000000..bffee30
--- /dev/null
+++ b/planetwars-client/README.md
@@ -0,0 +1,24 @@
+# planetwars-client
+
+`planetwars-client` can be used to play a match with your bot running on your own machine.
+
+## Usage
+
+First, create a config `mybot.toml`:
+
+```toml
+# Comand to run when starting the bot.
+# Argv style also supported: ["python", "simplebot.py"]
+command = "python simplebot.py"
+
+# Directory in which to run the command.
+# It is recommended to use an absolute path here.
+working_directory = "/home/user/simplebot"
+```
+
+Then play a match: `planetwars-client /path/to/mybot.toml opponent_name`
+
+## Building
+- Obtain rust compiler through https://rustup.rs/ or your package manager
+- Checkout this repository
+- Run `cargo install --path .` in the `planetwars-client` directory \ No newline at end of file