VoxeLibre/mods/ITEMS/mcl_ocean/kelp.lua

-- TODO: whenever it becomes possible to fully implement kelp without the
-- plantlike_rooted limitation, please adapt the code accordingly.
--
-- TODO: In MC, you can't actually destroy kelp by bucket'ing water in the middle.
-- However, because of the plantlike_rooted hack, we'll just allow it for now.
--
-- TODO: Currently, you lose kelp if the kelp is placed on a block and then falls.
-- This is most relevant for (red)sand and gravel.

local S = minetest.get_translator("mcl_ocean")
local mod_doc = minetest.get_modpath("doc") ~= nil

--------------------------------------------------------------------------------
-- local-ify runtime functions
--------------------------------------------------------------------------------
-- objects
local registered_items = minetest.registered_items
local registered_nodes = minetest.registered_nodes

-- functions
local mt_get_item_group = minetest.get_item_group
local mt_get_node = minetest.get_node
local mt_set_node = minetest.set_node
local mt_add_item = minetest.add_item
local mt_sound_play = minetest.sound_play
local mt_is_creative_enabled = minetest.is_creative_enabled
local mt_is_protected = minetest.is_protected
local mt_hash_node_position = minetest.hash_node_position
local mt_get_node_timer = minetest.get_node_timer

-- DEBUG: functions
local log = minetest.log
local chatlog = minetest.chat_send_all

--------------------------------------------------------------------------------
-- Kelp API
--------------------------------------------------------------------------------

kelp = {}

-- Is this water?
-- Returns the liquidtype, if indeed water.
local function is_submerged(node, nodedef)
	if mt_get_item_group(node.name, "water") ~= 0 then
		return nodedef.liquidtype -- Expected only "source" and "flowing" from water liquids
	end
	return false
end
kelp.is_submerged = is_submerged


-- Is the water downward flowing?
-- (kelp can grow/be placed inside downward flowing water)
local function is_downward_flowing(pos, node, nodedef, is_above)
	local result = (math.floor(node.param2 / 8) % 2) == 1
	if not (result or is_above) then
		-- If not, also check node above.
		-- (this is needed due a weird quirk in the definition of "downwards flowing"
		-- liquids in Minetest)
		local node_above = mt_get_node({x=pos.x,y=pos.y+1,z=pos.z})
		local nodedef_above = registered_nodes[node_above.name]
		result = is_submerged(node_above, nodedef_above)
			or is_downward_flowing(pos, node_above, nodedef_above, true)
	end
	return result
end
kelp.is_downward_flowing = is_downward_flowing


-- Converts param2 to kelp height.
local function get_height(param2)
	return math.floor(param2 / 16)
end
kelp.get_height = get_height


-- Obtain pos and node of the top of kelp.
local function get_tip(pos, node)
	local size = math.ceil(node.param2 / 16)
	local pos_top = table.copy(pos)
	pos_top.y = pos_top.y + size
	return pos_top, mt_get_node(pos_top)
end
kelp.get_tip = get_tip


-- Obtain position of the first kelp unsubmerged.
local function find_unsubmerged(pos, node)
	local x,y,z = pos.x, pos.y, pos.z
	local height = get_height(node.param2)
	for i=1,height do
		local walk_pos = {x=x, y=y + i, z=z}
		if mt_get_item_group(mt_get_node(walk_pos).name, "water") == 0 then
			return walk_pos
		end
	end
	return nil
end
kelp.find_unsubmerged = find_unsubmerged


-- Obtain next param2.
local function next_param2(param2)
	local old_param2 = param2
	param2 = param2+16 - param2 % 16
	return param2, param2 ~= old_param2
end
kelp.next_param2 = next_param2


-- Grow next kelp.
local function next_grow(pos, node, pos_top, def_top, is_downward_flowing)
	-- Liquid source: Grow normally.
	mt_set_node(pos, node)

	-- Flowing liquid: Grow 1 step, but also turn the top node into a liquid source.
	if is_downward_flowing then
		local alt_liq = def_top.liquid_alternative_source
		if alt_liq then
			mt_set_node(pos_top, {name=alt_liq})
		end
	end
