From 9bf42693d4d7a8ab60386e11819f9ba63a0205f7 Mon Sep 17 00:00:00 2001
From: Kyra Zimmer <me@nonchip.de>
Date: Thu, 13 Aug 2020 13:12:11 +0200
Subject: [PATCH] readme

---
 .gitlab-ci.yml |  2 +-
 README.md      | 28 +++++++++++++++++++++++++---
 2 files changed, 26 insertions(+), 4 deletions(-)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index c86eb36..7922880 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -31,7 +31,7 @@ build_push:
   extends: .build
   artifacts:
     name: wbg_build
-    expire_in: 6 mos
+    expire_in: 1 mos
   except:
     - tags
 
diff --git a/README.md b/README.md
index 57e105f..02232eb 100644
--- a/README.md
+++ b/README.md
@@ -13,20 +13,42 @@
 
 ## Building
 
-* clone the repo, `cd` into the folder
-* run `MTG_PATH=/path/to/your/copy/of/minetest_game ./build.sh`
-* symlink the folder into your minetest `games` folder
+* first time:
+  * clone the repo, `cd` into the folder
+  * run `MTG_PATH=/path/to/your/copy/of/minetest_game ./build.sh`
+  * symlink the folder into your minetest `games` folder
+* update:
+  * pull the repo
+  * rerun `build.sh` as before
+
 
 for example, on a recent debian:
 
 ```
+# first time setup
 git clone https://gitlab.com/worstconcept/worstblockgame.git
 cd worstblockgame
 MTG_PATH=/usr/share/games/minetest/games/minetest_game ./build.sh
 mkdir -p ~/.minetest/games
 ln -s $(pwd) ~/.minetest/games
+
+# future updates
+cd worstblockgame
+git pull
+MTG_PATH=/usr/share/games/minetest/games/minetest_game ./build.sh
 ```
 
+## Using a built archive
+
+Instead of building yourself, you can also use a built archive.
+This has the benefit of not requiring any of the build dependencies (e.g. if you're on Windows), but the downside of not being updateable as easily.
+
+* Download an archive from our [Releases](https://gitlab.com/worstconcept/worstblockgame/-/releases) page (which are always available), or, if you want in-dev updates, from our [CI Pipelines](https://gitlab.com/worstconcept/worstblockgame/-/pipelines) (those are only available for one month).
+* Unpack the archive inside your "games" folder like explained in the [minetest documentation](https://wiki.minetest.net/Games#Installing_games).
+
+**due to the build process, the zip file does *not* contain a single game folder, but its contents. make sure you unpack it into a folder *inside* your "games" folder, not directly into it.**
+Essentially you want to end up with this file being `.../minetest/games/wbg/README.md` instead of `.../minetest/games/README.md`.
+
 ## Playing
 
 run minetest, select WorstBlockGame, create a map with the following settings: