README.txt

   1 Mana mod [mana]
   2 ===============
   3 Version: 1.0.2
   4 Note: This mod uses semantic versioning, as defined by version 2.0.0 of the SemVer standard.
   5 See: <http://semver.org/>
   6
   7 Description
   8 ===========
   9 This mod adds basic support for mana to Minetest.
  10
  11 Each player will have an additional attribute: Mana. To be precise:
  12
  13 - Current mana reserves: How much mana the player currently has
  14 - Maximum possible mana: How much mana the player can have at maximum
  15 - Mana regeneration amont: How much mana will be generated each “mana tick” (default 0.2 seconds)
  16
  17 By default, each player spawns with 0/200 mana, and regenerates 1 mana per fifth of a second. All
  18 these values can be configured with the server settings (`minetest.conf`) and it is highly advised to do
  19 so if you plan to integrate this mod into a subgame.
  20
  21 The mana regeneration rate (the “mana tick”) is a global setting and is *not* configured on a
  22 per-player basis.
  23
  24 The mod provides a simple API to set, get, add and subtract the mana (and maximum) mana of any player, and
  25 for setting the regeneration amount. Note that this mod itself does *not* change the gameplay in a meaningful
  26 way. You should install other mods which use the Mana mod as a dependency.
  27
  28 The API documentation is in the file API.md.
  29
  30 If the mod “HUD bars” [hudbars] is installed, a blue bar will be added to the HUD showing the player's mana reserves.
  31 It currently only works with version 0.3.0 of this mod.
  32
  33 Otherwise, the mana is just shown as text.
  34
  35 Configuration
  36 =============
  37
  38 This mod can be configured with minetest.conf! The following settings are accepted:
  39
  40 * `mana_default_max`: Initial max. mana given to new players. Default: `200`. This value must be non-negative.
  41 * `mana_default_regen`: Initial regenerated mana per “mana tick”. Default: `1`. This value must be non-negative.
  42 * `mana_regen_timer`: The length of a “mana tick” in seconds. Each player will get his/her mana increased by the current
  43   regen value per mana tick. Default: `0.2`. This value must be positive, also try to avoid very small values
  44   as those could probably stress your machine a lot.
  45
  46
  47 License information
  48 ===================
  49 * textures/mana_icon.png: CC-BY by Buch <http://opengameart.org/users/Buch>.
  50 * textures/mana_bgicon.png: CC-BY, originally by Buch <http://opengameart.org/users/Buch>, modified by Wuzzy.
  51 * textures/mana_bar.png: WTFPL by Wuzzy.
  52 * Everything else: WTFPL.