end
kelp.next_grow = next_grow


-- Drops the items for detached kelps.
local function detach_drop(pos, height)
	local x,y,z = pos.x,pos.y,pos.z
	for i=1,height do
		mt_add_item({x=x, y=y+i, z=z}, "mcl_ocean:kelp")
	end
end
kelp.detach_drop = detach_drop


-- Detach the kelp at dig_pos, and drop their items.
-- Synonymous to digging the kelp.
-- NOTE: this is intended for whenever kelp truly becomes segmented plants
-- instead of rooted to the floor. Don't try to remove dig_pos.
local function detach_dig(dig_pos, pos, node, is_drop)
	local param2 = node.param2
	-- pos.y points to the surface, offset needed to point to the first kelp.
	local new_height = dig_pos.y - (pos.y+1)

	-- Digs the entire kelp: invoke after_dig_node to mt_set_node.
	if new_height <= 0 then
		if is_drop then
			detach_drop(dig_pos, get_height(param2))
		end
		mt_set_node(pos, {
			name=registered_nodes[node.name].node_dig_prediction,
			param=node.param, param2=0 })

	-- Digs the kelp beginning at a height
	else
		if is_drop then
			detach_drop(dig_pos, get_height(param2) - new_height)
		end
		mt_set_node(pos, {name=node.name, param=node.param, param2=16*new_height})
	end
end
kelp.detach_dig = detach_dig

--------------------------------------------------------------------------------
-- Kelp callback functions
--------------------------------------------------------------------------------

local function surface_on_dig(pos, node, digger)
	-- NOTE: if instead, kelp shouldn't drop in creative: use this instead
	-- detach_dig(pos, pos, node,
	-- 	not (digger and mt_is_creative_enabled(digger:get_player_name())))
	detach_dig(pos, pos, node, true)
end
kelp.surface_on_dig = surface_on_dig


local function surface_after_dig_node(pos, node)
	return mt_set_node(pos, {name=registred_nodes[node.name].node_dig_prediction})
end
kelp.surface_after_dig_node = surface_after_dig_node


local kelp_timers = {}
local kelp_timers_counter = 0
local function surface_on_timer(pos, elapsed)
	local node = mt_get_node(pos)
	local dig_pos = find_unsubmerged(pos, node)
	if dig_pos then
		detach_dig(dig_pos, pos, node, true)
	end
	return true
end


-- NOTE: Uncomment this to use ABMs
-- local function surface_unsubmerged_abm(pos, node)
-- 	local dig_pos = find_unsubmerged(pos, node)
-- 	if dig_pos then
-- 		detach_dig(dig_pos, pos, node, true)
-- 	end
-- 	return true
-- end


-- NOTE: Uncomment this to use nodetimers
local function surface_register_nodetimer(pos, node)
	local pos_hash = mt_hash_node_position(pos)
	if kelp_timers[pos_hash] then
		return
	end
	local timer = mt_get_node_timer(pos)
	kelp_timers[pos_hash] = timer
	timer:start(0.5)
	kelp_timers_counter = kelp_timers_counter + 1
	chatlog("added a timer. Currently " ..tostring(kelp_timers_counter) .." timers")
end
kelp.surface_register_nodetiemr = surface_register_nodetimer


local function grow_kelp(pos, node)
	local grow
	-- Grow kelp by 1 node length if it would grow inside water
	node.param2, grow = next_param2(node.param2)
	local pos_top, node_top = get_tip(pos, node)
	local def_top = registered_nodes[node_top.name]
	if grow and is_submerged(node_top, def_top) then
		next_grow(pos, node, pos_top, def_top,
			is_downward_flowing(pos_top, node_top, def_top))
	end
end
kelp.grow_kelp = grow_kelp


