ambience/init.lua

ambience = {}

-- override default water sounds
minetest.override_item("default:water_source", { sounds = {} })
minetest.override_item("default:water_flowing", { sounds = {} })
minetest.override_item("default:river_water_source", { sounds = {} })
minetest.override_item("default:river_water_flowing", { sounds = {} })

-- settings
local SOUNDVOLUME = 1.0
local MUSICVOLUME = 1.0
local play_music = minetest.settings:get_bool("ambience_music") ~= false
local pplus = minetest.get_modpath("playerplus")
local radius = 6
local playing = {}
local sound_sets = {} -- all the sounds and their settings
local sound_set_order = {} -- needed because pairs loops randomly through tables
local set_nodes = {} -- all the nodes needed for sets


-- global functions
ambience.add_set = function(set_name, def)

	if set_name and def then

		sound_sets[set_name] = {
			frequency = def.frequency or 50,
			sounds = def.sounds,
			sound_check = def.sound_check,
			nodes = def.nodes,
		}

		-- add set name to the sound_set_order table
		local can_add = true

		for i = 1, #sound_set_order do

			if sound_set_order[i] == set_name then
				can_add = false
			end
		end

		if can_add then
			table.insert(sound_set_order, set_name)
		end

		-- add any missing nodes to the set_nodes table
		if def.nodes then

			for i = 1, #def.nodes do

				can_add = def.nodes[i]

				for j = 1, #set_nodes do

					if def.nodes[i] == set_nodes[j] then
						can_add = false
					end
				end

				if can_add then
					table.insert(set_nodes, can_add)
				end
			end
		end
	end
end


ambience.get_set = function(set_name)

	if sound_sets[set_name] then
		return sound_sets[set_name]
	end
end


ambience.del_set = function(set_name)

	sound_sets[set_name] = nil

	local can_del = false

	for i = 1, #sound_set_order do

		if sound_set_order[i] == set_name then
			can_del = i
		end
	end

	if can_del then
		table.remove(sound_set_order, can_del)
	end
end


-- plays music and selects sound set
local get_ambience = function(player, tod, name)

	-- play server or local music if available
	if play_music and playing[name] then

		-- play at midnight
		if tod >= 0.0 and tod <= 0.01 then

			if not playing[name].music then

				playing[name].music = minetest.sound_play("ambience_music", {
					to_player = player:get_player_name(),
					gain = MUSICVOLUME
				})
			end

		elseif tod > 0.1 and playing[name].music then

			playing[name].music = nil
		end
	end


	-- get foot and head level nodes at player position
	local pos = player:get_pos()

	pos.y = pos.y + 1.4 -- head level

	local nod_head = pplus and playerplus[name].nod_head or minetest.get_node(pos).name

	pos.y = pos.y - 1.2 -- foot level

	local nod_feet = pplus and playerplus[name].nod_feet or minetest.get_node(pos).name

	pos.y = pos.y - 0.2 -- reset pos


	-- get all set nodes around player
	local ps, cn = minetest.find_nodes_in_area(
		{x = pos.x - radius, y = pos.y - radius, z = pos.z - radius},
		{x = pos.x + radius, y = pos.y + radius, z = pos.z + radius}, set_nodes)

	-- loop through sets in order and choose one that meets it's conditions
	for n = 1, #sound_set_order do

		local set = sound_sets[ sound_set_order[n] ]

		if set and set.sound_check then

			local set_name, gain = set.sound_check({
				player = player,
				pos = pos,
				tod = tod,
				totals = cn,
				positions = ps,
				head_node = nod_head,
				feet_node = nod_feet
			})

			if set_name then
				return set_name, gain
			end
		end
	end
end


local timer = 0
local random = math.random

-- player routine
minetest.register_globalstep(function(dtime)

	-- every 1 second
	timer = timer + dtime
	if timer < 1 then return end
	timer = 0

	local players = minetest.get_connected_players()
	local player_name, number, chance, ambience, handler
	local tod = minetest.get_timeofday()

	for n = 1, #players do

		player_name = players[n]:get_player_name()

--local t1 = os.clock()

		local set_name, MORE_GAIN = get_ambience(players[n], tod, player_name)

--print(string.format("elapsed time: %.4f\n", os.clock() - t1))

		if set_name then

			-- stop sound if another set active
			if playing[player_name]
			and playing[player_name].handler then

				if playing[player_name].sound ~= set_name
				or (playing[player_name].sound == set_name
				and playing[player_name].gain ~= MORE_GAIN) then

					minetest.sound_stop(playing[player_name].handler)

					playing[player_name].sound = nil
					playing[player_name].handler = nil
					playing[player_name].gain = nil
				else
					return
				end
			end

			-- choose random sound from set selected
			number = random(1, #sound_sets[set_name].sounds)
			ambience = sound_sets[set_name].sounds[number]

			math.randomseed(tod + number)

			chance = random(1, 1000)

			if chance < sound_sets[set_name].frequency then

				handler = minetest.sound_play(ambience.name, {
					to_player = player_name,
					gain = ((ambience.gain or 0.3) + (MORE_GAIN or 0)) * SOUNDVOLUME
				})

--print ("playing... " .. ambience.name .. " (" .. chance .. " < "
--		.. sound_sets[set_name].frequency .. ") @ ", MORE_GAIN)

				if handler then

					playing[player_name] = playing[player_name] or {}
					playing[player_name].handler = handler
					playing[player_name].sound = set_name
					playing[player_name].gain = MORE_GAIN

					minetest.after(ambience.length, function(args)

						local player_name = args[2]

						if playing[player_name]
						and playing[player_name].handler
						and playing[player_name].sound == set_name then

							minetest.sound_stop(playing[player_name].handler)

							playing[player_name].sound = nil
							playing[player_name].handler = nil
							playing[player_name].gain = nil
						end

					end, {ambience, player_name})
				end
			end
		end
	end
end)


-- set volume commands
minetest.register_chatcommand("svol", {
	params = "<svol>",
	description = "set sound volume (0.1 to 1.0)",
	privs = {server = true},

	func = function(name, param)

		SOUNDVOLUME = tonumber(param) or SOUNDVOLUME

		if SOUNDVOLUME < 0.1 then SOUNDVOLUME = 0.1 end
		if SOUNDVOLUME > 1.0 then SOUNDVOLUME = 1.0 end

		return true, "Sound volume set to " .. SOUNDVOLUME
	end,
})


minetest.register_chatcommand("mvol", {
	params = "<mvol>",
	description = "set music volume (0.1 to 1.0)",
	privs = {server = true},

	func = function(name, param)

		MUSICVOLUME = tonumber(param) or MUSICVOLUME

		-- ability to stop music just as it begins
		if MUSICVOLUME == 0 and playing[name].music then
			minetest.sound_stop(playing[name].music)
		end

		if MUSICVOLUME < 0.1 then MUSICVOLUME = 0.1 end
		if MUSICVOLUME > 1.0 then MUSICVOLUME = 1.0 end

		return true, "Music volume set to " .. MUSICVOLUME
	end,
})


-- load default sound sets
dofile(minetest.get_modpath("ambience") .. "/soundsets.lua")


print("[MOD] Ambience Lite loaded")