From 6447b345cdf15ea72eed29b0c283b4562d7db857 Mon Sep 17 00:00:00 2001 From: Emile Date: Sun, 23 Feb 2020 16:49:08 +0100 Subject: basic usage instruction in the readme --- README.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) 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 -- cgit 1.4.1