* document, configure and improve the give_initial_stuff

* This mod provides some stuff per player at initial play when first join only
* set initial_stuff = default:wood 2,farming:bread 2,default:furnace 1,default:torch 5
* the initial_stuff is only configured per config files not at menu
* cherry-picked from 18aed0219b

minetest.conf.example

@@ -38,9 +38,11 @@
 #enable_lavacooling = true
 
 # Whether the stuff in initial_stuff should be given to new players.
-#give_initial_stuff = false
-#initial_stuff = default:pick_steel,default:axe_steel,default:shovel_steel,
-default:torch 99,default:cobble 99
+# its depends of the configured at the initital_stuff_mod
+#give_initial_stuff = true
+
+# What initial stuff will be given to player if initial stuff are set to true
+#initial_stuff = default:wood,farming:bread,default:furnace,default:torch
 
 # Whether the TNT mod should be enabled.
 #enable_tnt = <true in singleplayer, false in multiplayer>

mods/give_initial_stuff/README.md

@@ -0,0 +1,26 @@
+Minetest mod: give_initial_stuff
+================================
+
+This mod provides some stuff per player at initial play when first join only
+
+Usage and information
+---------------------
+
+To activate initial stuff per players do per config file:
+
+`give_initial_stuff = true`
+
+To specify the stuff per config file use by example:
+
+`initial_stuff = default:wood 2,farming:bread 2,default:furnace 1,default:torch 5`
+
+
+LICENSE
+-------
+
+See license.txt for license information.
+
+#### Authors of source code
+
+Perttu Ahola (celeron55) <celeron55@gmail.com> (MIT)
+Various Minetest developers and contributors (MIT)

mods/give_initial_stuff/README.txt

@@ -1,8 +1,26 @@
-Minetest Game mod: give_initial_stuff
-=====================================
+Minetest mod: give_initial_stuff
+================================
+
+This mod provides some stuff per player at initial play when first join only
+
+Usage and information
+---------------------
+
+To activate initial stuff per players do per config file:
+
+`give_initial_stuff = true`
+
+To specify the stuff per config file use by example:
+
+`initial_stuff = default:wood 2,farming:bread 2,default:furnace 1,default:torch 5`
+
+
+LICENSE
+-------
+
 See license.txt for license information.
 
-Authors of source code
-----------------------
+#### Authors of source code
+
 Perttu Ahola (celeron55) <celeron55@gmail.com> (MIT)
 Various Minetest developers and contributors (MIT)

mods/give_initial_stuff/init.lua

@@ -1,16 +1,18 @@
 -- gave_initial_stuff/init.lua
 
 local stuff_string = minetest.settings:get("initial_stuff") or
-		"default:pick_steel,default:axe_steel,default:shovel_steel," ..
-		"default:torch 99,default:cobble 99"
+		"default:wood 2,farming:bread 2,default:furnace 1," ..
+		"default:torch 5"
+
+local modname = "give_initial_stuff"
+local modlogn = "["..modname.."]"
 
 give_initial_stuff = {
 	items = {}
 }
 
 function give_initial_stuff.give(player)
-	minetest.log("action",
-			"Giving initial stuff to player " .. player:get_player_name())
+	minetest.log("action",modlogn.." Giving initial stuff to player " .. player:get_player_name())
 	local inv = player:get_inventory()
 	for _, stack in ipairs(give_initial_stuff.items) do
 		inv:add_item("main", stack)
@@ -44,3 +46,4 @@ give_initial_stuff.add_from_csv(stuff_string)
 if minetest.settings:get_bool("give_initial_stuff") then
 	minetest.register_on_newplayer(give_initial_stuff.give)
 end
+

mods/give_initial_stuff/mod.conf

@@ -1,3 +1,3 @@
 name = give_initial_stuff
-description = Minetest Game mod: give_initial_stuff
-depends = default
+description = provide initial stuff at first player join
+depends = default,farming

settingtypes.txt

@@ -21,7 +21,7 @@ enable_lavacooling (Lavacooling) bool true
 
 #    If enabled, steel tools, torches and cobblestone will be given to new
 #    players.
-give_initial_stuff (Give initial items) bool false
+give_initial_stuff (Give initial items) bool true
 
 #    If enabled, players respawn at the bed they last lay on instead of normal
 #    spawn.