Update many help texts for misc. items

mods/ITEMS/mcl_boats/init.lua

@@ -144,6 +144,8 @@ for w=1, #woods do
 
 	minetest.register_craftitem("mcl_boats:boat"..woods[w], {
 		description = names[w],
+		_doc_items_longdesc = "Boats are used to travel on the surface of water.",
+		_doc_items_usagehelp = "Rightclick on a water source to place the boat. Rightclick the boat to enter it. Use [Left] and [Right] to steer, [Forwards] to speed up and [Backwards] to slow down or move backwards. Rightclick the boat again to leave it, punch the boat to collect it.",
 		inventory_image = "mcl_boats_"..images[w].."_boat.png",
 		liquids_pointable = true,
 		groups = { boat = 1, transport = 1},

mods/ITEMS/mcl_end/depends.txt

@@ -1,3 +1,4 @@
 mcl_sounds
 mcl_throwing
 mcl_util
+doc_items

mods/ITEMS/mcl_end/init.lua

@@ -1,6 +1,7 @@
 -- Nodes
 minetest.register_node("mcl_end:end_stone", {
 	description = "End Stone",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	tiles = {"mcl_end_end_stone.png"},
 	stack_max = 64,
 	groups = {pickaxey=1, building_block=1, material_stone=1},
@@ -11,6 +12,7 @@ minetest.register_node("mcl_end:end_stone", {
 
 minetest.register_node("mcl_end:end_bricks", {
 	description = "End Stone Bricks",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	tiles = {"mcl_end_end_bricks.png"},
 	is_ground_content = false,
 	stack_max = 64,
@@ -22,6 +24,7 @@ minetest.register_node("mcl_end:end_bricks", {
 
 minetest.register_node("mcl_end:purpur_block", {
 	description = "Purpur Block",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	tiles = {"mcl_end_purpur_block.png"},
 	is_ground_content = false,
 	stack_max = 64,
@@ -33,6 +36,7 @@ minetest.register_node("mcl_end:purpur_block", {
 
 minetest.register_node("mcl_end:purpur_pillar", {
 	description = "Purpur Pillar",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	stack_max = 64,
 	paramtype2 = "facedir",
 	is_ground_content = false,
@@ -121,6 +125,7 @@ minetest.register_node("mcl_end:end_rod", {
 
 minetest.register_node("mcl_end:dragon_egg", {
 	description = "Dragon Egg",
+	_doc_items_longdesc = "A dragon egg is a decorational item which can be placed.",
 	tiles = {
 		"mcl_end_dragon_egg.png",
 		"mcl_end_dragon_egg.png",
@@ -257,6 +262,7 @@ minetest.register_craftitem("mcl_end:chorus_fruit", {
 
 minetest.register_craftitem("mcl_end:chorus_fruit_popped", {
 	description = "Popped Chorus Fruit",
+	_doc_items_longdesc = doc.sub.items.temp.craftitem,
 	wield_image = "mcl_end_chorus_fruit_popped.png",
 	inventory_image = "mcl_end_chorus_fruit_popped.png",
 	groups = { craftitem = 1 },
@@ -265,6 +271,7 @@ minetest.register_craftitem("mcl_end:chorus_fruit_popped", {
 
 minetest.register_craftitem("mcl_end:ender_eye", {
 	description = "Eye of Ender",
+	_doc_items_longdesc = doc.sub.items.temp.craftitem,
 	wield_image = "mcl_end_ender_eye.png",
 	inventory_image = "mcl_end_ender_eye.png",
 	stack_max = 64,

mods/ITEMS/mcl_farming/wheat.lua

@@ -119,6 +119,8 @@ mcl_farming:add_plant("mcl_farming:wheat", {"mcl_farming:wheat_1", "mcl_farming:
 
 minetest.register_craftitem("mcl_farming:wheat_item", {
 	description = "Wheat",
+	_doc_items_longdesc = "Wheat is used in crafting. Some animals like wheat.",
+	_doc_items_usagehelp = "Rightclick an animal to try to feed it wheat.",
 	inventory_image = "farming_wheat_harvested.png",
 	groups = { craftitem = 1 },
 })

mods/ITEMS/mcl_mobitems/init.lua

@@ -156,7 +156,7 @@ minetest.register_craftitem("mcl_mobitems:bone", {
 
 minetest.register_craftitem("mcl_mobitems:string",{
 	description = "String",
-	_doc_items_usagehelp = "Strings are used in crafting.",
+	_doc_items_longdesc = "Strings are used in crafting.",
 	inventory_image = "mcl_mobitems_string.png",
 	stack_max = 64,
 	groups = { craftitem = 1 },
@@ -164,6 +164,7 @@ minetest.register_craftitem("mcl_mobitems:string",{
 
 minetest.register_craftitem("mcl_mobitems:blaze_rod", {
 	description = "Blaze Rod",
+	_doc_items_longdesc = "This is a crafting component dropped from dead blazes.",
 	wield_image = "mcl_mobitems_blaze_rod.png",
 	inventory_image = "mcl_mobitems_blaze_rod.png",
 	groups = { craftitem = 1 },
@@ -172,6 +173,7 @@ minetest.register_craftitem("mcl_mobitems:blaze_rod", {
 
 minetest.register_craftitem("mcl_mobitems:blaze_powder", {
 	description = "Blaze Powder",
+	_doc_items_longdesc = "This item is mainly used for brewing potions and crafting.",
 	wield_image = "mcl_mobitems_blaze_powder.png",
 	inventory_image = "mcl_mobitems_blaze_powder.png",
 	groups = { brewitem = 1 },
@@ -180,6 +182,7 @@ minetest.register_craftitem("mcl_mobitems:blaze_powder", {
 
 minetest.register_craftitem("mcl_mobitems:magma_cream", {
 	description = "Magma Cream",
+	_doc_items_longdesc = "Magma cream is a crafting component.",
 	wield_image = "mcl_mobitems_magma_cream.png",
 	inventory_image = "mcl_mobitems_magma_cream.png",
 	groups = { brewitem = 1 },
@@ -188,6 +191,7 @@ minetest.register_craftitem("mcl_mobitems:magma_cream", {
 
 minetest.register_craftitem("mcl_mobitems:ghast_tear", {
 	description = "Ghast Tear",
+	_doc_items_longdesc = "A ghast tear is an item used in potion brewing. It is dropped from dead ghasts.",
 	wield_image = "mcl_mobitems_ghast_tear.png",
 	inventory_image = "mcl_mobitems_ghast_tear.png",
 	groups = { brewitem = 1 },
@@ -196,6 +200,7 @@ minetest.register_craftitem("mcl_mobitems:ghast_tear", {
 
 minetest.register_craftitem("mcl_mobitems:nether_star", {
 	description = "Nether Star",
+	_doc_items_longdesc = "A nether star is a crafting component. It is dropped from the Wither.",
 	wield_image = "mcl_mobitems_nether_star.png",
 	inventory_image = "mcl_mobitems_nether_star.png",
 	groups = { craftitem = 1 },
@@ -204,6 +209,7 @@ minetest.register_craftitem("mcl_mobitems:nether_star", {
 
 minetest.register_craftitem("mcl_mobitems:leather", {
 	description = "Leather",
+	_doc_items_longdesc = "Leather is a versatile crafting component.",
 	wield_image = "mcl_mobitems_leather.png",
 	inventory_image = "mcl_mobitems_leather.png",
 	groups = { craftitem = 1 },
@@ -212,6 +218,7 @@ minetest.register_craftitem("mcl_mobitems:leather", {
 
 minetest.register_craftitem("mcl_mobitems:feather", {
 	description = "Feather",
+	_doc_items_longdesc = "Feathers are used in crafting and are dropped from chickens.",
 	wield_image = "mcl_mobitems_feather.png",
 	inventory_image = "mcl_mobitems_feather.png",
 	groups = { craftitem = 1 },
@@ -258,18 +265,21 @@ minetest.register_craftitem("mcl_mobitems:rabbit_stew", {
 
 minetest.register_craftitem("mcl_mobitems:shulker_shell", {
 	description = "Shulker Shell",
+	_doc_items_longdesc = "Shulker shells are used in crafting. They are dropped from dead shulkers.",
 	inventory_image = "mcl_mobitems_shulker_shell.png",
 	groups = { craftitem = 1 },
 })
 
 minetest.register_craftitem("mcl_mobitems:slimeball", {
 	description = "Slimeball",
+	_doc_items_longdesc = "Slimeballs are used in crafting. They are dropped from slimes.",
 	inventory_image = "mcl_mobitems_slimeball.png",
 	groups = { craftitem = 1 },
 })
 
 minetest.register_craftitem("mcl_mobitems:gunpowder", {
 	description = "Gunpowder",
+	_doc_items_longdesc = doc.sub.items.temp.craftitem,
 	inventory_image = "default_gunpowder.png",
 	stack_max = 64,
 	groups = { craftitem=1 },

mods/ITEMS/mcl_ocean/depends.txt

@@ -1,2 +1,3 @@
 mcl_sounds
 mcl_dye
+doc_items

mods/ITEMS/mcl_ocean/init.lua

@@ -24,6 +24,7 @@ minetest.register_node("mcl_ocean:sea_lantern", {
 
 minetest.register_node("mcl_ocean:prismarine", {
 	description = "Prismarine",
+	_doc_items_longdesc = "Prismarine is used as a building block. It slowly changes its color.",
 	stack_max = 64,
 	is_ground_content = false,
 	tiles = {{name="mcl_ocean_prismarine_anim.png", animation={type="vertical_frames", aspect_w=32, aspect_h=32, length=45.0}}},
@@ -35,6 +36,7 @@ minetest.register_node("mcl_ocean:prismarine", {
 
 minetest.register_node("mcl_ocean:prismarine_brick", {
 	description = "Prismarine Bricks",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	stack_max = 64,
 	is_ground_content = false,
 	tiles = {"mcl_ocean_prismarine_bricks.png"},
@@ -46,6 +48,7 @@ minetest.register_node("mcl_ocean:prismarine_brick", {
 
 minetest.register_node("mcl_ocean:prismarine_dark", {
 	description = "Dark Prismarine",
+	_doc_items_longdesc = doc.sub.items.temp.build,
 	stack_max = 64,
 	is_ground_content = false,
 	tiles = {"mcl_ocean_prismarine_dark.png"},
@@ -59,6 +62,7 @@ minetest.register_node("mcl_ocean:prismarine_dark", {
 
 minetest.register_craftitem("mcl_ocean:prismarine_crystals", {
 	description = "Prismarine Crystals",
+	_doc_items_longdesc = doc.sub.items.temp.craftitem,
 	inventory_image = "mcl_ocean_prismarine_crystals.png",
 	stack_max = 64,
 	groups = { craftitem = 1 },
@@ -66,6 +70,7 @@ minetest.register_craftitem("mcl_ocean:prismarine_crystals", {
 
 minetest.register_craftitem("mcl_ocean:prismarine_shard", {
 	description = "Prismarine Shard",
+	_doc_items_longdesc = doc.sub.items.temp.craftitem,
 	inventory_image = "mcl_ocean_prismarine_shard.png",
 	stack_max = 64,
 	groups = { craftitem = 1 },

mods/ITEMS/mcl_potions/init.lua

@@ -1,5 +1,8 @@
+local brewhelp = "This item is used in potion brewing."
+
 minetest.register_craftitem("mcl_potions:fermented_spider_eye", {
 	description = "Fermented Spider Eye",
+	_doc_items_longdesc = brewhelp,
 	wield_image = "mcl_potions_spider_eye_fermented.png",
 	inventory_image = "mcl_potions_spider_eye_fermented.png",
 	groups = { brewitem = 1 },
@@ -166,6 +169,7 @@ minetest.register_craftitem("mcl_potions:potion_thick", {
 
 minetest.register_craftitem("mcl_potions:speckled_melon", {
 	description = "Glistering Melon",
+	_doc_items_longdesc = brewhelp,
 	stack_max = 64,
 	groups = { brewitem = 1 },
 	inventory_image = "mcl_potions_melon_speckled.png",
@@ -182,6 +186,7 @@ minetest.register_craft({
 
 minetest.register_craftitem("mcl_potions:dragon_breath", {
 	description = "Dragon's Breath",
+	_doc_items_longdesc = brewhelp,
 	wield_image = "mcl_potions_dragon_breath.png",
 	inventory_image = "mcl_potions_dragon_breath.png",
 	groups = { brewitem = 1 },

mods/ITEMS/mcl_throwing/arrow.lua

@@ -1,6 +1,7 @@
 minetest.register_craftitem("mcl_throwing:arrow", {
 	description = "Arrow",
-	_doc_items_longdescs = "Arrows are ammunition for bows and dispensers.",
+	_doc_items_longdesc = "Arrows are ammunition for bows and dispensers.",
+	_doc_items_usagehelp = "To use arrows as ammunition for a bow, just put them anywhere in your inventory, they will be used up automatically. To use arrows as ammunition for a dispenser, place them in the dispenser's inventory.",
 	inventory_image = "mcl_throwing_arrow_inv.png",
 	groups = { ammo=1, ammo_bow=1 },
 })

mods/ITEMS/mcl_throwing/throwable.lua

@@ -189,9 +189,13 @@ minetest.register_entity("mcl_throwing:snowball_entity", snowball_ENTITY)
 minetest.register_entity("mcl_throwing:egg_entity", egg_ENTITY)
 minetest.register_entity("mcl_throwing:ender_pearl_entity", pearl_ENTITY)
 
+local how_to_throw = "Hold it in your and and leftclick to throw."
+
 -- Snowball
 minetest.register_craftitem("mcl_throwing:snowball", {
 	description = "Snowball",
+	_doc_items_longdesc = "Snowballs can be thrown or launched from a dispenser for fun. Hitting something with a snowball does nothing.",
+	_doc_items_usagehelp = how_to_throw,
 	inventory_image = "mcl_throwing_snowball.png",
 	stack_max = 16,
 	on_use = throw_function("mcl_throwing:snowball_entity"),
@@ -206,6 +210,8 @@ minetest.register_craftitem("mcl_throwing:snowball", {
 -- Egg
 minetest.register_craftitem("mcl_throwing:egg", {
 	description = "Egg",
+	_doc_items_longdesc = "Eggs can be thrown or launched from a dispenser and breaks on impact. There is a small chance that 1 or even 4 chickens will pop out of the egg when it hits the ground.",
+	_doc_items_usagehelp = how_to_throw,
 	inventory_image = "mcl_throwing_egg.png",
 	stack_max = 16,
 	on_use = throw_function("mcl_throwing:egg_entity"),
@@ -215,6 +221,8 @@ minetest.register_craftitem("mcl_throwing:egg", {
 -- Ender Pearl
 minetest.register_craftitem("mcl_throwing:ender_pearl", {
 	description = "Ender Pearl",
+	_doc_items_longdesc = "An ender pearl is an item which can be used for teleportation at the cost of health. It can be thrown and teleport the thrower to its impact location when it hits a block. Each teleportation hurts the user by 5 hit points.",
+	_doc_items_usagehelp = how_to_throw,
 	wield_image = "mcl_throwing_ender_pearl.png",
 	inventory_image = "mcl_throwing_ender_pearl.png",
 	stack_max = 16,