musttest_game/mods/afk_removal/init.lua

afk_removal = afk_removal or {}
afk_removal.players = afk_removal.players or {}
afk_removal.modpath = minetest.get_modpath("afk_removal")
afk_removal.steptime = 5
afk_removal.timeout = 60 * 30
afk_removal.warntime = 60 * 29
afk_removal.disable_kick = minetest.is_singleplayer()



-- Public API function.
-- This should be called from any mod that wishes to reset the kick timeout for a player.
-- For example, a chat mod may call this when a player chats.
afk_removal.reset_timeout = function(name)
	-- localize
	local players = afk_removal.players

	-- Ensure an entry exists for this name.
	local data = players[name]
	if not data then
		players[name] = {time=0, pos={x=0, y=0, z=0}}
		data = players[name]
	end

	data.time = 0
	data.afk = nil
end



function afk_removal.on_joinplayer(player)
	local name = player:get_player_name()
	afk_removal.players[name] = {time=0, pos=player:get_pos()}
end

function afk_removal.on_leaveplayer(player, timedout)
	local pname = player:get_player_name()
	afk_removal.players[pname] = nil
end



-- API function to query whether a player is currently AFK.
-- Note that this only has meaning for registered players.
-- Unregistered players are kicked, so you generally won't encounter those.
function afk_removal.is_afk(pname)
	local p = afk_removal.players
	local o = p[pname]
	if o then
		if o.afk then
			return true
		end
	end
	return false
end

-- Returns the number of seconds since player's last action.
-- Returns -1 if player data is not available (wrong player name?).
function afk_removal.seconds_since_action(pname)
	local p = afk_removal.players
	local o = p[pname]
	if o then
		return o.time
	end
	return -1
end



afk_removal.update = function()
  local allplayers = minetest.get_connected_players()
  for k, player in ipairs(allplayers) do
    local name = player:get_player_name()
		local target = afk_removal.players[name]
    
		local pos = vector.round(player:getpos())
		local dist = vector.distance(pos, target.pos)
		local nokick = false

    if afk_removal.disable_kick or minetest.check_player_privs(name, {canafk=true}) then
			nokick = true
    end

		if dist > 0.5 then
			target.pos = pos
			target.time = 0
			target.afk = nil
		else
			-- Increase time since AFK started.
			local time = target.time
			time = time + afk_removal.steptime
			target.time = time

			if not nokick and time >= afk_removal.warntime then
				-- Only ignore players who are registered and NOT dead.
				if player:get_hp() > 0 and passport.player_registered(name) then
					-- If player is registered and NOT dead, don't send message.
					nokick = true
				else
					local remain = afk_removal.timeout - time
					minetest.chat_send_player(name, "# Server: You will be kicked for inactivity in " .. math.floor(remain) .. " seconds.")
					easyvend.sound_error(name)
				end
			end
		end

		-- Kick players who have done nothing for too long.
		if target.time >= afk_removal.timeout then
			if nokick then
				-- If player is registered and NOT dead, then just mark them as AFK.
				-- If player is registered but dead, they'll be kicked anyway.
				target.afk = true
			else
				minetest.kick_player(name, "Kicked for inactivity.")
				local dname = rename.gpn(name)
				minetest.chat_send_all("# Server: <" .. dname .. "> was kicked for being AFK too long.")
			end
		end
  end
end



local timer = 0
local delay = afk_removal.steptime
function afk_removal.globalstep(dtime)
	timer = timer + dtime
	if timer < delay then return end
	timer = 0
	afk_removal.update()
end



function afk_removal.on_craft(itemstack, player, old_craft_grid, craft_inv)
	if not player then return end
	if not player:is_player() then return end
	
	-- Ensure this player has an entry in the table.
	local name = player:get_player_name()
	if not afk_removal.players[name] then
			afk_removal.players[name] = {time=0, pos={x=0, y=0, z=0}}
	end
	
	afk_removal.players[name].time = 0
end



local function toggle_status(name)
	if not afk_removal.players[name] then
		return
	end

	if afk_removal.players[name].afk then
		afk_removal.players[name].afk = nil
		minetest.chat_send_player(name, "# Server: You're no longer AFK.")
	else
		afk_removal.players[name].afk = true
		minetest.chat_send_player(name, "# Server: You've gone AFK!")
	end
end



function afk_removal.do_afk(name, param)
	if param ~= "" then
		local pname = rename.grn(param)
		if afk_removal.is_afk(pname) then
			minetest.chat_send_player(name, "# Server: <" .. rename.gpn(pname) .. "> is AFK!")
		else
			if minetest.get_player_by_name(pname) then
				local time = afk_removal.seconds_since_action(pname)
				if time < 60 then
					minetest.chat_send_player(name, "# Server: <" .. rename.gpn(pname) .. "> is active.")
				elseif time < 60*2 then
					minetest.chat_send_player(name, "# Server: <" .. rename.gpn(pname) .. "> might be AFK.")
				else
					minetest.chat_send_player(name, "# Server: <" .. rename.gpn(pname) .. "> is probably AFK.")
				end
			else
				minetest.chat_send_player(name, "# Server: <" .. param .. "> is not online.")
			end
		end
	else
		minetest.after(0, toggle_status, name)
	end
end



if not afk_removal.registered then
	-- Crafting resets the player's AFK timeout.
	minetest.register_on_craft(function(...)
		return afk_removal.on_craft(...)
	end)
	
	minetest.register_globalstep(function(...)
		return afk_removal.globalstep(...)
	end)

	minetest.register_privilege("canafk", {
		description = "Player can remain AFK without being kicked.", 
		give_to_singleplayer = false,
	})

	minetest.register_on_joinplayer(function(...)
		return afk_removal.on_joinplayer(...)
	end)

	minetest.register_on_leaveplayer(function(...)
		return afk_removal.on_leaveplayer(...)
	end)

	minetest.register_chatcommand("afk", {
		params = "[name]",
		description = "Query whether another player is AFK, or toggle your own AFK status.",
		privs = {interact=true},
		func = function(...)
			afk_removal.do_afk(...)
			return true
		end,
	})

	local c = "afk_removal:core"
	local f = afk_removal.modpath .. "/init.lua"
	reload.register_file(c, f, false)

	afk_removal.registered = true
end