local function kelp_on_place(itemstack, placer, pointed_thing)
	if pointed_thing.type ~= "node" or not placer then
		return itemstack
	end

	local player_name = placer:get_player_name()
	local pos_under = pointed_thing.under
	local pos_above = pointed_thing.above
	local node_under = mt_get_node(pos_under)
	local nu_name = node_under.name
	local def_under = registered_nodes[nu_name]

	-- Allow rightclick override.
	if def_under and def_under.on_rightclick and not placer:get_player_control().sneak then
		return def_under.on_rightclick(pos_under, node_under,
				placer, itemstack, pointed_thing) or itemstack
	end

	if mt_is_protected(pos_under, player_name) or
			mt_is_protected(pos_above, player_name) then
		minetest.log("action", player_name
			.. " tried to place " .. itemstack:get_name()
			.. " at protected position "
			.. minetest.pos_to_string(pos_under))
		minetest.record_protection_violation(pos_under, player_name)
		return itemstack
	end

	local new_kelp = false
	local downward_flowing = false
	local pos_top, node_top, def_top

	-- When placed on kelp.
	if mt_get_item_group(nu_name, "kelp") == 1 then
		node_under.param2, new_kelp = next_param2(node_under.param2)
		-- Kelp must not reach the height limit.
		-- Kelp must also be placed on top of kelp to add kelp.
		if not new_kelp or pos_under.y >= pos_above.y then
			return itemstack
		end
		pos_top, node_top = get_tip(pos_under, node_under)
		def_top = registered_nodes[node_top.name]

	-- When placed on surface.
	else
		local surfaces = kelp.surfaces or surfaces
		for _,surface in pairs(surfaces) do
			-- Surface must support kelp
			if nu_name == surface.nodename then
				node_under.name = "mcl_ocean:kelp_" ..surface.name
				node_under.param2 = registered_items[nu_name].place_param2 or 16
				new_kelp = true
				break
			end
		end

		-- Kelp must also be placed on top of surface to add new kelp.
		if not new_kelp or pos_under.y >= pos_above.y then
			return itemstack
		end

		pos_top = pos_above
		node_top = mt_get_node(pos_above)
		def_top = registered_nodes[node_top.name]

		-- NOTE: Uncomment this to use nodetimers
		-- Register nodetimer
		surface_register_nodetimer(pos_under, node_under)
	end

	-- New kelp must also be submerged in water.
	downward_flowing = is_downward_flowing(pos_top, node_top, def_top)
	if not (is_submerged(node_top, def_top) or downward_flowing) then
		return itemstack
	end

	-- Play sound, place surface/kelp and take away an item
	local def_node = registered_items[nu_name]
	if def_node.sounds then
		mt_sound_play(def_node.sounds.place, { gain = 0.5, pos = pos_under }, true)
	end
	next_grow(pos_under, node_under, pos_top, def_top, downward_flowing)
	if not mt_is_creative_enabled(player_name) then
		itemstack:take_item()
	end

	return itemstack
end
kelp.kelp_on_place = kelp_on_place

--------------------------------------------------------------------------------
-- Kelp registration API
--------------------------------------------------------------------------------

-- List of supported surfaces for seagrass and kelp.
local surfaces = {
	{ name="dirt",    nodename="mcl_core:dirt",    },
	{ name="sand",    nodename="mcl_core:sand",    },
	{ name="redsand", nodename="mcl_core:redsand", },
	{ name="gravel",  nodename="mcl_core:gravel",  },
}
kelp.surfaces = surfaces
local registered_surfaces = {}
kelp.registered_surfaces = registered_surfaces

-- Commented properties are the ones obtained using register_kelp_surface.
-- If you define your own properties, it overrides the default ones.
local surface_deftemplate = {
	drawtype = "plantlike_rooted",
	paramtype = "light",
	paramtype2 = "leveled",
	place_param2 = 16,
	--tiles = def.tiles,
	special_tiles = {
		{
		image = "mcl_ocean_kelp_plant.png",
		animation = {type="vertical_frames", aspect_w=16, aspect_h=16, length=2.0},
		tileable_vertical = true,
		}
	},
	--inventory_image = "("..def.tiles[1]..")^mcl_ocean_kelp_item.png",
	wield_image = "mcl_ocean_kelp_item.png",
	selection_box = {
		type = "fixed",
		fixed = {
			{ -0.5, -0.5, -0.5, 0.5, 0.5, 0.5 },
			{ -0.5, 0.5, -0.5, 0.5, 1.5, 0.5 },
		},
	},
	-- groups.falling_node = is_falling,
	groups = { dig_immediate = 3, deco_block = 1, plant = 1, kelp = 1, },
	--sounds = sounds,
	--node_dig_prediction = nodename,
	after_dig_node = surface_after_dig_node,
	on_dig = surface_on_dig,
	on_timer = surface_on_timer,
	drop = "", -- drops are handled in on_dig
	--_mcl_falling_node_alternative = is_falling and nodename or nil,
	_mcl_hardness = 0,
	_mcl_blast_resistance = 0,
}
kelp.surface_deftemplate = surface_deftemplate

-- Commented properties are the ones obtained using register_kelp_surface.
local surface_docs = {
	-- entry_id_orig = nodename,
	_doc_items_entry_name = S("Kelp"),
	_doc_items_longdesc = S("Kelp grows inside water on top of dirt, sand or gravel."),
	--_doc_items_create_entry = doc_create,
	_doc_items_image = "mcl_ocean_kelp_item.png",
}
kelp.surface_docs = surface_docs

--[==[--
register_kelp_surface(surface[, surface_deftemplate[, surface_docs]])

surface: table with its specific properties. See also kelp.surface.

surface_deftemplate: modifiable nodedef template. See also kelp.surface_deftempate.
DO NOT RE-USE THE SAME DEFTEMPLATE. create copies.

surface_docs: table with properties related to docs. See also kelp.surface_docs.
--]==]--
local leaf_sounds = mcl_sounds.node_sound_leaves_defaults()
local function register_kelp_surface(surface, surface_deftemplate, surface_docs)
	local name = surface.name
	local nodename = surface.nodename
	local def = registered_nodes[nodename]
	local def_tiles = def.tiles

	local surfacename = "mcl_ocean:kelp_"..name
	local surface_deftemplate = surface_deftemplate or kelp.surface_deftemplate -- optional param

	local doc_create = surface.doc_create or false
	local surface_docs = surface_docs or kelp.surface_docs

	if doc_create then
		surface_deftemplate._doc_items_entry_name = surface_docs._doc_items_entry_name
		surface_deftemplate._doc_items_longdesc = surface_docs._doc_items_longdesc
		surface_deftemplate._doc_items_create_entry = true
		surface_deftemplate._doc_items_image = surface_docs._doc_items_image
		-- Takes the first surface with docs
		if not surface_docs.entry_id_orig then
			surface_docs.entry_id_orig = nodename
		end
	elseif mod_doc then
		doc.add_entry_alias("nodes", surface_docs.entry_id_orig, "nodes", surfacename)
	end

	local sounds = table.copy(def.sounds)
	sounds.dig = leaf_sounds.dig
	sounds.dug = leaf_sounds.dug
	sounds.place = leaf_sounds.place

	surface_deftemplate.tiles = surface_deftemplate.tiles or def_tiles
	surface_deftemplate.inventory_image = surface_deftemplate.inventory_image or "("..def_tiles[1]..")^mcl_ocean_kelp_item.png"
	surface_deftemplate.sounds = surface_deftemplate.sound or sounds
	local falling_node = mt_get_item_group(nodename, "falling_node")
	surface_deftemplate.node_dig_prediction = surface_deftemplate.node_dig_prediction or nodename
	surface_deftemplate.groups.falling_node = surface_deftemplate.groups.falling_node or falling_node
	surface_deftemplate._mcl_falling_node_alternative = surface_deftemplate._mcl_falling_node_alternative or (falling_node and nodename or nil)

	minetest.register_node(surfacename, surface_deftemplate)
end

-- Kelp surfaces nodes ---------------------------------------------------------

-- Dirt must be registered first, for the docs
register_kelp_surface(surfaces[1], table.copy(surface_deftemplate), surface_docs)
for i=2, #surfaces do
	register_kelp_surface(surfaces[i], table.copy(surface_deftemplate), surface_docs)
