Organize mods into modpacks for better overview

mods/HUD/craftingpack/README.txt

@@ -0,0 +1,31 @@
+Minetest mod "Crafting"
+=======================
+version: 2.0.1
+
+License of source code and Textures: WTFPL
+------------------------------------
+Copyright (c) 2013-2014 BlockMen
+
+This program is free software. It comes without any warranty, to
+the extent permitted by applicable law. You can redistribute it
+and/or modify it under the terms of the Do What The Fuck You Want
+To Public License, Version 2, as published by Sam Hocevar. See
+http://sam.zoy.org/wtfpl/COPYING for more details.
+
+
+--USING the mod--
+=================
+This mod changes the players inventory (survival and creative) with more slots (9*4 instead of 8*4)
+Like known from Minecraft you have a 2x2 crafting grid at inventory now. Furthermore a categorized creative
+inventory and a support for stu's 3d armor mod (To use the armor and a preview of player).
+
+Left items in the crafting slots are dropped infront of you.
+
+Workbench
+=========
+With following recipe you craft a workbench (aka crafting table):
+
+wood wood
+wood wood
+
+The workbench has a 3x3 crafting grid, that allows to use all recipes.

mods/HUD/craftingpack/crafting/README.txt

@@ -0,0 +1,34 @@
+Minetest mod "Crafting"
+=======================
+Version: 2.0.1
+
+License of source code and Textures: WTFPL
+------------------------------------
+copyright (c) 2013-2014 by BlockMen
+
+This program is free software. It comes without any warranty, to
+the extent permitted by applicable law. You can redistribute it
+and/or modify it under the terms of the Do What The Fuck You Want
+To Public License, Version 2, as published by Sam Hocevar. See
+http://sam.zoy.org/wtfpl/COPYING for more details.
+
+
+--USING the mod--
+=================
+
+This mod changes the players inventory (survival and creative) with more slots (9*4 instead of 8*4)
+Like known from Minecraft you have a 2x2 crafting grid at inventory now. Furthermore a categorized creative
+inventory and a support for stu's 3d armor mod (To use the armor and a preview of player).
+
+Left items in the crafting slots are dropped infront of you.
+
+
+Workbench
+_________
+
+With following recipe you craft a workbench (aka crafting table):
+
+wood wood
+wood wood
+
+The workbench has a 3x3 crafting grid, that allows to use all recipes.

mods/HUD/craftingpack/crafting/creative.lua

