Merge pull request #1473 from holta/minetest-doc

Minetest README.rst, default_vars.yml, defaults/main.yml, local_vars_big.yml

roles/minetest/README.rst

@@ -2,9 +2,9 @@
 Minetest README
 ===============
 
-Minetest is an open source clone of `Minecraft <https://en.wikipedia.org/wiki/Minecraft>`_, the creative/explorational building blocks game.
+`Minetest <https://www.minetest.net/>`_ is an open source clone of `Minecraft <https://en.wikipedia.org/wiki/Minecraft>`_, the creative/explorational building blocks game.
 
-For the first release, the Minetest server can only be installed on a Raspberry Pi.
+The Minetest multiplayer server can be installed as part of Internet-in-a-Box (IIAB) on Raspberry Pi, Ubuntu 18.04 and possibly also Debian.
 
 Please note that the initial configuration is for creative mode, and a number of mods are installed (see the list in `tasks/main.yml <tasks/main.yml>`_).
 
@@ -22,21 +22,23 @@ No password is required.
 Configurable Parameters
 -----------------------
 
-- minetest_install: set minetest up to install; default is False
+- ``minetest_install:`` set minetest up to install; default is False
-- minetest_enabled: set minetest up to be enabled; default is False
+- ``minetest_enabled:`` set minetest up to be enabled; default is False
-- minetest_port: port on which client should connect; default is 30000
+- ``minetest_port:`` port on which client should connect; default is 30000
-- minetest_server_admin: user with all permissions on minetest server; default is Admin
+- ``minetest_server_admin:`` user with all permissions on minetest server; default is Admin
 
-- minetest_default_game: only carbone-ng and minetest are supported; default is carbone-ng
+- ``minetest_default_game:`` only carbone-ng and minetest are supported; default is `carbone-ng <https://github.com/Calinou/carbone-ng>`_
-- minetest_flat_world: use a flat mapgen engine to lower computation on client; default is False
+- ``minetest_flat_world:`` use a flat mapgen engine to lower computation on client; default is False
 
 File Locations
 --------------
+
 - The config file is: ``/etc/minetest/minetest.conf``
 - The world files are at ``/library/games/minetest/worlds/world``
 
 File Locations on Raspberry Pi
 ------------------------------
+
 - The server binary is ``/library/games/minetest/bin/minetestserver``
 - The working directory is ``//library/games/minetest``
 - mods are in  ``/library/games/minetest/games/<game>/mods``
@@ -49,5 +51,6 @@ File Locations on Other Platforms
 
 To Do
 -----
-- Add more mods - currently only the default mods are there in carbone-ng
+- Add more mods — currently only the default mods are there in carbone-ng
 - Add more games
+- Minetest client software for Windows and Android, included onboard IIAB for offline communities (`#1465 <https://github.com/iiab/iiab/issues/1465>`_)

roles/minetest/defaults/main.yml

@@ -1,16 +1,14 @@
-# These are set in github.com/iiab/iiab/blob/master/vars/default_vars.yml
-# They may be overridden in local_vars
-
 # minetest_install: False
 # minetest_enabled: False
 # minetest_port: 30000
 # minetest_server_admin: Admin
 
-# minetest_default_game: only carbone-ng and minetest are supported
+# minetest_default_game: carbone-ng    # only carbone-ng and minetest are supported
-# minetest_default_game: carbone-ng
 # minetest_flat_world: False
 
-# These should not be touched unless minetest packages change
+# All above are set in: github.com/iiab/iiab/blob/master/vars/default_vars.yml
+# If nec, change them by editing /etc/iiab/local_vars.yml prior to installing!
 
+# These should not be touched unless minetest packages change
 minetest_config_file: /etc/minetest/minetest.conf
 minetest_world_dir: /library/games/minetest/worlds/world

vars/default_vars.yml

@@ -447,11 +447,10 @@ minetest_install: False
 minetest_enabled: False
 minetest_port: 30000
 minetest_server_admin: Admin
-
+minetest_default_game: carbone-ng    # only carbone-ng and minetest are supported
-# minetest_default_game: only carbone-ng and minetest are supported
-minetest_default_game: carbone-ng
 minetest_flat_world: False
 
+
 # CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018:
 # - http://download.iiab.io/content/OSM/vector-tiles/
 # - http://oer2go.org/viewmod/en-worldmap-10

vars/local_vars_big.yml

@@ -296,8 +296,8 @@ calibreweb_url: /books
 calibreweb_home: "{{ content_base }}/calibre-web"    # /library/calibre-web
 
 # Minetest is an open source clone of the Minecraft building blocks game
-minetest_install: False
+minetest_install: True
-minetest_enabled: False
+minetest_enabled: True
 
 
 # CONSIDER THESE 2 NEW OPENSTREETMAP (OSM) APPROACHES INSTEAD, AS OF 2018: