From 78b079df5a26ce94142737605ec36ddde8310336 Mon Sep 17 00:00:00 2001 From: troido Date: Mon, 18 May 2020 10:42:41 +0200 Subject: update readme with installation instructions --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index b209194..53e22ad 100644 --- a/README.md +++ b/README.md @@ -14,3 +14,53 @@ Asciifarm is a multiplayer RPG/farming game that is played in the terminal. The intended use is to play this servers with a shared login (through ssh) but it can be layed in other contexts too. Players can fight enemies and plant crops to gather resources. + + +## Installation/Running + +Installation has been tested and confirmed to work on Linux and OpenBSD. +If anyone is able to run this on other operating systems, please tell me about the results. + +### linux + +Linux users can grab the binary from the releases page. + +Apart from the binary, the `content/` directory in this repository is needed too. +This content directory should either be in the current working directory, or its location should be given with the `--content-dir` command line argument or the `ASCIIFARM_CONTENT_DIR` environment variable. + +The released binaries may not always be up to date, so the make sure you have the latest version it can be better to follow the instructions for others instead. + +### others + +Install Rust and Cargo: https://www.rust-lang.org/tools/install + +Run the command `cargo run` to compile and run asciifarm with all the default options. + +Run the command `cargo build --release` to compile asciifarm and to create a binary which can then be run without cargo (the binary still needs the `content/` directory. +The binary will appear in the `target/release` directory, with the name `asciifarm`. + + +## Command line arguments + +To see all command line arguments, pass the argument `--help`: + + $ ./asciifarm --help + Rustifarm 0.2.0 + Asciifarm server in Rust + + USAGE: + asciifarm [OPTIONS] --admins + + FLAGS: + -h, --help Prints help information + -V, --version Prints version information + + OPTIONS: + -a, --address
... A server type and address. Allowed server types: 'inet', 'unix', 'abstract'. + Example: "inet:127.0.0.1:1234" or "abstract:rustifarm" + --admins The name(s) of the server admin(s) [env: USER=troido] + -c, --content-dir The directory in which the content specifying the world is (maps/encyclopaedia) + [env: ASCIIFARM_CONTENT_DIR=] + -s, --save-dir The directory in which the savegames are [env: ASCIIFARM_SAVE_DIR=] + -u, --user-dir The directory in which the user sign-in data lives [env: ASCIIFARM_USER_DIR=] + -- cgit