@@ -0,0 +1,419 @@
+crafting = {}
+crafting.creative_inventory_size = 0
+
+-- Prepare player info table
+local players = {}
+
+local function set_inv(filter, player)
+	local playername = player:get_player_name()
+	local inv = minetest.get_inventory({type="detached", name="creative_"..playername})
+	inv:set_size("main", 0)
+	local creative_list = {}
+	for name,def in pairs(minetest.registered_items) do
+		if (not def.groups.not_in_creative_inventory or def.groups.not_in_creative_inventory == 0) and def.description and def.description ~= "" then
+			if filter ~= "" then
+				local is_redstone = function(def)
+					return def.mesecons or def.groups.mesecon or def.groups.mesecon_conductor_craftable or def.groups.mesecon_effecor_off
+				end
+				local is_tool = function(def)
+					return def.groups.tool or (def.tool_capabilities ~= nil and def.tool_capabilities.damage_groups == nil)
+				end
+				local is_weapon = function(def)
+					return def.groups.weapon or def.groups.weapon_ranged or def.groups.ammo or def.groups.armor_head or def.groups.armor_torso or def.groups.armor_legs or def.groups.armor_feet
+				end
+				if filter == "\0blocks" then
+					if def.groups.building_block then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0deco" then
+					if def.groups.deco_block then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0redstone" then
+					if is_redstone(def) then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0rail" then
+					if def.groups.transport then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0food" then
+					if def.groups.food or def.groups.eatable then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0tools" then
+					if is_tool(def) then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0combat" then
+					if is_weapon(def) then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0brew" then
+					if def.groups.brewitem then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0matr" then
+					if def.groups.craftitem then
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0misc" then
+					if not def.groups.building_block and not def.groups.deco_block and not is_redstone(def) and not def.groups.transport and not def.groups.food and not def.groups.eatable and not is_tool(def) and not is_weapon(def) and not def.groups.craftitem and not def.groups.brewitem then
+
+						table.insert(creative_list, name)
+					end
+				elseif filter == "\0all" then
+					table.insert(creative_list, name)
+				else --for all other
+					if string.find(string.lower(def.name), filter) or string.find(string.lower(def.description), filter) then
+						table.insert(creative_list, name)
+					end
+				end
+			end
+		end
+	end
+	table.sort(creative_list)
+	inv:set_size("main", #creative_list)
+	for _,itemstring in ipairs(creative_list) do
+		inv:add_item("main", ItemStack(itemstring))
+	end
+	crafting.creative_inventory_size = #creative_list
+end
+
+local function init(player)
+	local playername = player:get_player_name()
+	local inv = minetest.create_detached_inventory("creative_"..playername, {
+		allow_move = function(inv, from_list, from_index, to_list, to_index, count, player)
+			if minetest.setting_getbool("creative_mode") then
+				return count
+			else
+				return 0
+			end
+		end,
+		allow_put = function(inv, listname, index, stack, player)
+			return 0
+		end,
+		allow_take = function(inv, listname, index, stack, player)
+			if minetest.setting_getbool("creative_mode") then
+				return -1
+			else
+				return 0
+			end
+		end,
+		on_move = function(inv, from_list, from_index, to_list, to_index, count, player)
+		end,
+		on_put = function(inv, listname, index, stack, player)
+		end,
+		on_take = function(inv, listname, index, stack, player)
+			print(player:get_player_name().." takes item from creative inventory; listname="..dump(listname)..", index="..dump(index)..", stack="..dump(stack))
+			if stack then
+				print("stack:get_name()="..dump(stack:get_name())..", stack:get_count()="..dump(stack:get_count()))
+			end
+		end,
+	}, playername)
+	set_inv("\0all", player)
+end
+
+-- Create the trash field
+local trash = minetest.create_detached_inventory("trash", {
+	allow_put = function(inv, listname, index, stack, player)
+		if minetest.setting_getbool("creative_mode") then
+			return stack:get_count()
+		else
+			return 0
+		end
+	end,
+	on_put = function(inv, listname, index, stack, player)
+		inv:set_stack(listname, index, "")
+	end,
+})
+trash:set_size("main", 1)
+
+local noffset = {} -- numeric tab offset
+local offset = {} -- string offset:
+local boffset = {} -- 
+local hoch = {}
+local bg = {}
+
+noffset["blocks"] = {-0.29,-0.25}
+noffset["deco"] = {0.98,-0.25}
+noffset["redstone"] = {2.23,-0.25}
+noffset["rail"] = {3.495,-0.25}
+noffset["misc"] = {4.75,-0.25}
+noffset["nix"] = {8.99,-0.25}
+noffset["food"] = {-0.29,8.12}
+noffset["tools"] = {0.98,8.12}
+noffset["combat"] = {2.23,8.12}
+noffset["brew"] = {3.495,8.12}
+noffset["matr"] = {4.74,8.12}
+noffset["inv"] = {8.99,8.12}
+
+for k,v in pairs(noffset) do
+	offset[k] = tostring(v[1]) .. "," .. tostring(v[2])
+	boffset[k] = tostring(v[1]+0.19) .. "," .. tostring(v[2]+0.25)
+end
+
+hoch["blocks"] = ""
+hoch["deco"] = ""
+hoch["redstone"] = ""
+hoch["rail"] = ""
+hoch["misc"] = ""
+hoch["nix"] = ""
+hoch["default"] = ""
+hoch["food"] = "^[transformfy"
+hoch["tools"] = "^[transformfy"
+hoch["combat"] = "^[transformfy"
+hoch["brew"] = "^[transformfy"
+hoch["matr"] = "^[transformfy"
+hoch["inv"] = "^[transformfy"
+
+local dark_bg = "crafting_creative_bg_dark.png"
+
+local function reset_menu_item_bg()
+	bg["blocks"] = dark_bg 
+	bg["deco"] = dark_bg 
+	bg["redstone"] = dark_bg 
+	bg["rail"] = dark_bg 
+	bg["misc"] = dark_bg 
+	bg["nix"] = dark_bg 
+	bg["food"] = dark_bg 
+	bg["tools"] = dark_bg 
+	bg["combat"] = dark_bg 
+	bg["brew"] = dark_bg 
+	bg["matr"] = dark_bg 
+	bg["inv"] = dark_bg 
+	bg["default"] = dark_bg
+end
+
+
+crafting.set_creative_formspec = function(player, start_i, pagenum, show, page, filter)
+	reset_menu_item_bg()
+	pagenum = math.floor(pagenum) or 1
+	local pagemax = math.floor((crafting.creative_inventory_size-1) / (9*5) + 1)
+	local slider_height
+	if pagemax == 1 then
+		slider_height = 4.525
+	else
+		slider_height = 4/pagemax
+	end
+	local slider_pos = slider_height*(pagenum-1)+2.20
+	local name = "nix"
+	local formspec = ""
+	local main_list
+	local playername = player:get_player_name()
+	local listrings = "listring[detached:creative_"..playername..";main]"..
+		"listring[current_player;main]"..
+		"listring[detached:trash;main]"
+
+	if page ~= nil then name = page end
+	bg[name] = "crafting_creative_bg.png"
+		local inv_bg = "crafting_inventory_creative.png"
+		if name == "inv" then
+			-- Survival inventory slots
+			main_list = "image[-0.2,1.7;11.35,2.33;crafting_creative_bg.png]"..
+				"list[current_player;main;0,3.75;9,3;9]"
+		else
+			inv_bg = inv_bg .. "^crafting_inventory_creative_scroll.png"
+			-- Creative inventory slots
+			main_list = "list[detached:creative_"..playername..";main;0,1.75;9,5;"..tostring(start_i).."]" ..
+			-- ... and scroll bar
+				"image_button[9.03,1.74;0.85,0.6;crafting_creative_up.png;creative_prev;]"..
+				"image[9.04," .. tostring(slider_pos) .. ";0.75,"..tostring(slider_height) .. ";crafting_slider.png]"..
+				"image_button[9.03,6.15;0.85,0.6;crafting_creative_down.png;creative_next;]"
+		end
+		local function tab(current, check)
+			local img
+			if current == check then
+				img = "crafting_creative_active.png"
+			else
+				img = "crafting_creative_inactive.png"
+			end
+			return "image[" .. offset[check] .. ";1.5,1.44;" .. img .. hoch[check].. "]" ..
+				"image[" .. boffset[check] .. ";1,1;crafting_creative_marker.png]"
+		end
+		formspec = "size[10,9.3]"..
+			mcl_core.inventory_header..
+			"background[-0.19,-0.25;10.5,9.87;"..inv_bg.."]"..
+			"label[-5,-5;"..name.."]"..
+			"item_image_button[-0.1,0;1,1;mcl_core:brick_block;blocks;]"..	--build blocks
+			tab(name, "blocks") ..
+			"tooltip[blocks;Building Blocks]"..
+			"item_image_button[1.15,0;1,1;mcl_flowers:peony;deco;]"..	--decoration blocks
+			tab(name, "deco") ..
+			"tooltip[deco;Decoration Blocks]"..
+			"item_image_button[2.415,0;1,1;mesecons:redstone;redstone;]"..	--redstone
+			tab(name, "redstone") ..
+			"tooltip[redstone;Redstone]"..
+			"item_image_button[3.693,0;1,1;mcl_minecarts:golden_rail;rail;]"..	--transportation
+			tab(name, "rail") ..
+			"tooltip[rail;Transportation]"..
+			"item_image_button[4.93,0;1,1;bucket:bucket_lava;misc;]"..	--miscellaneous
+			tab(name, "misc") ..
+			"tooltip[misc;Miscellaneous]"..
+			"item_image_button[9.19,0;1,1;mcl_compass:compass;nix;]"..	--search
+			tab(name, "nix") ..
+			"tooltip[nix;Search Items]"..
+			"image[0,1;5,0.75;fnt_"..name..".png]"..
+			"list[current_player;main;0,7;9,1;]"..
+			main_list..
+			"item_image_button[-0.1,8.37;1,1;mcl_core:apple;food;]"..	--foodstuff
+			tab(name, "food") ..
+			"tooltip[food;Foodstuffs]"..
+			"item_image_button[1.15,8.37;1,1;mcl_core:axe_iron;tools;]"..	--tools
+			tab(name, "tools") ..
+			"tooltip[tools;Tools]"..
+			"item_image_button[2.415,8.37;1,1;mcl_core:sword_gold;combat;]"..	--combat
+			tab(name, "combat") ..
+			"tooltip[combat;Combat]"..
+			"item_image_button[3.693,8.37;1,1;mcl_potions:glass_bottle;brew;]"..	--brewing
+			tab(name, "brew") ..
+			"tooltip[brew;Brewing]"..
+			"item_image_button[4.938,8.37;1,1;mcl_core:stick;matr;]"..	--materials
+			tab(name, "matr") ..
+			"tooltip[matr;Materials]"..
+			"item_image_button[9.19,8.37;1,1;mcl_chests:chest;inv;]"..			--inventory
+			tab(name, "inv") ..
+			"tooltip[inv;Survival Inventory]"..
+			"list[detached:trash;main;9,7;1,1;]"..
+			"image[9,7;1,1;crafting_creative_trash.png]"..
+			listrings
+
+			if name == "nix" then
+				if filter == nil then
+					filter = ""
+				end
+				formspec = formspec .. "field[5.3,1.3;4,0.75;suche;;"..minetest.formspec_escape(filter).."]"
+				formspec = formspec .. "field_close_on_enter[suche;false]"
+			end
+			if pagenum ~= nil then formspec = formspec .. "p"..tostring(pagenum) end
+
+			-- inventory marker
+			formspec = formspec .. "cin"
+			
+	player:set_inventory_formspec(formspec)
+end
+
+minetest.register_on_player_receive_fields(function(player, formname, fields)
+	local page = nil
+	if not minetest.setting_getbool("creative_mode") then
+		return
+	end
+
+	local name = player:get_player_name()
+
+	if fields.blocks then
+		set_inv("\0blocks",player)
+		page = "blocks"		
+	elseif fields.deco then
+		set_inv("\0deco",player)
+		page = "deco"
+	elseif fields.redstone then
+		set_inv("\0redstone",player)
+		page = "redstone"
+	elseif fields.rail then
+		set_inv("\0rail",player)
+		page = "rail"
+	elseif fields.misc then
+		set_inv("\0misc",player)
+		page = "misc"
+	elseif fields.nix then
+		set_inv("\0all",player)
+		page = "nix"
+	elseif fields.food then
+		set_inv("\0food",player)
+		page = "food"
+	elseif fields.tools then
+		set_inv("\0tools",player)
+		page = "tools"
+	elseif fields.combat then
+		set_inv("\0combat",player)
+		page = "combat"
+	elseif fields.brew then
+		set_inv("\0brew",player)
+		page = "brew"
+	elseif fields.matr then
+		set_inv("\0matr",player)
+		page = "matr"
+	elseif fields.inv then
+		page = "inv"
+	elseif fields.suche == "" and not fields.creative_next and not fields.creative_prev then
+		set_inv("\0all", player)
+		page = "nix"
+	elseif fields.suche ~= nil and not fields.creative_next and not fields.creative_prev then
+		set_inv(string.lower(fields.suche),player)
+		page = "nix"
+	end
+
+	if page then
+		players[name].page = page
+	end
+	if players[name].page then
+		page = players[name].page
+	end
+
+	-- Figure out current page from formspec
+	local formspec = player:get_inventory_formspec()
+
+	local size = string.len(formspec)
+	local start_i = players[name].start_i
+	if fields.creative_prev then
+		start_i = start_i - 9*5
+	end
+	if fields.creative_next then
+		start_i = start_i + 9*5
+	end
+	if start_i < 0 then
+		start_i = start_i + 9*5
+	end
+	if start_i >= crafting.creative_inventory_size then
+		start_i = start_i - 9*5
+	end		
+	if start_i < 0 or start_i >= crafting.creative_inventory_size then
+		start_i = 0
+	end
+	players[name].start_i = start_i
+
+	local filter
+	if fields.suche ~= nil and fields.suche ~= "" then
+		filter = fields.suche
+		players[name].filter = filter
+	end
+
+	crafting.set_creative_formspec(player, start_i, start_i / (9*5) + 1, false, page, filter)
+end)
+
+
+if minetest.setting_getbool("creative_mode") then
+	minetest.register_on_placenode(function(pos, newnode, placer, oldnode, itemstack)
+		-- Place infinite nodes, except for shulker boxes
+		local group = minetest.get_item_group(itemstack:get_name(), "shulker_box")
+		return group == 0 or group == nil
+	end)
+	
+	function minetest.handle_node_drops(pos, drops, digger)
+		if not digger or not digger:is_player() then
+			return
+		end
+		local inv = digger:get_inventory()
+		if inv then
+			for _,item in ipairs(drops) do
+				item = ItemStack(item):get_name()
+				if not inv:contains_item("main", item) then
+					inv:add_item("main", item)
+				end
+			end
+		end
+	end
+	
+end
+
+minetest.register_on_joinplayer(function(player)
+	local name = player:get_player_name()
+	if not players[name] then
+		players[name] = {}
+		players[name].page = "nix"
+		players[name].filter = ""
+		players[name].start_i = 0
+	end
+	init(player)
+end)

mods/HUD/craftingpack/crafting/depends.txt

@@ -0,0 +1,2 @@
+mcl_core
+mcl_sounds

mods/HUD/craftingpack/crafting/init.lua

@@ -0,0 +1,198 @@
+local show_armor = false
+if minetest.get_modpath("3d_armor") ~= nil then show_armor = true end
+
+local function item_drop(itemstack, dropper, pos)
+	if dropper:is_player() then
+		local v = dropper:get_look_dir()
+		local p = {x=pos.x, y=pos.y+1.2, z=pos.z}
+		p.x = p.x+(math.random(1,3)*0.2)
+		p.z = p.z+(math.random(1,3)*0.2)
+		local obj = minetest.add_item(p, itemstack)
+		if obj then
+			v.x = v.x*4
+			v.y = v.y*4 + 2
+			v.z = v.z*4
+			obj:setvelocity(v)
+		end
+	else
+		minetest.add_item(pos, itemstack)
+	end
+	return itemstack
+end
+
+local function drop_fields(player, name)
+	local inv = player:get_inventory()
+	for i,stack in ipairs(inv:get_list(name)) do
+		item_drop(stack, player, player:getpos())
+		stack:clear()
+		inv:set_stack(name, i, stack)
+	end
+end
+
+local player_armor = {}
+
+local function update_armor(player)
+	local out = ""
+	if not player then return end
+	local name = player:get_player_name()
+	if not armor or not armor.textures then return end
+	local armor_str = armor.textures[name].armor
+	if string.find(armor_str, "leggings") then
+		out = out .. "^crafting_armor_legs.png"
+	end
+	if string.find(armor_str, "boots") then
+		out = out .. "^crafting_armor_boots.png"
+	end
+	if string.find(armor_str, "helmet") then
+		out = out .. "^crafting_armor_helmet.png"
+	end
+	if string.find(armor_str, "chestplate") then
+		out = out .. "^crafting_armor_chest.png"
+	end
+	player_armor[name] = out
+end
+
+local function set_inventory(player)
+	if minetest.setting_getbool("creative_mode") then
+		crafting.set_creative_formspec(player, 0, 1)
+		return
+	end
+	player:get_inventory():set_width("craft", 2)
+	player:get_inventory():set_size("craft", 4)
+
+	local player_name = player:get_player_name()
+	local img = "crafting_inventory_player.png"
+	local armor_img = ""
+	if show_armor then
+		armor_img = "^crafting_inventory_armor.png"
+		if player_armor[player_name] ~= nil then
+			img = img .. player_armor[player_name]
+		end
+	end
+	local img_element = "image[1,0;3,4;"..img.."]"
+	if show_armor and armor.textures[player_name] and armor.textures[player_name].preview then
+		img = armor.textures[player_name].preview
+		local s1 = img:find("character_preview")
+		if s1 ~= nil then
+			s1 = img:sub(s1+21)
+			img = "crafting_player2d.png"..s1
+		end
+		img_element = "image[1.5,0;2,4;"..img.."]"
+	end
+
+	local form = "size[9,8.75]"..
+	"background[-0.19,-0.25;9.41,9.49;crafting_formspec_bg.png^crafting_inventory.png"..armor_img.."]"..
+	mcl_core.inventory_header..
+	img_element..
+	--armor
+	"list[detached:"..player_name.."_armor;armor;0,0;1,1;1]"..
+	"list[detached:"..player_name.."_armor;armor;0,1;1,1;2]"..
+	"list[detached:"..player_name.."_armor;armor;0,2;1,1;3]"..
+	"list[detached:"..player_name.."_armor;armor;0,3;1,1;4]"..
+	-- craft and inventory
+	"list[current_player;main;0,4.5;9,3;9]"..
+	"list[current_player;main;0,7.74;9,1;]"..
+	"list[current_player;craft;4,1;2,2]"..
+	"list[current_player;craftpreview;7,1.5;1,1;]"..
+	-- crafting guide button
+	"image_button[8,0;1,1;craftguide_book.png;__mcl_craftguide;]"..
+	"tooltip[__mcl_craftguide;Show crafting recipes]"..
+	-- for shortcuts
+	"listring[current_player;main]"..
+	"listring[current_player;craft]"..
+	"listring[current_player;main]"..
+	"listring[detached:"..player_name.."_armor;armor]"..
+	-- inventory marker
+	"inv"
+	
+	player:set_inventory_formspec(form)
+end
+
+local function set_workbench(player)
+	player:get_inventory():set_width("craft", 3)
+	player:get_inventory():set_size("craft", 9)
+
+	local form = "size[9,8.75]"..
+	"background[-0.19,-0.25;9.41,9.49;crafting_formspec_bg.png^crafting_inventory_workbench.png]"..
+	mcl_core.inventory_header..
+	"list[current_player;main;0,4.5;9,3;9]"..
+	"list[current_player;main;0,7.74;9,1;]"..
+	"list[current_player;craft;1.75,0.5;3,3;]"..
+	"list[current_player;craftpreview;5.75,1.5;1,1;]"..
+	"image_button[8,0;1,1;craftguide_book.png;__mcl_craftguide;]"..
+	"tooltip[__mcl_craftguide;Show crafting recipes]"..
+	"listring[current_player;main]"..
+	"listring[current_player;craft]"..
+	-- inventory marker
+	"wob"
+
+	--player:set_inventory_formspec(form)
+	minetest.show_formspec(player:get_player_name(), "main", form)
+end
+
+--drop craf items and reset inventory on closing
+minetest.register_on_player_receive_fields(function(player, formname, fields)
+	if fields.quit then
+		local formspec = player:get_inventory_formspec()
+		local size = string.len(formspec)
+		local marker = string.sub(formspec,size-2)
+		if marker == "inv" or marker == "wob" or marker == "cin" then
+			drop_fields(player,"craft")			
+			set_inventory(player)
+		end
+	end
+end)
+
+minetest.register_on_joinplayer(function(player)
+	--init inventory
+	set_inventory(player)
+	player:get_inventory():set_width("main", 9)
+	player:get_inventory():set_size("main", 36)
+
+	--set hotbar size
+	player:hud_set_hotbar_itemcount(9)
+	--add hotbar images
+	player:hud_set_hotbar_image("crafting_hotbar.png")
+ 	player:hud_set_hotbar_selected_image("crafting_hotbar_selected.png")
+
+	if show_armor then
+		local armor_orginal = armor.set_player_armor
+		armor.set_player_armor = function(self, player)
+			armor_orginal(self, player)
+			update_armor(player)
+			set_inventory(player)
+		end
+	end
+end)
+
+minetest.register_node("crafting:workbench", {
+	description = "Crafting Table",
+	tiles = {"crafting_workbench_top.png", "default_wood.png", "crafting_workbench_side.png",
+		"crafting_workbench_side.png", "crafting_workbench_front.png", "crafting_workbench_front.png"},
+	paramtype2 = "facedir",
+	paramtype = "light",
+	groups = {choppy=2,oddly_breakable_by_hand=2,deco_block=1},
+	on_rightclick = function(pos, node, clicker, itemstack)
+		set_workbench(clicker)
+	end,
+	sounds = mcl_sounds.node_sound_wood_defaults(),
+})
+
+minetest.register_craft({
+	output = "crafting:workbench",
+	recipe = {
+		{"group:wood", "group:wood"},
+		{"group:wood", "group:wood"}
+	}
+})
+
+minetest.register_craft({
+	type = "fuel",
+	recipe = "crafting:workbench",
+	burntime = 15,
+})
+
+if minetest.setting_getbool("creative_mode") then
+	dofile(minetest.get_modpath("crafting").."/creative.lua")
+end
+

mods/HUD/craftingpack/inventory_plus/init.lua

@@ -0,0 +1,7 @@
+inventory_plus = {}
+
+function inventory_plus.set_inventory_formspec(player, formspec)
+end
+
+function inventory_plus.register_button(player,str1, str2)
+end

mods/HUD/hbarmor/README.md

@@ -0,0 +1,43 @@
+# HUD bar for `3d_armor` [`hbarmor`]
+
+* Version: 0.2.0
+
+## Description
+This mod adds a simple HUD bar which displays the current damage
+of the player's armor (from the 3D Armor [`3d_armor`] mod) as a percentage (rounded).
+
+100% armor means the armor is in perfect shape. 0% means the armor is almost destroyed
+or non-existant. Note that to reach 100%, the player must wear at least 4 different
+pieces of armor in perfect shape.
+
+The armor bar also does not tell anything about the armor's strength,
+only how worn out it already is.
+
+By default, the armor bar is hidden if the player wears no armor.
+
+## Dependencies
+* HUD bars [`hudbars`], major version 1
+* 3D Armor [`3d_armor`] (tested with Minetest 0.4.14)
+
+## Licensing
+This mod is entirly free softare.
+
+### Source code
+
+* License: WTFPL (see below)
+* Authors: Wuzzy, forked from the mod “Better HUD (and hunger)” [`hud`] by BlockMen (2013-2014)
+
+### Textures
+
+* `hbarmor_icon.png`—Stu ([CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/)), modified by BlockMen
+* `hbarmor_bgicon.png`—Stu (CC BY-SA 3.0), modified by BlockMen
+* `hbarmor_bar.png`—Wuzzy (WTFPL)
+
+Everything else is WTFPL:
+© Copyright BlockMen (2013-2014)
+
+This program is free software. It comes without any warranty, to
+the extent permitted by applicable law. You can redistribute it
+and/or modify it under the terms of the Do What The Fuck You Want
+To Public License, Version 2, as published by Sam Hocevar. See
+http://sam.zoy.org/wtfpl/COPYING for more details.

mods/HUD/hbarmor/depends.txt

@@ -0,0 +1,3 @@
+hudbars
+3d_armor
+intllib?

mods/HUD/hbarmor/description.txt

@@ -0,0 +1 @@
+Adds a HUD bar displaying the current damage of the player's armor.

mods/HUD/hbarmor/init.lua

@@ -0,0 +1,154 @@
+local S
+if (minetest.get_modpath("intllib")) then
+	S = intllib.Getter()
+else
+	S = function ( s ) return s end
+end
+
+if (not armor) or (not armor.def) then
+	minetest.log("error", "[hbarmor] Outdated 3d_armor version. Please update your version of 3d_armor!")
+end
+
+local hbarmor = {}
+
+-- HUD statbar values
+hbarmor.armor = {}
+
+-- Stores if player's HUD bar has been initialized so far.
+hbarmor.player_active = {}
+
+-- Time difference in seconds between updates to the HUD armor bar.
+-- Increase this number for slow servers.
+hbarmor.tick = 0.1
+
+-- If true, the armor bar is hidden when the player does not wear any armor
+hbarmor.autohide = true
+
+--load custom settings
+local set = minetest.setting_getbool("hbarmor_autohide")
+if set ~= nil then
+	hbarmor.autohide = set
+end
+
+set = minetest.setting_get("hbarmor_tick")
+if tonumber(set) ~= nil then
+	hbarmor.tick = tonumber(set)
+end
+
+
+local must_hide = function(playername, arm)
+	return ((not armor.def[playername].count or armor.def[playername].count == 0) and arm == 0)
+end
+
+local arm_printable = function(arm)
+	return math.ceil(math.floor(arm+0.5))
+end
+
+local function custom_hud(player)
+	local name = player:get_player_name()
+
+	if minetest.setting_getbool("enable_damage") then
+		local ret = hbarmor.get_armor(player)
+		if ret == false then
+			minetest.log("error", "[hbarmor] Call to hbarmor.get_armor in custom_hud returned with false!")
+		end
+		local arm = tonumber(hbarmor.armor[name])
+		if not arm then arm = 0 end
+		local hide
+		if hbarmor.autohide then
+			hide = must_hide(name, arm)
+		else
+			hide = false
+		end
+		hb.init_hudbar(player, "armor", arm_printable(arm), nil, hide)
+	end
+end
+
+--register and define armor HUD bar
+hb.register_hudbar("armor", 0xFFFFFF, S("Armor"), { icon = "hbarmor_icon.png", bgicon = "hbarmor_bgicon.png", bar = "hbarmor_bar.png" }, 0, 100, hbarmor.autohide, S("%s: %d%%"))
+
+function hbarmor.get_armor(player)
+	if not player or not armor.def then
+		return false
+	end
+	local name = player:get_player_name()
+	local def = armor.def[name] or nil
+	if def and def.state and def.count then
+		hbarmor.set_armor(name, def.state, def.count)
+	else
+		return false
+	end
+	return true
+end
+
+function hbarmor.set_armor(player_name, ges_state, items)
+	local max_items = 4
+	if items == 5 then
+		max_items = items
+	end
+	local max = max_items * 65535
+	local lvl = max - ges_state
+	lvl = lvl/max
+	if ges_state == 0 and items == 0 then
+		lvl = 0
+	end
+
+	hbarmor.armor[player_name] = math.min(lvl* (items * (100 / max_items)), 100)
+end
+
+-- update hud elemtens if value has changed
+local function update_hud(player)
+	local name = player:get_player_name()
+	--armor
+	local arm = tonumber(hbarmor.armor[name])
+	if not arm then
+		arm = 0
+		hbarmor.armor[name] = 0
+	end
+	if hbarmor.autohide then
+		-- hide armor bar completely when there is none
+		if must_hide(name, arm) then
+			hb.hide_hudbar(player, "armor")
+		else
+			hb.change_hudbar(player, "armor", arm_printable(arm))
+			hb.unhide_hudbar(player, "armor")
+		end
+	else
+		hb.change_hudbar(player, "armor", arm_printable(arm))
+	end
+end
+
+minetest.register_on_joinplayer(function(player)
+	local name = player:get_player_name()
+	custom_hud(player)
+	hbarmor.player_active[name] = true
+end)
+
+minetest.register_on_leaveplayer(function(player)
+	local name = player:get_player_name()
+	hbarmor.player_active[name] = false
+end)
+
+local main_timer = 0
+local timer = 0
+minetest.register_globalstep(function(dtime)
+	main_timer = main_timer + dtime
+	timer = timer + dtime
+	if main_timer > hbarmor.tick or timer > 4 then
+		if minetest.setting_getbool("enable_damage") then
+			if main_timer > hbarmor.tick then main_timer = 0 end
+			for _,player in ipairs(minetest.get_connected_players()) do
+				local name = player:get_player_name()
+				if hbarmor.player_active[name] == true then
+					local ret = hbarmor.get_armor(player)
+					if ret == false then
+						minetest.log("error", "[hbarmor] Call to hbarmor.get_armor in globalstep returned with false!")
+					end
+					-- update all hud elements
+					update_hud(player)
+				end
+			end
+		end
+	end
+	if timer > 4 then timer = 0 end
+end)

mods/HUD/hbarmor/locale/de.txt

@@ -0,0 +1,2 @@
+Armor = Panzerung
+%s: %d%% = %s: %d%%

mods/HUD/hbarmor/locale/template.txt

@@ -0,0 +1,4 @@
+Armor =
+
+# Format string for displaying the armor. E.g. "Armor: 100%"
+%s: %d%% =

mods/HUD/hbarmor/mod.conf

@@ -0,0 +1 @@
+name = hbarmor

mods/HUD/hbarmor/settingtypes.txt

@@ -0,0 +1,7 @@
+#If true, automatically hides the armor HUD bar when the player wears no
+#armor. Otherwise, the armor bar shows “0%”.
+hbarmor_autohide (Automatically hide armor HUD bar) bool true
+
+#Time difference in seconds between updates to the armor HUD bar.
+#Increase this number for slow servers.
+hbarmor_tick (Armor HUD bar update frequency) float 0.1 0.0 4.0

mods/HUD/hudbars/API.md

@@ -0,0 +1,193 @@
+API documentation for the HUD bars mod 1.7.0
+============================================
+
+## Introduction
+This API allows you to add, change, hide and unhide custom HUD bars for this mod.
+
+## Overview
+To give you a *very* brief overview over this API, here is the basic workflow on how to add your own custom HUD bar:
+
+* Create images for your HUD bar
+* Call `hb.register_hudbar` to make the definition of the HUD bar known to this mod
+* Call `hb.init_hudbar` for each player for which you want to use previously defined HUD bar
+* Use `hb.change_hudbar` whenever you need to change the values of a HUD bar of a certain player
+* If you need it: Use `hb.hide_hudbar` and `hb.unhide_hudbar` to hide or unhide HUD bars of a certain player
+
+## The basic rules
+In order to use this API, you should be aware of a few basic rules in order to understand it:
+
+* A HUD bar is an approximate graphical representation of the ratio of a current value and a maximum value, i.e. current health of 15 and maximum health of 20. A full HUD bar represents 100%, an empty HUD bar represents 0%.
+* The current value must always be equal to or smaller then the maximum 
+* Both current value and maximum must not be smaller than 0
+* Both current value and maximum must be real numbers. So no NaN, infinity, etc.
+* The HUD bar will be hidden if the maximum equals 0. This is intentional.
+* The health and breath HUD bars are hardcoded.
+
+These are soft rules, the HUD bars mod will not enforce all of these.
+But this mod has been programmed under the assumption that these rules are followed, for integrity.
+
+## Adding a HUD bar
+To make a new HUD bar known to this mod, you need …
+
+* … an image of size 2×16 for the bar
+* … an icon of size 16×16 (optional)
+* … to register it with `hb.register_hudbar`
+
+### Bar image
+The image for the bar will be repeated horizontally to denote the “value” of the HUD bar.
+It **must** be of size 2×16.
+If neccessary, the image will be split vertically in half, and only the left half of the image
+is displayed. So the final HUD bar will always be displayed on a per-pixel basis.
+
+The default bar images are single-colored, but you can use other styles as well, for instance,
+a vertical gradient.
+
+### Icon
+A 16×16 image shown left of the HUD bar. This is optional.
+
+### `hb.register_hudbar(identifier, text_color, label, textures, default_start_value, default_start_max, default_start_hidden, format_string)`
+This function registers a new custom HUD bar definition to the HUD bars mod, so it can be later used to be displayed, changed, hidden
+and unhidden on a per-player basis.
+Note this does not yet display the HUD bar.
+
+The HUD bars will be displayed in a “first come, first serve” order. This API does not allow fow a custom order or a way to set it
+manually in a reliable way. However, you can use the setting `hudbars_sorting` for this. See the advanced setting menu in Minetest
+for more information.
+
+
+#### Parameters
+* `identifier`: A globally unique internal name for the HUD bar, will be used later to refer to it. Please only rely on alphanumeric characters for now. The identifiers “`health`” and “`breath`” are used internally for the built-in health and breath bar, respectively. Please do not use these names.
+* `text_color`: A 3-octet number defining the color of the text. The octets denote, in this order red, green and blue and range from `0x00` (complete lack of this component) to `0xFF` (full intensity of this component). Example: `0xFFFFFF` for white.
+* `label`: A string which is displayed on the HUD bar itself to describe the HUD bar. Try to keep this string short.
+* `textures`: A table with the following fields:
+ * `bar`: The file name of the bar image (as string). This is only used for the `progress_bar` bar type (see `README.txt`, settings section).
+ * `icon`: The file name of the icon, as string. For the `progress_bar` type, it is shown as single image left of the bar, for the two statbar bar types, it is used as the statbar icon and will be repeated. This field can be `nil`, in which case no icon will be used, but this is not recommended, because the HUD bar will be invisible if the one of the statbar bar types is used.
+ * `bgicon`: The file name of the background icon, it is used as the background for the modern statbar mode only. This field can be `nil`, in which case no background icon will be displayed in this mode.
+* `default_start_value`: If this HUD bar is added to a player, and no initial value is specified, this value will be used as initial current value
+* `default_max_value`: If this HUD bar is added to a player, and no initial maximum value is specified, this value will be used as initial maximum value
+* `default_start_hidden`: The HUD bar will be initially start hidden by default when added to a player. Use `hb.unhide_hudbar` to unhide it.
+* `format_string`: This is optional; You can specify an alternative format string display the final text on the HUD bar. The default format string is “`%s: %d/%d`” (in this order: Label, current value, maximum value). See also the Lua documentation of `string.format`.
+
+#### Return value
+Always `nil`.
+
+
+## Displaying a HUD bar
+After a HUD bar has been registered, they are not yet displayed yet for any player. HUD bars must be
+explicitly initialized on a per-player basis.
+
+You probably want to do this in the `minetest.register_on_joinplayer`.
+
+### `hb.init_hudbar(player, identifier, start_value, start_max, start_hidden)`
+This function initialzes and activates a previously registered HUD bar and assigns it to a
+certain client/player. This has only to be done once per player and after that, you can change
+the values using `hb.change_hudbar`.
+
+However, if `start_hidden` was set to `true` for the HUD bar (in `hb.register_hudbar`), the HUD bar
+will initially be hidden, but the HUD elements are still sent to the client. Otherwise,
+the HUD bar will be initially be shown to the player.
+
+#### Parameters
+* `player`: `ObjectRef` of the player to which the new HUD bar should be displayed to.
+* `identifier`: The identifier of the HUD bar type, as specified in `hb.register_hudbar`.
+* `start_value`: The initial current value of the HUD bar. This is optional, `default_start_value` of the registration function will be used, if this is `nil`.
+* `start_max`: The initial maximum value of the HUD bar. This is optional, `default_start_max` of the registration function will be used, if this is `nil`
+* `start_hidden`: Whether the HUD bar is initially hidden. This is optional, `default_start_hidden` of the registration function will be used as default
+
+#### Return value
+`true` on success, `false` otherwise.
+
+
+## Modifying a HUD bar
+After a HUD bar has been added, you can change the current and maximum value and other attributes on a per-player basis.
+You use the function `hb.change_hudbar` for this.
+
+### `hb.change_hudbar(player, identifier, new_value, new_max_value, new_icon, new_bgicon, new_bar, new_label, new_text_color)`
+Changes the values and the appearance of an initialized HUD bar for a certain player. `new_value`
+and `new_max_value` are the most important parameters as they specify the new current and maximum new values, you do not need
+to worry too much about the other parameters.
+
+The following parameters are less important and provided for styling the HUD bar after registration (if
+this is desired). The “styling” parameters parallel the parameters of `hb.register_hudbar`. It is
+recommended to not change the style of a HUD bar too often as this can be distracting or confusing
+for players.
+
+`new_value`, `new_max_value` `new_icon`, `new_bgicon`, `new_bar`, `new_label` and `new_text_color` can be
+`nil`; if one of them is `nil`, that means the value is unchanged. If all those values are `nil`, this
+function is a no-op.
+
+This function tries to minimize the amount of calls to `hud_change` of the Minetest Lua API
+(and thus, network traffic), when you only change the value and/or  maximum value. In this case,
+`hud_change` is only called if it is actually needed, e.g. when the actual length of the bar
+or the displayed string changed, so you do not have to worry about it. There is, however, no
+such network optimization for the “styling” parameters, so keep this in mind.
+
+#### Parameters
+* `player`: `ObjectRef` of the player to which the HUD bar belongs to
+* `identifier`: The identifier of the HUD bar type to change, as specified in `hb.register_hudbar`.
+* `new_value`: The new current value of the HUD bar
+* `new_max_value`: The new maximum value of the HUD bar
+* `new_icon`: File name of the new icon
+* `new_bgicon`: File name of the new background icon for the modern-style statbar
+* `new_bar`: File name of the new bar segment image
+* `new_label`: A new text label of the HUD bar. Note the format string still applies
+* `new_text_color`: A 3-octet number defining the new color of the text.
+
+#### Return value
+`true` on success, `false` otherwise.
+
+
+## Hiding and unhiding a HUD bar
+You can also hide custom HUD bars, meaning they will not be displayed for a certain player. You can still
+use `hb.change_hudbar` on a hidden HUD bar, the new values will be correctly displayed after the HUD bar
+has been unhidden. Both functions will only call `hud_change` if there has been an actual change to avoid
+unneccessary traffic.
+
+Note that the hidden state of a HUD bar will *not* be saved by this mod on server shutdown, so you may need
+to write your own routines for this or by setting the correct value for `start_hidden` when calling
+`hb.init_hudbar`.
+
+### `hb.hide_hudbar(player, identifier)`
+Hides the specified HUD bar from the screen of the specified player.
+
+#### Parameters
+* `player`: `ObjectRef` of the player to which the HUD bar belongs to
+* `identifier`: The identifier of the HUD bar type to hide, as specified in `hb.register_hudbar`.
+
+#### Return value
+`true` on success, `false` otherwise.
+
+
+### `hb.unhide_hudbar(player, identifier)`
+Makes a previously hidden HUD bar visible again to a player.
+
+#### Parameters
+* `player`: `ObjectRef` of the player to which the HUD bar belongs to
+* `identifier`: The identifier of the HUD bar type to unhide, as specified in `hb.register_hudbar`.
+
+#### Return value
+`true` on success, `false` otherwise.
+
+
+## Reading HUD bar information
+It is also possible to read information about an active HUD bar.
+
+### `hb.get_hudbar_state(player, identifier)`
+Returns the current state of the active player's HUD bar.
+
+#### Parameters
+* `player`: `ObjectRef` of the player to which the HUD bar belongs to
+* `identifier`: The identifier of the HUD bar type to hide, as specified in `hb.register_hudbar`.
+
+#### Return value
+On success, returns a table which holds information on the current state of the HUD bar. Note
+the table is a deep copy of the internal HUD bar state, it is *not* a reference; the information
+hold by the table is only true for the moment you called this function. The fields of this table are:
+
+* `value`: Current value of HUD bar.
+* `max`: Current maximum value of HUD bar.
+* `hidden`: Boolean denoting whether the HUD bar is hidden.
+* `barlength`: The length of the HUD bar in pixels. This field is meaningless if the HUD bar is currently hidden.
+* `text`: The text shown on the HUD bar. This fiels is meaningless if the HUD bar is currently hidden.
+
+If the player does not exist, returns `nil` instead.

mods/HUD/hudbars/README.md

@@ -0,0 +1,56 @@
+# HUD bars
+
+## Description
+This mod changes the HUD of Minetest. It replaces the default health and breath
+symbols by horizontal colored bars with text showing the number.
+
+Furthermore, it enables other mods to add their own custom bars to the HUD,
+this mod will place them accordingly.
+
+**Important**: Keep in mind if running a server with this mod, that the custom
+position should be displayed correctly on every screen size.
+
+## Current version
+The current version is 1.7.0.
+
+This software uses [semantic versioning](http://semver.org), as defined by version 2.0.0 of the SemVer
+standard.
+
+## Settings
+This mod can be configured quite a bit. You can change HUD bar appearance, offsets, ordering, and more.
+Use the advanced settings menu in Minetest for detailed configuration.
+
+## API
+The API is used to add your own custom HUD bars.
+Documentation for the API of this mod can be found in `API.md`.
+
+## Legal
+### License of source code
+Author: Wuzzy (2015)
+
+Also: This mod was forked from the “Better HUD” [hud] mod by BlockMen.
+
+Translations:
+
+* German: Wuzzy
+* Portuguese: BrunoMine
+
+This program is free software. It comes without any warranty, to
+the extent permitted by applicable law. You can redistribute it
+and/or modify it under the terms of the Do What The Fuck You Want
+To Public License (WTFPL), version 2, as published by Sam Hocevar.
+
+### Licenses of textures
+
+* `hudbars_icon_health.png`—celeron55 (CC BY-SA 3.0), modified by BlockMen
+* `hudbars_bgicon_health.png`—celeron55 (CC BY-SA 3.0), modified by BlockMen
+* `hudbars_icon_breath.png`—kaeza (WTFPL), modified by BlockMen, modified again by Wuzzy
+* `hudbars_bgicon_breath.png`—based on previous image, edited by Wuzzy (WTFPL)
+* `hudbars_bar_health.png`—Wuzzy (WTFPL)
+* `hudbars_bar_breath.png`—Wuzzy (WTFPL)
+* `hudbars_bar_background.png`—Wuzzy (WTFPL)
+
+### License references
+
+* [CC-BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/)
+* [WTFPL](http://sam.zoy.org/wtfpl/COPYING)

mods/HUD/hudbars/changelog.txt

@@ -0,0 +1,92 @@
+Note: This software uses semantic versioning,
+as of version 2.0.0 of the standard <http://semver.org/>.
+
+0.1.0
+-----
+- Initial release, forked from mod “Better HUD” [hud].
+
+0.2.0
+-----
+- Add API documentation
+
+0.3.0
+-----
+- Rename main table from “hud” to “hb” (affects function names!)
+- Arguments 3-4 of hb.change_hudbar can be nil for values which should not change
+- Add proper function hb.init_hudbar, replaces odd call to hud.hudtables[identifier].add_all
+- Update API documentation and fix mistakes
+- Use “hudbars.conf” instead of “hud.conf”
+
+0.4.0
+-----
+- New function: hb.get_hudbar_state to get information about the state of an active HUD bar, such as values, whether it is hidden, etc.
+- hb.change_hudbar has been optimized to call hud_change fewer times, which is hopefully good for networking
+- Rename hb.register_hudbar parameter “start_hide” to “start_hidden”
+- start_hidden parameter now finally works
+- Do not affect other HUD flags (crosshair, wielditem, etc.) when starting mod
+- Show error message when trying to call hb.init_hudbar or hb.change_hudbar with bad values
+- Update documentation
+- Lots of refactoring
+- Health and breath bar now use API
+
+1.0.0
+-----
+- Add new parameter start_hidden to hb.init_hudbar, specified whether HUD bar is hidden on start
+- Copy-editing of API.md and README.txt
+- Internal: Fix add_all weirdness
+
+1.0.1
+-----
+- Fix race condition causing crash at start of server
+
+1.0.2
+-----
+- Fix other HUD elements disappearing for rejoining players
+- Remove pointless delays for initializing the HUD for new or rejoining players
+
+1.0.3
+-----
+- Adjust default HUD bars position for Minetest 0.4.12
+
+1.1.0
+-----
+- Add boolean minetest.conf setting support (hudbars_autohide_breathbar) to control whether the breath bar is automatically hidden when full (default: yes)
+
+1.2.0
+-----
+- New setting: hudbars_sorting. You can now manually sort all the HUD bars. Useful if you don't like automatic order
+- New setting: hudbars_bar_type. You now can change the appearance of the HUD bars.
+- New HUD bar types, slightly experimental: Classic statbars and modern [hud]-style statbars
+- New experimental/unfinished setting: hudbars_alignment_pattern: You can now make the HUD bars stack vertically instead of the current zig-zag pattern. Note you probably need to change source code to productively use this feature
+- Various position-related HUD bar settings (see README.txt)
+- Remove hudbars.conf support and hudbars.conf.example (was never officially supported anyways)
+
+1.2.1
+-----
+- Fix crash when enable_damage is changed in mid-game
+
+1.3.0
+-----
+- Make all settings avaialbe in Minetest's advanced settings menu
+- Fix HUD bars overlap when both hudbars_tick and hudbars_vmargin were set
+- Use Markdown syntax in readme file
+- Fix some factual mistakes in readme file
+- Add metadata: mod.conf, description.txt, screenshot.png
+
+1.4.0
+-----
+- Allow to change HUD bar images and label after it has been registered
+- Minor API.md correction
+
+1.4.1
+-----
+- Fix bug in hb.change_hudbar being a no-op if new_value and new_max value are nil
+
+1.5.0
+-----
+- Portuguese translation by BrunoMine
+
+1.5.1
+-----
+- Fix critical bug: Mod does not work with both intllib and mod security enabled
+- Update screenshot to use new 3:2 aspect ratio

mods/HUD/hudbars/depends.txt

@@ -0,0 +1 @@
+intllib?

mods/HUD/hudbars/description.txt

@@ -0,0 +1 @@
+Replaces the health and breath symbols in the HUD by “progress bars” and shows exact values. Other mods can add more progress bars for custom player stats.

mods/HUD/hudbars/init.lua

@@ -0,0 +1,559 @@
+local S
+if (minetest.get_modpath("intllib")) then
+	S = intllib.Getter()
+else
+	S = function ( s ) return s end
+end
+
+hb = {}
+
+hb.hudtables = {}
+
+-- number of registered HUD bars
+hb.hudbars_count = 0
+
+-- table which records which HUD bar slots have been “registered” so far; used for automatic positioning
+hb.registered_slots = {}
+
+hb.settings = {}
+
+function hb.load_setting(sname, stype, defaultval, valid_values)
+	local sval
+	if stype == "string" then
+		sval = minetest.setting_get(sname)
+	elseif stype == "bool" then
+		sval = minetest.setting_getbool(sname)
+	elseif stype == "number" then
+		sval = tonumber(minetest.setting_get(sname))
+	end
+	if sval ~= nil then
+		if valid_values ~= nil then
+			local valid = false
+			for i=1,#valid_values do
+				if sval == valid_values[i] then
+					valid = true
+				end
+			end
+			if not valid then
+				minetest.log("error", "[hudbars] Invalid value for "..sname.."! Using default value ("..tostring(defaultval)..").")
+				return defaultval
+			else
+				return sval
+			end
+		else
+			return sval
+		end
+	else
+		return defaultval
+	end
+end
+
+-- (hardcoded) default settings
+hb.settings.max_bar_length = 160
+hb.settings.statbar_length = 20
+
+-- statbar positions
+hb.settings.pos_left = {}
+hb.settings.pos_right = {}
+hb.settings.start_offset_left = {}
+hb.settings.start_offset_right= {}
+hb.settings.pos_left.x = hb.load_setting("hudbars_pos_left_x", "number", 0.5)
+hb.settings.pos_left.y = hb.load_setting("hudbars_pos_left_y", "number", 1)
+hb.settings.pos_right.x = hb.load_setting("hudbars_pos_right_x", "number", 0.5)
+hb.settings.pos_right.y = hb.load_setting("hudbars_pos_right_y", "number", 1)
+hb.settings.bar_type = hb.load_setting("hudbars_bar_type", "string", "statbar_modern", {"progress_bar", "statbar_classic", "statbar_modern"})
+if hb.settings.bar_type == "progress_bar" then
+	hb.settings.start_offset_left.x = hb.load_setting("hudbars_start_offset_left_x", "number", -175)
+	hb.settings.start_offset_left.y = hb.load_setting("hudbars_start_offset_left_y", "number", -86)
+	hb.settings.start_offset_right.x = hb.load_setting("hudbars_start_offset_right_x", "number", 15)
+	hb.settings.start_offset_right.y = hb.load_setting("hudbars_start_offset_right_y", "number", -86)
+else
+	hb.settings.start_offset_left.x = hb.load_setting("hudbars_start_statbar_offset_left_x", "number", -265)
+	hb.settings.start_offset_left.y = hb.load_setting("hudbars_start_statbar_offset_left_y", "number", -90)
+	hb.settings.start_offset_right.x = hb.load_setting("hudbars_start_statbar_offset_right_x", "number", 25)
+	hb.settings.start_offset_right.y = hb.load_setting("hudbars_start_statbar_offset_right_y", "number", -90)
+end
+hb.settings.vmargin  = hb.load_setting("hudbars_vmargin", "number", 32)
+hb.settings.tick = hb.load_setting("hudbars_tick", "number", 0.1)
+
+-- experimental setting: Changing this setting is not officially supported, do NOT rely on it!
+hb.settings.forceload_default_hudbars = hb.load_setting("hudbars_forceload_default_hudbars", "bool", true)
+
+-- Misc. settings
+hb.settings.alignment_pattern = hb.load_setting("hudbars_alignment_pattern", "string", "zigzag", {"zigzag", "stack_up", "stack_down"})
+hb.settings.autohide_breath = hb.load_setting("hudbars_autohide_breath", "bool", true)
+
+local sorting = minetest.setting_get("hudbars_sorting")
+if sorting ~= nil then
+	hb.settings.sorting = {}
+	for k,v in string.gmatch(sorting, "(%w+)=(%w+)") do
+		hb.settings.sorting[k] = tonumber(v)
+	end
+else
+	sorting = ""
+	hb.settings.sorting = { ["health"] = 0, ["hunger"] = 1, ["armor"] = 2, ["breath"] = 3 }
+end
+hb.settings.sorting_reverse = {}
+for k,v in string.gmatch(sorting, "(%w+)=(%w+)") do
+	hb.settings.sorting_reverse[tonumber(v)] = k
+end
+
+local function player_exists(player)
+	return player ~= nil and player:is_player()
+end
+
+-- Table which contains all players with active default HUD bars (only for internal use)
+hb.players = {}
+
+function hb.value_to_barlength(value, max)
+	if max == 0 then
+		return 0
+	else
+		if hb.settings.bar_type == "progress_bar" then
+			local x
+			if value < 0 then x=-0.5 else x = 0.5 end
+			local ret = math.modf((value/max) * hb.settings.max_bar_length + x)
+			return ret
+		else
+			local x
+			if value < 0 then x=-0.5 else x = 0.5 end
+			local ret = math.modf((value/max) * hb.settings.statbar_length + x)
+			return ret
+		end
+	end
+end
+
+function hb.get_hudtable(identifier)
+	return hb.hudtables[identifier]
+end
+
+function hb.get_hudbar_position_index(identifier)
+	if hb.settings.sorting[identifier] ~= nil then
+		return hb.settings.sorting[identifier]
+	else
+		local i = 0
+		while true do
+			if hb.registered_slots[i] ~= true and hb.settings.sorting_reverse[i] == nil then
+				return i
+			end
+			i = i + 1
+		end
+	end
+end
+
+function hb.register_hudbar(identifier, text_color, label, textures, default_start_value, default_start_max, default_start_hidden, format_string)
+	minetest.log("action", "hb.register_hudbar: "..tostring(identifier))
+	local hudtable = {}
+	local pos, offset
+	local index = math.floor(hb.get_hudbar_position_index(identifier))
+	hb.registered_slots[index] = true
+	if hb.settings.alignment_pattern == "stack_up" then
+		pos = hb.settings.pos_left
+		offset = {
+			x = hb.settings.start_offset_left.x,
+			y = hb.settings.start_offset_left.y - hb.settings.vmargin * index
+		}
+	elseif hb.settings.alignment_pattern == "stack_down" then
+		pos = hb.settings.pos_left
+		offset = {
+			x = hb.settings.start_offset_left.x,
+			y = hb.settings.start_offset_left.y + hb.settings.vmargin * index
+		}
+	else
+		if index % 2 == 0 then
+			pos = hb.settings.pos_left
+			offset = {
+				x = hb.settings.start_offset_left.x,
+				y = hb.settings.start_offset_left.y - hb.settings.vmargin * (index/2)
+			}
+		else
+			pos = hb.settings.pos_right
+			offset = {
+				x = hb.settings.start_offset_right.x,
+				y = hb.settings.start_offset_right.y - hb.settings.vmargin * ((index-1)/2)
+			}
+		end
+	end
+	if format_string == nil then
+		format_string = S("%s: %d/%d")
+	end
+
+	hudtable.add_all = function(player, hudtable, start_value, start_max, start_hidden)
+		if start_value == nil then start_value = hudtable.default_start_value end
+		if start_max == nil then start_max = hudtable.default_start_max end
+		if start_hidden == nil then start_hidden = hudtable.default_start_hidden end
+		local ids = {}
+		local state = {}
+		local name = player:get_player_name()
+		local bgscale, iconscale, text, barnumber, bgiconnumber
+		if start_max == 0 or start_hidden then
+			bgscale = { x=0, y=0 }
+		else
+			bgscale = { x=1, y=1 }
+		end
+		if start_hidden then
+			iconscale = { x=0, y=0 }
+			barnumber = 0
+			bgiconnumber = 0
+			text = ""
+		else
+			iconscale = { x=1, y=1 }
+			barnumber = hb.value_to_barlength(start_value, start_max)
+			bgiconnumber = hb.settings.statbar_length
+			text = string.format(format_string, label, start_value, start_max)
+		end
+		if hb.settings.bar_type == "progress_bar" then
+			ids.bg = player:hud_add({
+				hud_elem_type = "image",
+				position = pos,
+				scale = bgscale,
+				text = "hudbars_bar_background.png",
+				alignment = {x=1,y=1},
+				offset = { x = offset.x - 1, y = offset.y - 1 },
+			})
+			if textures.icon ~= nil then
+				ids.icon = player:hud_add({
+					hud_elem_type = "image",
+					position = pos,
+					scale = iconscale,
+					text = textures.icon,
+					alignment = {x=-1,y=1},
+					offset = { x = offset.x - 3, y = offset.y },
+				})
+			end
+		elseif hb.settings.bar_type == "statbar_modern" then
+			if textures.bgicon ~= nil then
+				ids.bg = player:hud_add({
+					hud_elem_type = "statbar",
+					position = pos,
+					text = textures.bgicon,
+					number = bgiconnumber,
+					alignment = {x=-1,y=-1},
+					offset = { x = offset.x, y = offset.y },
+					direction = 0,
+					size = {x=24, y=24},
+				})
+			end
+		end
+		local bar_image, bar_size
+		if hb.settings.bar_type == "progress_bar" then
+			bar_image = textures.bar
+			bar_size = nil
+		elseif hb.settings.bar_type == "statbar_classic" or hb.settings.bar_type == "statbar_modern" then
+			bar_image = textures.icon
+			bar_size = {x=24, y=24}
+		end
+		ids.bar = player:hud_add({
+			hud_elem_type = "statbar",
+			position = pos,
+			text = bar_image,
+			number = barnumber,
+			alignment = {x=-1,y=-1},
+			offset = offset,
+			direction = 0,
+			size = bar_size,
+		})
+		if hb.settings.bar_type == "progress_bar" then
+			ids.text = player:hud_add({
+				hud_elem_type = "text",
+				position = pos,
+				text = text,
+				alignment = {x=1,y=1},
+				number = text_color,
+				direction = 0,
+				offset = { x = offset.x + 2,  y = offset.y - 1},
+		})
+		end
+		-- Do not forget to update hb.get_hudbar_state if you add new fields to the state table
+		state.hidden = start_hidden
+		state.value = start_value
+		state.max = start_max
+		state.text = text
+		state.barlength = hb.value_to_barlength(start_value, start_max)
+
+		local main_error_text =
+			"[hudbars] Bad initial values of HUD bar identifier “"..tostring(identifier).."” for player "..name..". "
+
+		if start_max < start_value then
+			minetest.log("error", main_error_text.."start_max ("..start_max..") is smaller than start_value ("..start_value..")!")
+		end
+		if start_max < 0 then
+			minetest.log("error", main_error_text.."start_max ("..start_max..") is smaller than 0!")
+		end
+		if start_value < 0 then
+			minetest.log("error", main_error_text.."start_value ("..start_value..") is smaller than 0!")
+		end
+
+		hb.hudtables[identifier].hudids[name] = ids
+		hb.hudtables[identifier].hudstate[name] = state
+	end
+
+	hudtable.identifier = identifier
+	hudtable.format_string = format_string
+	hudtable.label = label
+	hudtable.hudids = {}
+	hudtable.hudstate = {}
+	hudtable.default_start_hidden = default_start_hidden
+	hudtable.default_start_value = default_start_value
+	hudtable.default_start_max = default_start_max
+
+	hb.hudbars_count= hb.hudbars_count + 1
+	
+	hb.hudtables[identifier] = hudtable
+end
+
+function hb.init_hudbar(player, identifier, start_value, start_max, start_hidden)
+	if not player_exists(player) then return false end
+	local hudtable = hb.get_hudtable(identifier)
+	hb.hudtables[identifier].add_all(player, hudtable, start_value, start_max, start_hidden)
+	return true
+end
+
+function hb.change_hudbar(player, identifier, new_value, new_max_value, new_icon, new_bgicon, new_bar, new_label, new_text_color)
+	if new_value == nil and new_max_value == nil and new_icon == nil and new_bgicon == nil and new_bar == nil and new_label == nil and new_text_color == nil then
+		return true
+	end
+	if not player_exists(player) then
+		return false
+	end
+
+	local name = player:get_player_name()
+	local hudtable = hb.get_hudtable(identifier)
+	local value_changed, max_changed = false, false
+
+	if new_value ~= nil then
+		if new_value ~= hudtable.hudstate[name].value then
+			hudtable.hudstate[name].value = new_value
+			value_changed = true
+		end
+	else
+		new_value = hudtable.hudstate[name].value
+	end
+	if new_max_value ~= nil then
+		if new_max_value ~= hudtable.hudstate[name].max then
+			hudtable.hudstate[name].max = new_max_value
+			max_changed = true
+		end
+	else
+		new_max_value = hudtable.hudstate[name].max
+	end
+
+	if hb.settings.bar_type == "progress_bar" then
+		if new_icon ~= nil and hudtable.hudids[name].icon ~= nil then
+			player:hud_change(hudtable.hudids[name].icon, "text", new_icon)
+		end
+		if new_bgicon ~= nil and hudtable.hudids[name].bgicon ~= nil then
+			player:hud_change(hudtable.hudids[name].bgicon, "text", new_bgicon)
+		end
+		if new_bar ~= nil then
+			player:hud_change(hudtable.hudids[name].bar , "text", new_bar)
+		end
+		if new_label ~= nil then
+			hudtable.label = new_label
+			local new_text = string.format(hudtable.format_string, new_label, hudtable.hudstate[name].value, hudtable.hudstate[name].max)
+			player:hud_change(hudtable.hudids[name].text, "text", new_text)
+		end
+		if new_text_color ~= nil then
+			player:hud_change(hudtable.hudids[name].text, "number", new_text_color)
+		end
+	else
+		if new_icon ~= nil and hudtable.hudids[name].bar ~= nil then
+			player:hud_change(hudtable.hudids[name].bar, "text", new_icon)
+		end
+		if new_bgicon ~= nil and hudtable.hudids[name].bg ~= nil then
+			player:hud_change(hudtable.hudids[name].bg, "text", new_bgicon)
+		end
+	end
+
+	local main_error_text =
+		"[hudbars] Bad call to hb.change_hudbar, identifier: “"..tostring(identifier).."”, player name: “"..name.."”. "
+	if new_max_value < new_value then
+		minetest.log("error", main_error_text.."new_max_value ("..new_max_value..") is smaller than new_value ("..new_value..")!")
+	end
+	if new_max_value < 0 then
+		minetest.log("error", main_error_text.."new_max_value ("..new_max_value..") is smaller than 0!")
+	end
+	if new_value < 0 then
+		minetest.log("error", main_error_text.."new_value ("..new_value..") is smaller than 0!")
+	end
+
+	if hudtable.hudstate[name].hidden == false then
+		if max_changed and hb.settings.bar_type == "progress_bar" then
+			if hudtable.hudstate[name].max == 0 then
+				player:hud_change(hudtable.hudids[name].bg, "scale", {x=0,y=0})
+			else
+				player:hud_change(hudtable.hudids[name].bg, "scale", {x=1,y=1})
+			end
+		end
+
+		if value_changed or max_changed then
+			local new_barlength = hb.value_to_barlength(new_value, new_max_value)
+			if new_barlength ~= hudtable.hudstate[name].barlength then
+				player:hud_change(hudtable.hudids[name].bar, "number", hb.value_to_barlength(new_value, new_max_value))
+				hudtable.hudstate[name].barlength = new_barlength
+			end
+
+			if hb.settings.bar_type == "progress_bar" then
+				local new_text = string.format(hudtable.format_string, hudtable.label, new_value, new_max_value)
+				if new_text ~= hudtable.hudstate[name].text then
+					player:hud_change(hudtable.hudids[name].text, "text", new_text)
+					hudtable.hudstate[name].text = new_text
+				end
+			end
+		end
+	end
+	return true
+end
+
+function hb.hide_hudbar(player, identifier)
+	if not player_exists(player) then return false end
+	local name = player:get_player_name()
+	local hudtable = hb.get_hudtable(identifier)
+	if hudtable == nil then return false end
+	if(hudtable.hudstate[name].hidden == false) then
+		if hb.settings.bar_type == "progress_bar" then
+			if hudtable.hudids[name].icon ~= nil then
+				player:hud_change(hudtable.hudids[name].icon, "scale", {x=0,y=0})
+			end
+			player:hud_change(hudtable.hudids[name].bg, "scale", {x=0,y=0})
+			player:hud_change(hudtable.hudids[name].text, "text", "")
+		elseif hb.settings.bar_type == "statbar_modern" then
+			player:hud_change(hudtable.hudids[name].bg, "number", 0)
+		end
+		player:hud_change(hudtable.hudids[name].bar, "number", 0)
+		hudtable.hudstate[name].hidden = true
+	end
+	return true
+end
+
+function hb.unhide_hudbar(player, identifier)
+	if not player_exists(player) then return false end
+	local name = player:get_player_name()
+	local hudtable = hb.get_hudtable(identifier)
+	if hudtable == nil then return false end
+	if(hudtable.hudstate[name].hidden) then
+		local value = hudtable.hudstate[name].value
+		local max = hudtable.hudstate[name].max
+		if hb.settings.bar_type == "progress_bar" then
+			if hudtable.hudids[name].icon ~= nil then
+				player:hud_change(hudtable.hudids[name].icon, "scale", {x=1,y=1})
+			end
+			if hudtable.hudstate[name].max ~= 0 then
+				player:hud_change(hudtable.hudids[name].bg, "scale", {x=1,y=1})
+			end
+			player:hud_change(hudtable.hudids[name].text, "text", tostring(string.format(hudtable.format_string, hudtable.label, value, max)))
+		elseif hb.settings.bar_type == "statbar_modern" then
+			player:hud_change(hudtable.hudids[name].bg, "number", hb.settings.statbar_length)
+		end
+		player:hud_change(hudtable.hudids[name].bar, "number", hb.value_to_barlength(value, max))
+		hudtable.hudstate[name].hidden = false
+	end
+	return true
+end
+
+function hb.get_hudbar_state(player, identifier)
+	if not player_exists(player) then return nil end
+	local ref = hb.get_hudtable(identifier).hudstate[player:get_player_name()]
+	-- Do not forget to update this chunk of code in case the state changes
+	local copy = {
+		hidden = ref.hidden,
+		value = ref.value,
+		max = ref.max,
+		text = ref.text,
+		barlength = ref.barlength,
+	}
+	return copy
+end
+
+--register built-in HUD bars
+if minetest.setting_getbool("enable_damage") or hb.settings.forceload_default_hudbars then
+	hb.register_hudbar("health", 0xFFFFFF, S("Health"), { bar = "hudbars_bar_health.png", icon = "hudbars_icon_health.png", bgicon = "hudbars_bgicon_health.png" }, 20, 20, false)
+	hb.register_hudbar("breath", 0xFFFFFF, S("Breath"), { bar = "hudbars_bar_breath.png", icon = "hudbars_icon_breath.png", bgicon = "hudbars_bgicon_breath.png" }, 10, 10, true)
+end
+
+local function hide_builtin(player)
+	local flags = player:hud_get_flags()
+	flags.healthbar = false
+	flags.breathbar = false
+	player:hud_set_flags(flags)
+end
+
+
+local function custom_hud(player)
+	if minetest.setting_getbool("enable_damage") or hb.settings.forceload_default_hudbars then
+		local hide
+		if minetest.setting_getbool("enable_damage") then
+			hide = false
+		else
+			hide = true
+		end
+		hb.init_hudbar(player, "health", player:get_hp(), nil, hide)
+		local breath = player:get_breath()
+		local hide_breath
+		if breath == 11 and hb.settings.autohide_breath == true then hide_breath = true else hide_breath = false end
+		hb.init_hudbar(player, "breath", math.min(breath, 10), nil, hide_breath or hide)
+	end
+end
+
+local function update_health(player)
+	hb.change_hudbar(player, "health", player:get_hp())
+end
+
+-- update built-in HUD bars
+local function update_hud(player)
+	if not player_exists(player) then return end
+	if minetest.setting_getbool("enable_damage") then
+		if hb.settings.forceload_default_hudbars then
+			hb.unhide_hudbar(player, "health")
+		end
+		--air
+		local breath = player:get_breath()
+		
+		if breath == 11 and hb.settings.autohide_breath == true then
+			hb.hide_hudbar(player, "breath")
+		else
+			hb.unhide_hudbar(player, "breath")
+			hb.change_hudbar(player, "breath", math.min(breath, 10))
+		end
+		--health
+		update_health(player)
+	elseif hb.settings.forceload_default_hudbars then
+		hb.hide_hudbar(player, "health")
+		hb.hide_hudbar(player, "breath")
+	end
+end
+
+minetest.register_on_player_hpchange(update_health)
+
+minetest.register_on_respawnplayer(function(player)
+	update_health(player)
+	hb.hide_hudbar(player, "breath")
+end)
+
+minetest.register_on_joinplayer(function(player)
+	hide_builtin(player)
+	custom_hud(player)
+	hb.players[player:get_player_name()] = player
+end)
+
+minetest.register_on_leaveplayer(function(player)
+	hb.players[player:get_player_name()] = nil
+end)
+
+local main_timer = 0
+local timer = 0
+minetest.register_globalstep(function(dtime)
+	main_timer = main_timer + dtime
+	timer = timer + dtime
+	if main_timer > hb.settings.tick or timer > 4 then
+		if main_timer > hb.settings.tick then main_timer = 0 end
+		-- only proceed if damage is enabled
+		if minetest.setting_getbool("enable_damage") or hb.settings.forceload_default_hudbars then
+			for _, player in pairs(hb.players) do
+				-- update all hud elements
+				update_hud(player)
+			end
+		end
+	end
+	if timer > 4 then timer = 0 end
+end)

mods/HUD/hudbars/locale/de.txt

@@ -0,0 +1,3 @@
+Health = Leben
+Breath = Atem
+%s: %d/%d = %s: %d/%d

mods/HUD/hudbars/locale/pt.txt

@@ -0,0 +1,5 @@
+Health = Saude
+Breath = Folego
+
+# Formato de string padrão para progresso bar-style de barras do HUD, por exemplo “Saude 5/20”
+%s: %d/%d

mods/HUD/hudbars/locale/template.txt

@@ -0,0 +1,5 @@
+Health
+Breath
+
+# Default format string for progress bar-style HUD bars, e.g. “Health 5/20”
+%s: %d/%d

mods/HUD/hudbars/mod.conf

@@ -0,0 +1 @@
+name = hudbars

mods/HUD/hudbars/settingtypes.txt

@@ -0,0 +1,119 @@
+[Appearance]
+# Specifies how the value indicators (i.e. health, breah, etc.) look. There are 3 styles
+# available. You can choose between the default progress-bar-like bars and the good
+# old statbars like you know from vanilla Minetest.
+# These values are possible:
+#   - progress_bar:    A horizontal progress-bar-like bar with a label, showing numerical value
+#                      (current, maximum), and an icon. These bars usually convey the most
+#                      information. This is the default and recommended value.
+#   - statbar_classic: Classic statbar, like in vanilla Minetest. Made out of up to 20
+#                      half-symbols. Those bars represent the vague ratio between
+#                      the current value and the maximum value. 1 half-symbol stands for
+#                      approximately 5% of the maximum value.
+#   - statbar_modern:  Like the classic statbar, but also supports background images, this
+#                      kind of statbar may be considered to be more user-friendly than the
+#                      classic statbar. This bar type closely resembles the mod
+#                      “Better HUD” [hud] by BlockMen.
+hudbars_bar_type (HUD bars style) enum progress_bar progress_bar,statbar_classic,statbar_modern
+
+
+# If enabled (default), the breath indicators in the HUD will be automatically hidden shortly
+# after the breath has been filled up. Otherwise, the breath will always be displayed. 
+hudbars_autohide_breath (Automatically hide breath indicators) bool true
+
+# This setting changes the way the HUD bars are ordered on the display. You can choose
+# between a zig-zag pattern (default) or a vertically stacked pattern.
+# The following values are allowed:
+#    - zigzag:     Starting from the left bottom, the next is right from the first,
+#                  the next is above the first, the next is right of the third, etc.
+#    - stack_up:   The HUD bars are stacked vertically, going upwards.
+#    - stack_down: The HUD bars are stacked vertically, going downwards.
+hudbars_alignment_pattern (HUD bars alignment pattern) enum zigzag zigzag,stack_up,stack_down
+
+# This setting allows you to specify the order of the HUD bars explicitly. If left empty
+# (the default), the health and breath indicators come first, additional indicators
+# may appear in any order. This setting is quite technical and normal users probably do not
+# need to worry about it.
+#
+# Syntax:
+# The setting has to be specified as a comma-seperated list of key=value pairs, where a key
+# refers to the identifier of a HUD bar and the value refers to the slot number of where the
+# HUD bar should be placed. The slot number must be an integer greater of equal to 0. Where
+# the HUD bars will be displayed exactly depends on the alignment pattern being used.
+# All HUD bars to which no order value has been applied will fill in all slots which have
+# not been occupied by the HUD bars specified in this setting, the slots will be filled in
+# from the lowest slot number.
+# Note that the order of those remaining HUD bars is not fixed, it basically just boils
+# down on which mod “came” first. Don't worry, the mod will still work perfectly fine, this
+# setting is entirely optional.
+# The identifier for the health bar is “health” and the identifier for the breath bar is
+# “breath”. For other HUD bars, you have to learn it from the mod which is supplying them.
+#
+# Be careful not to use slot indices twice, or else different HUD bars will be drawn over
+# each other!
+#
+# Example: “breath=0, health=1”
+# This makes the breath bar first and the health bar second, which is the opposite order
+# of the default one.
+hudbars_sorting (HUD bars order) string
+
+[Positions and offsets]
+# Horizontal (x) main position of the HUD bars over the entire screen.
+# 0.0 is left-most, 1.0 is right-most.
+# For the zig-zag alignment pattern, this is for the left HUD bars.
+hudbars_pos_left_x (Left HUD bar screen x position) float 0.5 0.0 1.0
+# Vertical (y) main position of the HUD bars over the entire screen.
+# 0.0 is top, 1.0 is bottom.
+# For the zig-zag alignment pattern, this is for the left HUD bars.
+hudbars_pos_left_y (Left HUD bar screen y position) float 1.0 0.0 1.0
+# Horizontal (x) main position of the right HUD bars over the entire screen.
+# 0.0 is left-most, 1.0 is right-most.
+# Only used for the zig-zag alignment pattern.
+hudbars_pos_right_x (Right HUD bar screen x position) float 0.5 0.0 1.0
+# Vertical main position (y) of the right HUD bars over the entire screen.
+# 0.0 is top, 1.0 is bottom.
+# Only used for the zig-zag alignment pattern.
+hudbars_pos_right_y (Right HUD bar screen y position) float 1.0 0.0 1.0
+
+# Precise x offset in pixels from the basic screen x position of the HUD bars.
+# For the zig-zag alignment pattern, this is for the left HUD bars.
+# This setting is used for the progress bar HUD bar style.
+hudbars_start_offset_left_x (Left HUD bar x offset) int -175
+# Precise y offset in pixels from the basic screen y position of the HUD bars.
+# For the zig-zag alignment pattern, this is for the left HUD bars.
+# This setting is used for the progress bar HUD bar style.
+hudbars_start_offset_left_y (Left HUD bar y offset) int -86
+# Precise x offset in pixels from the basic screen x position of the right HUD bars.
+# Only used for the zig-zag alignment pattern.
+# This setting is used for the progress bar HUD bar style.
+hudbars_start_offset_right_x (Right HUD bar x offset) int 15
+# Precise y offset in pixels from the basic screen y position of the right HUD bars.
+# Only used for the zig-zag alignment pattern.
+# This setting is used for the progress bar HUD bar style.
+hudbars_start_offset_right_y (Right HUD bar y offset) int -86
+
+# Precise x offset in pixels from the basic screen x position of the HUD statbars.
+# For the zig-zag alignment pattern, this is for the left HUD statbars.
+# This setting is used for the classic and modern statbar styles.
+hudbars_start_statbar_offset_left_x (Left HUD statbar x offset) int -265
+# Precise y offset in pixels from the basic screen y position of the HUD statbars.
+# For the zig-zag alignment pattern, this is for the left HUD statbars.
+# This setting is used for the classic and modern statbar styles.
+hudbars_start_statbar_offset_left_y (Left HUD statbar y offset) int -90
+# Precise x offset in pixels from the basic screen x position of the right HUD statbars.
+# Only used for the zig-zag alignment pattern.
+# This setting is used for the classic and modern statbar styles.
+hudbars_start_statbar_offset_right_x (Right HUD statbar x offset) int 25
+# Precise y offset in pixels from the basic screen y position of the right HUD statbars.
+# Only used for the zig-zag alignment pattern.
+# This setting is used for the classic and modern statbar styles.
+hudbars_start_statbar_offset_right_y (Right HUD statbar y offset) int -90
+
+# The vertical distance between two HUD bars, in pixels.
+hudbars_vmargin (Vertical distance between HUD bars) int 24 0
+
+[Performance]
+# The of seconds which need to pass before the server updates the default HUD bars
+# (health and breath). Increase this number if you have a slow server or a slow network
+# connection and experience performance problems.
+hudbars_tick (Default HUD bars update interval) float 0.1 0.0 4.0

mods/HUD/mcl_craftguide/.luacheckrc

@@ -0,0 +1,7 @@
+unused_args = false
+allow_defined_top = true
+
+read_globals = {
+	"minetest",
+	"default",
+}

mods/HUD/mcl_craftguide/LICENSE

@@ -0,0 +1,681 @@
+┌───────────────────────────────────────────────────────────────────┐
+│  Copyright (c) 2015-2017 kilbith <jeanpatrick.guerrero@gmail.com> │
+│								    │
+│  Code: GPL version 3						    │
+│  Textures: WTFPL (credits: Gambit)				    │
+└───────────────────────────────────────────────────────────────────┘
+
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    {one line to give the program's name and a brief idea of what it does.}
+    Copyright (C) {year}  {name of author}
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    {project}  Copyright (C) {year}  {fullname}
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

mods/HUD/mcl_craftguide/README.md

@@ -0,0 +1,14 @@
+## ![Preview1](http://i.imgur.com/fIPNYkb.png) Crafting Guide ##
+
+#### A Crafting Guide for Minetest that doesn't suck. ####
+
+#### `craftguide` is simply the most comprehensive mod of his category, with the cleanest code. ####
+#### Consult the [Minetest Wiki](http://wiki.minetest.net/Crafting_guide) for more details and comparisons. ####
+
+#### This crafting guide is usable with a blue book named *"Crafting Guide"*. ####
+
+#### This crafting guide features two modes : Standard and Progressive. ####
+The Progressive mode is a Terraria-like system that only shows recipes you can craft from items in inventory.
+The progressive mode can be enabled with `craftguide_progressive_mode = true` in `minetest.conf`.
+
+![Preview2](http://i.imgur.com/3q7rVSo.png)

mods/HUD/mcl_craftguide/depends.txt

@@ -0,0 +1 @@
+mcl_core

mods/HUD/mcl_craftguide/description.txt

@@ -0,0 +1,2 @@
+The most comprehensive Crafting Guide
+on Minetest.

mods/HUD/mcl_craftguide/init.lua

@@ -0,0 +1,514 @@
+mcl_craftguide = {}
+
+local craftguide, datas, mt = {}, {}, minetest
+local progressive_mode = mt.setting_getbool("craftguide_progressive_mode")
+local get_recipe = mt.get_craft_recipe
+local get_result, show_formspec = mt.get_craft_result, mt.show_formspec
+local reg_items = mt.registered_items
+
+local get_recipes = function(query_item)
+	local recipes = mt.get_all_craft_recipes(query_item)
+
+	-- Manually add repairing recipes (workaround, because get_all_craft_recipes
+	-- doesn't return repairing recipes)
+	if minetest.get_modpath("mcl_core") then
+		local def = minetest.registered_items[query_item]
+		if def.type == "tool" then
+			if recipes == nil then
+				recipes = {}
+			end
+			table.insert(recipes, {
+				type = "normal",
+				width = 0,
+				items = { [1] = query_item, [2] = query_item },
+				output = query_item,
+				-- Special marker for repairing recipes
+				_is_toolrepair = true,
+			})
+		end
+	end
+	return recipes
+end
+
+-- Lua 5.3 removed `table.maxn`, use this alternative in case of breakage:
+-- https://github.com/kilbith/xdecor/blob/master/handlers/helpers.lua#L1
+local remove, maxn, sort = table.remove, table.maxn, table.sort
+local min, max, floor, ceil = math.min, math.max, math.floor, math.ceil
+
+local group_stereotypes = {
+	wool	     = "mcl_wool:white",
+	carpet       = "mcl_wool:white_carpet",
+	dye	     = "mcl_dye:white",
+	water_bucket = "bucket:bucket_water",
+	flower	     = "mcl_flowers:dandelion",
+	mushroom     = "mcl_farming:mushroom_brown",
+	wood_slab    = "stairs:slab_wood",
+	wood_stairs  = "stairs:stairs_wood",
+	coal         = "mcl_core:coal_lump",
+	shulker_box  = "mcl_chests:violet_shulker_box",
+	quartz_block = "mcl_nether:quartz_block",
+	mesecon_conductor_craftable = "mesecons:wire_00000000_off",
+}
+
+local group_names = {
+	shulker_box = "Any shulker box",
+	wool = "Any wool",
+	wood = "Any wood planks",
+	tree = "Any wood",
+	sand = "Any sand",
+	sandstone = "Any sandstone (yellow)",
+	redsandstone = "Any red sandstone",
+	carpet = "Any carpet",
+	dye = "Any dye",
+	water_bucket = "Any water bucket",
+	flower = "Any flower",
+	mushroom = "Any mushroom",
+	wood_slab = "Any wooden slab",
+	wood_stairs = "Any wooden stairs",
+	coal = "Any coal",
+	quartz_block = "Any kind of quartz block",
+	stonebrick = "Any stone bricks"
+}
+
+function craftguide:group_to_item(item)
+	if item:sub(1,6) == "group:" then
+		local itemsub = item:sub(7)
+		if group_stereotypes[itemsub] then
+			item = group_stereotypes[itemsub]
+		elseif reg_items["mcl_core:"..itemsub] then
+			item = item:gsub("group:", "mcl_core:")
+		else
+			for name, def in pairs(reg_items) do
+				if def.groups[item:match("[^,:]+$")] then
+					item = name
+				end
+			end
+		end
+	end
+	return item:sub(1,6) == "group:" and "" or item
+end
+
+local function extract_groups(str)
+	if str:sub(1,6) ~= "group:" then return end
+	return str:sub(7):split(",")
+end
+
+local function colorize(str)
+	-- If client <= 0.4.14, don't colorize for compatibility.
+	return mt.colorize and mt.colorize("#FFFF00", str) or str
+end
+
+local function get_fueltime(item)
+	return get_result({method="fuel", width=1, items={item}}).time
+end
+
+function craftguide:get_tooltip(item, recipe_type, cooktime, groups)
+	local raw = self:get_tooltip_raw(item, recipe_type, cooktime, groups)
+	if raw == "" then
+		return raw
+	else
+		local tooltip = "tooltip["..item..";"
+		tooltip = tooltip .. raw
+		tooltip = tooltip .. "]"
+		return tooltip
+	end
+end
+
+function craftguide:get_tooltip_raw(item, recipe_type, cooktime, groups)
+	local tooltip, item_desc  = "", ""
+	local fueltime = get_fueltime(item)
+	local has_extras = groups or recipe_type == "cooking" or fueltime > 0
+
+	if reg_items[item] then
+		if not groups then
+			item_desc = reg_items[item].description
+		end
+	else
+		return tooltip.."Unknown Item ("..item..")]"
+	end
+	if groups then
+		local gcol = "#FFAAFF"
+		local groupstr
+		if #groups == 1 then
+			if group_names[groups[1]] then
+				groupstr = group_names[groups[1]]
+			else
+				groupstr = "Any item belonging to the " .. groups[1] .. " group"
+			end
+		else
+			groupstr = "Any item belonging to the following groups: "
+			for i=1, #groups do
+				groupstr = groupstr .. groups[i]..
+				(groups[i+1] and " and " or "")
+			end
+		end
+		tooltip = tooltip..core.colorize(gcol, groupstr)
+	end
+	tooltip = tooltip .. item_desc
+	if recipe_type == "cooking" then
+		tooltip = tooltip.."\nCooking time: "..
+			colorize(cooktime)
+	end
+	if fueltime > 0 and not groups then
+		tooltip = tooltip.."\nBurning time: "..
+			colorize(fueltime)
+	end
+
+	return tooltip
+end
+
+function craftguide:get_recipe(iY, xoffset, tooltip_raw, item, recipe_num, recipes)
+	local formspec, recipes_total = "", #recipes
+	if recipes_total > 1 then
+		formspec = formspec..
+			"button[0,"..(iY+3)..";2,1;alternate;Alternate]"..
+			"label[0,"..(iY+2)..".5;Recipe "..
+				recipe_num.." of "..recipes_total.."]"
+	end
+	local recipe_type = recipes[recipe_num].type
+
+	local items = recipes[recipe_num].items
+	local width = recipes[recipe_num].width
+	local cooking_time = 10
+	local is_shapeless = false
+	if recipe_type == "normal" and width == 0 then
+		is_shapeless = true
+		if #items <= 4 then
+			width = 2
+		else
+			width = min(3, #items)
+		end
+	end
+
+	if recipe_type == "cooking" then
+		cooking_time = width
+		width = 1
+		formspec = formspec..
+			"image["..(xoffset-0.8)..","..(iY+1)..
+				".5;0.5,0.5;default_furnace_front_active.png]"
+	elseif is_shapeless then
+		formspec = formspec..
+			"image["..(xoffset-0.8)..","..(iY+1)..
+			".5;0.5,0.5;craftguide_shapeless.png]"
+	end
+
+	local rows = ceil(maxn(items) / width)
+	local btn_size, craftgrid_limit = 1, 5
+
+	if recipe_type == "normal" and
+			width > craftgrid_limit or rows > craftgrid_limit then
+		formspec = formspec..
+			"label["..xoffset..","..(iY+2)..
+				";Recipe is too big to\nbe displayed ("..
+				width.."x"..rows..")]"
+	else
+		for i, v in pairs(items) do
+			local X = (i-1) % width + xoffset - 4 + (3 - max(1, width))
+			local Y = ceil(i / width + iY+2 - min(2, rows))
+
+			if recipe_type == "normal" and
+					width > 3 or rows > 3 then
+				btn_size = width > 3 and 3 / width or 3 / rows
+				X = btn_size * (i % width) + xoffset - 4 + (3 - max(1, width))
+
+				Y = btn_size * floor((i-1) / width) + iY+3 -
+					min(2, rows)
+			end
+
+			local groups = extract_groups(v)
+			local label = groups and "\nG" or ""
+			local item_r = self:group_to_item(v)
+			local tltip = self:get_tooltip(
+					item_r, recipe_type, cooking_time, groups)
+
+			formspec = formspec..
+				"item_image_button["..X..","..Y..";"..
+					btn_size..","..btn_size..";"..item_r..
+					";"..item_r..";"..label.."]"..tltip
+		end
+	end
+	local output = recipes[recipe_num].output
+	local label = ""
+	if recipes[recipe_num]._is_toolrepair then
+		tooltip_raw = tooltip_raw .. "\n" .. core.colorize("#00FF00", string.format("Repaired by %.0f%%", (mcl_core.repair*100)))
+		label = "\nR"
+	end
+	return formspec..
+		"image["..(xoffset-1)..","..(iY+2)..
+			".12;0.9,0.7;craftguide_arrow.png]"..
+		"item_image_button["..(xoffset)..","..(iY+2)..";1,1;"..
+			output..";"..item.."_out"..";"..label.."]".."tooltip["..item.."_out"..";"..minetest.formspec_escape(tooltip_raw).."]"
+end
+
+function craftguide:get_formspec(player_name, is_fuel)
+	local data = datas[player_name]
+	local iY = data.iX - 5
+	local ipp = data.iX * iY
+
+	if not data.items then
+		data.items = datas.init_items
+	end
+	data.pagemax = max(1, ceil(#data.items / ipp))
+
+	local formspec = "size["..data.iX..","..(iY+3)..".6;]"..
+			mcl_core.gui_slots ..
+			mcl_core.gui_bg ..
+			[[background[1,1;1,1;craftguide_bg.png;true]
+			button[2.4,0.21;0.8,0.5;search;?]
+			button[3.05,0.21;0.8,0.5;clear;X]
+			tooltip[search;Search]
+			tooltip[clear;Reset]
+			tooltip[size_inc;Increase window size]
+			tooltip[size_dec;Decrease window size]
+			field_close_on_enter[filter, false] ]]..
+			"button["..(data.iX/2)..",-0.02;0.7,1;size_inc;+]"..
+			"button["..((data.iX/2) + 0.5)..
+				",-0.02;0.7,1;size_dec;-]"..
+			"button["..(data.iX-3)..".4,0;0.8,0.95;prev;<]"..
+			"label["..(data.iX-2)..".1,0.18;"..
+				colorize(data.pagenum).." / "..data.pagemax.."]"..
+			"button["..(data.iX-1)..".2,0;0.8,0.95;next;>]"..
+			"field[0.3,0.32;2.5,1;filter;;"..
+				mt.formspec_escape(data.filter).."]"
+
+	local even_num = data.iX % 2 == 0
+	local xoffset = data.iX / 2 + (even_num and 0.5 or 0) + 2
+
+	if not next(data.items) then
+		formspec = formspec..
+			"label["..(xoffset - (even_num and 1.5 or 1))..
+				",2;No item to show]"
+	end
+
+	local first_item = (data.pagenum - 1) * ipp
+	for i = first_item, first_item + ipp - 1 do
+		local name = data.items[i+1]
+		if not name then break end
+		local X = i % data.iX
+		local Y = (i % ipp - X) / data.iX + 1
+
+		formspec = formspec..
+			"item_image_button["..X..","..Y..";1,1;"..
+				name..";"..name.."_inv;]"
+	end
+
+	if data.item and reg_items[data.item] then
+		local tooltip_raw = self:get_tooltip_raw(data.item)
+		local tooltip = ""
+		if tooltip_raw ~= "" then
+			tooltip = "tooltip["..data.item..";"..minetest.formspec_escape(tooltip_raw).."]"
+		end
+		if not data.recipes_item or (is_fuel and not
+				get_recipe(data.item).items) then
+			formspec = formspec..
+				"image["..(xoffset-1)..","..(iY+2)..
+					".12;0.9,0.7;craftguide_arrow.png]"..
+				"item_image_button["..(xoffset-2)..","..(iY+2)..
+					";1,1;"..data.item..";"..data.item..";]"..
+				tooltip..
+				"image["..(xoffset)..","..
+					(iY+1.98)..";1,1;craftguide_fire.png]"
+		else
+			formspec = formspec..self:get_recipe(
+					iY, xoffset, tooltip_raw, data.item,
+					data.recipe_num, data.recipes_item)
+		end
+	end
+
+	data.formspec = formspec
+	show_formspec(player_name, "craftguide", formspec)
+end
+
+local function player_has_item(T)
+	for i=1, #T do
+		if T[i] then return true end
+	end
+end
+
+local function group_to_items(group)
+	local items_with_group, counter = {}, 0
+	for name, def in pairs(reg_items) do
+		if def.groups[group:sub(7)] then
+			counter = counter + 1
+			items_with_group[counter] = name
+		end
+	end
+	return items_with_group
+end
+
+local function item_in_inv(inv, item)
+	return inv:contains_item("main", item)
+end
+
+function craftguide:recipe_in_inv(inv, item_name, recipes_f)
+	local recipes = recipes_f or get_recipes(item_name) or {}
+	local show_item_recipes = {}
+
+	for i=1, #recipes do
+		show_item_recipes[i] = true
+		for _, item in pairs(recipes[i].items) do
+			local group_in_inv = false
+			if item:sub(1,6) == "group:" then
+				local groups = group_to_items(item)
+				for j=1, #groups do
+					if item_in_inv(inv, groups[j]) then
+						group_in_inv = true
+					end
+				end
+			end
+			if not group_in_inv and not item_in_inv(inv, item) then
+				show_item_recipes[i] = false
+			end
+		end
+	end
+	for i=#show_item_recipes, 1, -1 do
+		if not show_item_recipes[i] then
+			remove(recipes, i)
+		end
+	end
+
+	return recipes, player_has_item(show_item_recipes)
+end
+
+function craftguide:get_init_items()
+	local items_list, counter = {}, 0
+	for name, def in pairs(reg_items) do
+		local is_fuel = get_fueltime(name) > 0
+		local is_tool = def.type == "tool"
+		if (not def.groups.not_in_craft_guide or def.groups.not_in_craft_guide == 0)
+				and (get_recipe(name).items or is_fuel or is_tool)
+				and def.description and def.description ~= "" then
+			counter = counter + 1
+			items_list[counter] = name
+		end
+	end
+
+	sort(items_list)
+	datas.init_items = items_list
+end
+
+function craftguide:get_filter_items(data, player)
+	local filter = data.filter
+	local items_list = progressive_mode and data.init_filter_items or
+		datas.init_items
+	local inv = player:get_inventory()
+	local filtered_list, counter = {}, 0
+
+	for i=1, #items_list do
+		local item = items_list[i]
+		local item_desc = reg_items[item].description:lower()
+
+		if filter ~= "" then
+			if item:find(filter, 1, true) or
+					item_desc:find(filter, 1, true) then
+				counter = counter + 1
+				filtered_list[counter] = item
+			end
+		elseif progressive_mode then
+			local _, has_item = self:recipe_in_inv(inv, item)
+			if has_item then
+				counter = counter + 1
+				filtered_list[counter] = item
+			end
+		end
+	end
+
+	if progressive_mode and not data.items then
+		data.init_filter_items = filtered_list
+	end
+	data.items = filtered_list
+end
+
+mt.register_on_player_receive_fields(function(player, formname, fields)
+	if formname ~= "craftguide" then return end
+	local player_name = player:get_player_name()
+	local data = datas[player_name]
+
+	if fields.clear then
+		data.filter, data.item, data.pagenum, data.recipe_num =
+			"", nil, 1, 1
+		data.items = progressive_mode and data.init_filter_items or
+			datas.init_items
+		craftguide:get_formspec(player_name)
+	elseif fields.alternate then
+		local recipe = data.recipes_item[data.recipe_num + 1]
+		data.recipe_num = recipe and data.recipe_num + 1 or 1
+		craftguide:get_formspec(player_name)
+	elseif (fields.key_enter_field == "filter" or fields.search) and
+			fields.filter ~= "" then
+		data.filter = fields.filter:lower()
+		data.pagenum = 1
+		craftguide:get_filter_items(data, player)
+		craftguide:get_formspec(player_name)
+	elseif fields.prev or fields.next then
+		data.pagenum = data.pagenum - (fields.prev and 1 or -1)
+		if data.pagenum > data.pagemax then
+			data.pagenum = 1
+		elseif data.pagenum == 0 then
+			data.pagenum = data.pagemax
+		end
+		craftguide:get_formspec(player_name)
+	elseif (fields.size_inc and data.iX < 12) or
+			(fields.size_dec and data.iX > 8) then
+		data.pagenum = 1
+		data.iX = data.iX - (fields.size_dec and 1 or -1)
+		craftguide:get_formspec(player_name)
+	else for item in pairs(fields) do
+		if item:find(":") then
+			if item:sub(-4) == "_inv" or item:sub(-4) == "_out" then
+				item = item:sub(1,-5)
+			end
+
+			local recipes = get_recipes(item)
+			local is_fuel = get_fueltime(item) > 0
+			if not recipes and not is_fuel then return end
+
+			if progressive_mode then
+				local inv = player:get_inventory()
+				local _, has_item =
+					craftguide:recipe_in_inv(inv, item)
+
+				if not has_item then return end
+				recipes = craftguide:recipe_in_inv(
+							inv, item, recipes)
+			end
+
+			data.item = item
+			data.recipe_num = 1
+			data.recipes_item = recipes
+
+			craftguide:get_formspec(player_name, is_fuel)
+		end
+	     end
+	end
+end)
+
+function craftguide:on_use(user)
+	if not datas.init_items then
+		craftguide:get_init_items()
+	end
+
+	local player_name = user:get_player_name()
+	local data = datas[player_name]
+
+	if progressive_mode or not data then
+		datas[player_name] = {filter="", pagenum=1, iX=9}
+		if progressive_mode then
+			craftguide:get_filter_items(
+					datas[player_name], user)
+		end
+		craftguide:get_formspec(player_name)
+	else
+		show_formspec(player_name, "craftguide", data.formspec)
+	end
+end
+
+mcl_craftguide.show_craftguide = function(player)
+	craftguide:on_use(player)
+end
+
+mt.register_on_player_receive_fields(function(player, formname, fields)
+	if fields.__mcl_craftguide then
+		craftguide:on_use(player)
+	end
+end)

mods/HUD/mcl_craftguide/mod.conf

@@ -0,0 +1 @@
+name = mcl_craftguide