about summary refs log tree commit diff
diff options
context:
space:
mode:
authorEmile <hanemile@protonmail.com>2020-02-23 16:49:08 +0100
committerEmile <hanemile@protonmail.com>2020-02-23 16:49:08 +0100
commit6447b345cdf15ea72eed29b0c283b4562d7db857 (patch)
tree4d543c59e07388b8a3c0eff2e82f722bb4cec194
parent90acbdf0866842a4695848c5fcd9ecf261a4040b (diff)
basic usage instruction in the readme
-rw-r--r--README.md36
1 files changed, 35 insertions, 1 deletions
diff --git a/README.md b/README.md
index c62ef7b..2af992d 100644
--- a/README.md
+++ b/README.md
@@ -8,4 +8,38 @@ The goal of r2wars is to place two bots in as shared memory space and let
 them battle against each other until one of them cannot run anymore, because
 of some kind of broken instruction.
 
-A more informal README can be found [here](https://github.com/radareorg/radare2-extras/tree/master/r2wars).
\ No newline at end of file
+A more informal README can be found [here](https://github.com/radareorg/radare2-extras/tree/master/r2wars).
+
+## Usage
+
+You'll probably first of all want to simply play with the two provided bots. In order to do so, run the game like this:
+
+```go
+go run ./... -t 1s -v ./bots/warrior0.asm ./bots/warrior1.asm
+```
+
+This runs the game with a round duration of 1 second and an info verbosity
+level using the two provided bots. You can attach more bots if you'd like,
+each bot increases the arena size by 512 bytes by default.
+
+You can tweak most of the settings as displayed in the help:
+
+```go
+$ go run ./... -h
+Usage of src:
+  -arch string
+    	bot architecture (mips|arm|x86) (default "x86")
+  -bits int
+    	bot bitness (8|16|32|64) (default 32)
+  -maxProgSize int
+    	the maximum bot size (default 64)
+  -memPerBot int
+    	the amount of memory each bot should add to the arena (default 512)
+  -t duration
+    	The duration of a round (default 250ns)
+  -v	info
+  -vv
+    	debug
+  -vvv
+    	trace
+```
\ No newline at end of file