end

-- Kelp item -------------------------------------------------------------------

minetest.register_craftitem("mcl_ocean:kelp", {
	description = S("Kelp"),
	_tt_help = S("Grows in water on dirt, sand, gravel"),
	_doc_items_create_entry = false,
	inventory_image = "mcl_ocean_kelp_item.png",
	wield_image = "mcl_ocean_kelp_item.png",
	on_place = kelp_on_place,
	groups = { deco_block = 1 },
})

if mod_doc then
	doc.add_entry_alias("nodes", surface_docs.entry_id_orig, "craftitems", "mcl_ocean:kelp")
end

-- Dried kelp ------------------------------------------------------------------

-- TODO: This is supposed to be eaten very fast
minetest.register_craftitem("mcl_ocean:dried_kelp", {
	description = S("Dried Kelp"),
	_doc_items_longdesc = S("Dried kelp is a food item."),
	inventory_image = "mcl_ocean_dried_kelp.png",
	wield_image = "mcl_ocean_dried_kelp.png",
	groups = { food = 2, eatable = 1 },
	on_place = minetest.item_eat(1),
	on_secondary_use = minetest.item_eat(1),
	groups = { food = 2, eatable = 1 },
	_mcl_saturation = 0.6,
})


local mod_screwdriver = minetest.get_modpath("screwdriver") ~= nil
local on_rotate
if mod_screwdriver then
	on_rotate = screwdriver.rotate_3way
end

minetest.register_node("mcl_ocean:dried_kelp_block", {
	description = S("Dried Kelp Block"),
	_doc_items_longdesc = S("A decorative block that serves as a great furnace fuel."),
	tiles = { "mcl_ocean_dried_kelp_top.png", "mcl_ocean_dried_kelp_bottom.png", "mcl_ocean_dried_kelp_side.png" },
	groups = { handy = 1, building_block = 1, flammable = 2, fire_encouragement = 30, fire_flammability = 60 },
	sounds = mcl_sounds.node_sound_leaves_defaults(),
	paramtype2 = "facedir",
	on_place = mcl_util.rotate_axis,
	on_rotate = on_rotate,
	_mcl_hardness = 0.5,
	_mcl_blast_resistance = 12.5,
})

minetest.register_craft({
	type = "cooking",
	recipe = "mcl_ocean:kelp",
	output = "mcl_ocean:dried_kelp",
	cooktime = 10,
})
minetest.register_craft({
	recipe = {
		{ "mcl_ocean:dried_kelp","mcl_ocean:dried_kelp","mcl_ocean:dried_kelp" },
		{ "mcl_ocean:dried_kelp","mcl_ocean:dried_kelp","mcl_ocean:dried_kelp" },
		{ "mcl_ocean:dried_kelp","mcl_ocean:dried_kelp","mcl_ocean:dried_kelp" },
	},
	output = "mcl_ocean:dried_kelp_block",
})
minetest.register_craft({
	recipe = {
		{ "mcl_ocean:dried_kelp_block" },
	},
	output = "mcl_ocean:dried_kelp 9",
})
minetest.register_craft({
	type = "fuel",
	recipe = "mcl_ocean:dried_kelp_block",
	burntime = 200,
})

-- ABMs ------------------------------------------------------------------------
minetest.register_abm({
	label = "Kelp growth",
	nodenames = { "group:kelp" },
	interval = 45,
	chance = 12,
	catch_up = false,
	action = grow_kelp,
})

-- NOTE: Uncomment this to use nodetimers
minetest.register_lbm({
	label = "Kelp timer registration",
	name = "mcl_ocean:kelp_timer_registration",
	nodenames = { "group:kelp" },
	run_at_every_load = false,
	action = surface_register_nodetimer,
})

-- NOTE: Uncomment this to use ABMs
-- Break kelp not underwater.
-- minetest.register_abm({
-- 	label = "Kelp drops",
-- 	nodenames = { "group:kelp" },
-- 	interval = 1.0,
-- 	chance = 1,
-- 	catch_up = false,
-- 	action = surface_unsubmerged_abm,
-- })