aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJoseph Hunkeler <jhunkeler@gmail.com>2024-05-20 01:39:46 -0400
committerJoseph Hunkeler <jhunkeler@gmail.com>2024-05-20 01:39:46 -0400
commitcf7506e368924df66c221eafe03f719a40729afe (patch)
treeaa007d87a0ff5a48c1c8445ccad918784eafaa69 /README.md
downloadardsmm-cf7506e368924df66c221eafe03f719a40729afe.tar.gz
Initial commit
Diffstat (limited to 'README.md')
-rw-r--r--README.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..66bd8fc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# Arma Reforger Dedicated Server Mod Manager (ardsmm)
+
+## Installation
+
+### Using Virtualenv
+
+```
+python -m venv venv
+
+# If on Windows:
+.\venv\Scripts\activate
+
+# If on Linux/Unix:
+source venv/bin/activate
+
+pip install git+https://github.com/jhunkeler/ardsmm
+```
+
+## Using Conda
+
+```
+conda create -n "ardsmm" python
+conda activate ardsmm
+pip install git+https://github.com/jhunkeler/ardsmm
+```
+
+## Usage
+
+```
+usage: ardsmm [-h] [-i] [-o OUTPUT_FILE] [-m MOD_FILE] [-I INDENT] [-V] [configfile]
+
+positional arguments:
+ configfile An Arma Reforger dedicated server JSON config
+
+options:
+ -h, --help show this help message and exit
+ -i, --in-place modify JSON config file in-place
+ -o OUTPUT_FILE, --output-file OUTPUT_FILE
+ write JSON output to file (default: stdout)
+ -m MOD_FILE, --mod-file MOD_FILE
+ read mods from file (default: stdin)
+ -I INDENT, --indent INDENT
+ set JSON indentation level (default: 4)
+ -V, --version display version number and exit
+
+```
+
+## Examples
+
+Create a new configuration file with your `config.json` as the baseline. Mod definitions are appended to `{ "game": { "mods": [] } }`. Mods are appended to `{ "game": { "mods": [] } }`:
+
+```
+ardsmm -o test.json -m examples/mods.txt examples/config.json
+```
+
+Or add mods to an existing configuration file:
+
+```
+ardsmm -i -m examples/mods.txt examples/config.json
+```