mirror of
https://github.com/sys4-fr/server-nalc.git
synced 2024-12-27 19:20:37 +01:00
4ad0939fe6
- See #87
53 lines
2.6 KiB
Plaintext
Executable File
53 lines
2.6 KiB
Plaintext
Executable File
Mana mod [mana]
|
|
===============
|
|
Version: 1.1.0
|
|
Note: This mod uses semantic versioning, as defined by version 2.0.0 of the SemVer standard.
|
|
See: <http://semver.org/>
|
|
|
|
Description
|
|
===========
|
|
This mod adds basic support for mana to Minetest.
|
|
|
|
Each player will have an additional attribute: Mana. To be precise:
|
|
|
|
- Current mana reserves: How much mana the player currently has
|
|
- Maximum possible mana: How much mana the player can have at maximum
|
|
- Mana regeneration amont: How much mana will be generated each “mana tick” (default 0.2 seconds)
|
|
|
|
By default, each player spawns with 0/200 mana, and regenerates 1 mana per fifth of a second. All
|
|
these values can be configured with the server settings (`minetest.conf`) and it is highly advised to do
|
|
so if you plan to integrate this mod into a subgame.
|
|
|
|
The mana regeneration rate (the “mana tick”) is a global setting and is *not* configured on a
|
|
per-player basis.
|
|
|
|
The mod provides a simple API to set, get, add and subtract the mana (and maximum) mana of any player, and
|
|
for setting the regeneration amount. Note that this mod itself does *not* change the gameplay in a meaningful
|
|
way. You should install other mods which use the Mana mod as a dependency.
|
|
|
|
The API documentation is in the file API.md.
|
|
|
|
If the mod “HUD bars” [hudbars] is installed, a blue bar will be added to the HUD showing the player's mana reserves.
|
|
It currently only works with version 0.3.0 of this mod.
|
|
|
|
Otherwise, the mana is just shown as text.
|
|
|
|
Configuration
|
|
=============
|
|
|
|
This mod can be configured with minetest.conf! The following settings are accepted:
|
|
|
|
* `mana_default_max`: Initial max. mana given to new players. Default: `200`. This value must be non-negative.
|
|
* `mana_default_regen`: Initial regenerated mana per “mana tick”. Default: `1`. This value can be a floating value. I.e. if the value is `0.5`, 1 mana is generated every two mana ticks (note that the player's mana amount is still a whole number). This value can be negative, in which case the player will lose mana.
|
|
* `mana_regen_timer`: The length of a “mana tick” in seconds. Each player will get his/her mana increased by the current
|
|
regen value per mana tick. Default: `0.2`. This value must be positive, also try to avoid very small values
|
|
as those could probably stress your machine a lot.
|
|
|
|
|
|
License information
|
|
===================
|
|
* textures/mana_icon.png: CC-BY by Buch <http://opengameart.org/users/Buch>.
|
|
* textures/mana_bgicon.png: CC-BY, originally by Buch <http://opengameart.org/users/Buch>, modified by Wuzzy.
|
|
* textures/mana_bar.png: WTFPL by Wuzzy.
|
|
* Everything else: WTFPL.
|