README.md

   1 # Tutorial for Minetest
   2
   3 Created by Wuzzy
   4
   5 Version: 2.5.1
   6
   7 Learn how to use and play Minetest in a nice and cozy castle. Here you learn most of the basics of Minetest and how to play.
   8
   9 ## How to install
  10 First, you have to install Minetest.
  11
  12 Then, put this "tutorial" directory into the "games" sub-directory of your Minetest user directory.
  13
  14 Depending on your operating system, you have to put it into the following directory:
  15
  16 * GNU/Linux: $HOME/.minetest/games, where “$HOME” refers to your home directory.
  17 * MacOS: $HOME/.minetest/games, where “$HOME” refers to your home directory.
  18 * Windows: into the "games" sub-directory of the program folder in which you have installed Minetest. It is the directory containing the directories (not necessarily exhaustive list) bin (which in turn contains minetest.exe), builtin, client, doc, fonts, games, locale, mods and textures.
  19
  20
  21 ## How to use
  22 Start Minetest, select “Local Game” (i.e. singleplayer) then select the “Tutorial” icon below.
  23
  24 Create a new world and hit “Play”. The Tutorial should explain the rest.
  25
  26 ## Resetting the tutorial
  27 In case you want to start over, you can just create a new world and play with that one instead.
  28
  29 ## Features
  30 The tutorial covers the following topics:
  31
  32 * Minetest, mods and games
  33 * Camera
  34 * Movement
  35 * Sneaking
  36 * Pointing
  37 * Sneaking
  38 * Mining
  39 * Building
  40 * Liquids
  41 * Items, tools
  42 * Crafting
  43 * Health, breath, damage
  44 * Death and respawning
  45 * A few random hints
  46
  47 This tutorial is written in a fairly generic way and does not focus on any particular game for Minetest. Real games for Minetest will likely have additional or slightly different rules, but the basics will generally be the same.
  48
  49 If you have completed all tasks, you will be awarded a golden cup.
  50 There's also a secret prize, can you win it?
  51
  52
  53 ## Legalities
  54 This tutorial is free software. You can legally study, copy, share, transform, remix, distribute this to your liking, under certain conditions.
  55
  56 The mods “`tutorial`” and “supplemental” as well the tutorial world are original work by Wuzzy and fall under the MIT License.
  57
  58 Other mods are creation by other people, but heavily modified to fit the Tutorial's needs.
  59
  60 The mods “`default`” and “`creative`” falls under the GNU LGPLv2.1 for the code and the CC BY-SA 3.0 for artwork.
  61 The mod “`darkage`” falls under the MIT License.
  62 The mod “`mpd`” falls under the MIT License for the code and the CC BY 3.0 for the music.
  63 The mod “`castle`” falls under the MIT License (the author allowed me an exception).
  64 The mod “`arrow_signs`” falls under the CC BY-SA 3.0.
  65 The mod “`areas`” falls under the GNU LGPLv2.1 (or later).
  66 The mod “`cottages`” falls under the GNU GPLv2 (the author allowed me an exception).
  67 The mod “`supplemental`” falls under the MIT License, with one exception:
  68 The texture `supplemental_loudspeaker.png` falls under the CC BY-SA 3.0 (from the developers of the Mesecons mod).
  69 Everything else falls under the MIT License.
  70
  71 For even more detailed information (including credits), look for README files in the respective mod directories.
  72
  73 ### License references
  74 * MIT License: https://mit-license.org/
  75 * GNU GPLv2: https://www.gnu.org/licenses/gpl-2.0.html
  76 * GNU LGPLv2.1: https://www.gnu.org/licenses/lgpl-2.1.html
  77 * CC BY-SA 3.0: https://creativecommons.org/licenses/by-sa/3.0/
  78 * CC BY 3.0: https://creativecommons.org/licenses/by/3.0/