Add licence.txt and README.txt to light mod. Add comments

README.txt

@@ -1,4 +1,4 @@
-minipeli 0.2.3 by paramat.
+minipeli 0.2.4 by paramat.
 A game for Minetest Engine 5.1.0 and later.
 See each mod for mod-specific credits and licenses.
 

mods/gui/init.lua

@@ -1,4 +1,4 @@
--- Formspec prepend
+-- Set formspec prepend and hotbar textures
 
 minetest.register_on_joinplayer(function(player)
 	local formspec = [[
@@ -12,9 +12,11 @@ minetest.register_on_joinplayer(function(player)
 	else
 		formspec = formspec .. "background[5,5;1,1;gui_formbg.png;true]"
 	end
+	-- Set the string to be added to every mainmenu formspec, used for theming
 	player:set_formspec_prepend(formspec)
 
-	-- Set hotbar textures
+	-- Set hotbar textures.
+	-- To use, uncomment these 2 lines and add textures to the textures folder.
 	--player:hud_set_hotbar_image("gui_hotbar.png")
 	--player:hud_set_hotbar_selected_image("gui_hotbar_selected.png")
 end)

mods/hand/init.lua

@@ -1,4 +1,4 @@
--- The hand tool
+-- Register the hand tool
 
 minetest.register_item(":", {
 	type = "none",

mods/light/README.txt

@@ -0,0 +1,5 @@
+Minipeli mod: light
+===================
+See license.txt for license information.
+Source code by paramat (MIT).
+Textures by paramat (CC BY-SA 3.0).

mods/light/init.lua

@@ -1,4 +1,4 @@
--- Light
+-- Register light
 
 minetest.register_node("light:light", {
 	description = "Light",

mods/light/license.txt

@@ -0,0 +1,61 @@
+License of source code
+----------------------
+
+The MIT License (MIT)
+Copyright (C) 2019 paramat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this
+software and associated documentation files (the "Software"), to deal in the Software
+without restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+For more details:
+https://opensource.org/licenses/MIT
+
+
+License of media
+----------------
+
+Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
+Copyright (C) 2019 paramat
+
+You are free to:
+
+Share — copy and redistribute the material in any medium or format
+Adapt — remix, transform, and build upon the material for any purpose, even commercially.
+
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+
+Under the following terms:
+
+Attribution — You must give appropriate credit, provide a link to the license, and
+indicate if changes were made. You may do so in any reasonable manner, but not in any way
+that suggests the licensor endorses you or your use.
+
+ShareAlike — If you remix, transform, or build upon the material, you must distribute
+your contributions under the same license as the original.
+
+No additional restrictions — You may not apply legal terms or technological measures that
+legally restrict others from doing anything the license permits.
+
+Notices:
+
+You do not have to comply with the license for elements of the material in the public
+domain or where your use is permitted by an applicable exception or limitation.
+No warranties are given. The license may not give you all of the permissions necessary
+for your intended use. For example, other rights such as publicity, privacy, or moral
+rights may limit how you use the material.
+
+For more details:
+http://creativecommons.org/licenses/by-sa/3.0/

mods/mapgen/init.lua

@@ -26,7 +26,7 @@ local water_sounds = {
 }
 
 
--- Terrain nodes
+-- Register terrain nodes
 
 minetest.register_node("mapgen:stone", {
 	description = "Stone",
@@ -57,7 +57,7 @@ minetest.register_node("mapgen:sand", {
 })
 
 
--- Dungeon nodes
+-- Register dungeon nodes
 
 minetest.register_node("mapgen:stone_block", {
 	description = "Stone Block",
@@ -90,7 +90,7 @@ minetest.register_node("mapgen:stone_block_stair", {
 })
 
 
--- Water
+-- Register water nodes
 
 minetest.register_node("mapgen:water_source", {
 	description = "Water Source",
@@ -156,7 +156,7 @@ minetest.register_node("mapgen:water_flowing", {
 })
 
 
--- River water
+-- Register river water nodes
 
 -- This is an alternative water node required by mapgens with sloping rivers.
 -- It has 'liquid_renewable = false' and a short 'liquid_range' to avoid
@@ -230,7 +230,7 @@ minetest.register_node("mapgen:river_water_flowing", {
 })
 
 
--- Magma
+-- Register magma nodes
 
 minetest.register_node("mapgen:magma_source", {
 	description = "Magma Source",
@@ -298,17 +298,26 @@ minetest.register_node("mapgen:magma_flowing", {
 })
 
 
--- Aliases for map generators
+-- Register aliases for map generators.
+-- Tells engine mapgens which nodes to use for 'base terrain': the terrain
+-- generated by an engine mapgen before biome nodes are applied.
 
 minetest.register_alias("mapgen_stone", "mapgen:stone")
 minetest.register_alias("mapgen_water_source", "mapgen:water_source")
 minetest.register_alias("mapgen_river_water_source", "mapgen:river_water_source")
 
 
--- Biomes
+-- Register biomes
 
 -- Grassland biome stack
 
+-- A 'biome stack' is a vertical stack of biomes all having the same heat and
+-- humidity points, and therefore all having the same horizontal distribution.
+-- In minipeli only one biome stack is registered, more will probably be
+-- desired for a developed game.
+
+-- Dry land from beach top to world top
+
 minetest.register_biome({
 	name = "grassland",
 	node_top = "mapgen:grass",
@@ -326,6 +335,8 @@ minetest.register_biome({
 	humidity_point = 50,
 })
 
+-- The sand of beaches and seabeds
+
 minetest.register_biome({
 	name = "grassland_sea",
 	node_top = "mapgen:sand",
@@ -344,6 +355,8 @@ minetest.register_biome({
 	humidity_point = 50,
 })
 
+-- Shallow underground
+
 minetest.register_biome({
 	name = "grassland_under",
 	node_cave_liquid = "mapgen:water_source",
@@ -355,6 +368,8 @@ minetest.register_biome({
 	humidity_point = 50,
 })
 
+-- Deep underground where magma first appears
+
 minetest.register_biome({
 	name = "grassland_deep",
 	node_cave_liquid = {"mapgen:water_source", "mapgen:magma_source"},