]> git.lizzy.rs Git - dragonfireclient.git/blobdiff - builtin/game/misc.lua
Revise dynamic_add_media API to better accomodate future changes
[dragonfireclient.git] / builtin / game / misc.lua
index 618d4d97ff4c1cc6b8b230fd37745576ad43a1a9..b8c5e16a9ab5730cd611841dd426bca12cd88c95 100644 (file)
@@ -5,12 +5,11 @@
 --
 
 function core.check_player_privs(name, ...)
-       local arg_type = type(name)
-       if (arg_type == "userdata" or arg_type == "table") and
-                       name.get_player_name then -- If it quacks like a Player...
+       if core.is_player(name) then
                name = name:get_player_name()
-       elseif arg_type ~= "string" then
-               error("Invalid core.check_player_privs argument type: " .. arg_type, 2)
+       elseif type(name) ~= "string" then
+               error("core.check_player_privs expects a player or playername as " ..
+                       "argument.", 2)
        end
 
        local requested_privs = {...}
@@ -40,49 +39,65 @@ function core.check_player_privs(name, ...)
        return true, ""
 end
 
-local player_list = {}
 
-core.register_on_joinplayer(function(player)
-       local player_name = player:get_player_name()
-       player_list[player_name] = player
-       if not minetest.is_singleplayer() then
+function core.send_join_message(player_name)
+       if not core.is_singleplayer() then
                core.chat_send_all("*** " .. player_name .. " joined the game.")
        end
-end)
+end
 
-core.register_on_leaveplayer(function(player, timed_out)
-       local player_name = player:get_player_name()
-       player_list[player_name] = nil
+
+function core.send_leave_message(player_name, timed_out)
        local announcement = "*** " ..  player_name .. " left the game."
        if timed_out then
                announcement = announcement .. " (timed out)"
        end
        core.chat_send_all(announcement)
-end)
+end
 
-function core.get_connected_players()
-       local temp_table = {}
-       for index, value in pairs(player_list) do
-               if value:is_player_connected() then
-                       temp_table[#temp_table + 1] = value
+
+core.register_on_joinplayer(function(player)
+       local player_name = player:get_player_name()
+       if not core.is_singleplayer() then
+               local status = core.get_server_status(player_name, true)
+               if status and status ~= "" then
+                       core.chat_send_player(player_name, status)
                end
        end
-       return temp_table
+       core.send_join_message(player_name)
+end)
+
+
+core.register_on_leaveplayer(function(player, timed_out)
+       local player_name = player:get_player_name()
+       core.send_leave_message(player_name, timed_out)
+end)
+
+
+function core.is_player(player)
+       -- a table being a player is also supported because it quacks sufficiently
+       -- like a player if it has the is_player function
+       local t = type(player)
+       return (t == "userdata" or t == "table") and
+               type(player.is_player) == "function" and player:is_player()
 end
 
-function minetest.player_exists(name)
-       return minetest.get_auth_handler().get_auth(name) ~= nil
+
+function core.player_exists(name)
+       return core.get_auth_handler().get_auth(name) ~= nil
 end
 
+
 -- Returns two position vectors representing a box of `radius` in each
 -- direction centered around the player corresponding to `player_name`
+
 function core.get_player_radius_area(player_name, radius)
        local player = core.get_player_by_name(player_name)
        if player == nil then
                return nil
        end
 
-       local p1 = player:getpos()
+       local p1 = player:get_pos()
        local p2 = p1
 
        if radius then
@@ -93,20 +108,25 @@ function core.get_player_radius_area(player_name, radius)
        return p1, p2
 end
 
+
 function core.hash_node_position(pos)
-       return (pos.z+32768)*65536*65536 + (pos.y+32768)*65536 + pos.x+32768
+       return (pos.z + 32768) * 65536 * 65536
+                + (pos.y + 32768) * 65536
+                +  pos.x + 32768
 end
 
+
 function core.get_position_from_hash(hash)
        local pos = {}
-       pos.x = (hash%65536) - 32768
-       hash = math.floor(hash/65536)
-       pos.y = (hash%65536) - 32768
-       hash = math.floor(hash/65536)
-       pos.z = (hash%65536) - 32768
+       pos.x = (hash % 65536) - 32768
+       hash  = math.floor(hash / 65536)
+       pos.y = (hash % 65536) - 32768
+       hash  = math.floor(hash / 65536)
+       pos.z = (hash % 65536) - 32768
        return pos
 end
 
+
 function core.get_item_group(name, group)
        if not core.registered_items[name] or not
                        core.registered_items[name].groups[group] then
@@ -115,30 +135,95 @@ function core.get_item_group(name, group)
        return core.registered_items[name].groups[group]
 end
 
+
 function core.get_node_group(name, group)
        core.log("deprecated", "Deprecated usage of get_node_group, use get_item_group instead")
        return core.get_item_group(name, group)
 end
 
+
 function core.setting_get_pos(name)
-       local value = core.setting_get(name)
+       local value = core.settings:get(name)
        if not value then
                return nil
        end
        return core.string_to_pos(value)
 end
 
+
+-- See l_env.cpp for the other functions
+function core.get_artificial_light(param1)
+       return math.floor(param1 / 16)
+end
+
+
 -- To be overriden by protection mods
+
 function core.is_protected(pos, name)
        return false
 end
 
+
 function core.record_protection_violation(pos, name)
        for _, func in pairs(core.registered_on_protection_violation) do
                func(pos, name)
        end
 end
 
+-- To be overridden by Creative mods
+
+local creative_mode_cache = core.settings:get_bool("creative_mode")
+function core.is_creative_enabled(name)
+       return creative_mode_cache
+end
+
+-- Checks if specified volume intersects a protected volume
+
+function core.is_area_protected(minp, maxp, player_name, interval)
+       -- 'interval' is the largest allowed interval for the 3D lattice of checks.
+
+       -- Compute the optimal float step 'd' for each axis so that all corners and
+       -- borders are checked. 'd' will be smaller or equal to 'interval'.
+       -- Subtracting 1e-4 ensures that the max co-ordinate will be reached by the
+       -- for loop (which might otherwise not be the case due to rounding errors).
+
+       -- Default to 4
+       interval = interval or 4
+       local d = {}
+
+       for _, c in pairs({"x", "y", "z"}) do
+               if minp[c] > maxp[c] then
+                       -- Repair positions: 'minp' > 'maxp'
+                       local tmp = maxp[c]
+                       maxp[c] = minp[c]
+                       minp[c] = tmp
+               end
+
+               if maxp[c] > minp[c] then
+                       d[c] = (maxp[c] - minp[c]) /
+                               math.ceil((maxp[c] - minp[c]) / interval) - 1e-4
+               else
+                       d[c] = 1 -- Any value larger than 0 to avoid division by zero
+               end
+       end
+
+       for zf = minp.z, maxp.z, d.z do
+               local z = math.floor(zf + 0.5)
+               for yf = minp.y, maxp.y, d.y do
+                       local y = math.floor(yf + 0.5)
+                       for xf = minp.x, maxp.x, d.x do
+                               local x = math.floor(xf + 0.5)
+                               local pos = {x = x, y = y, z = z}
+                               if core.is_protected(pos, player_name) then
+                                       return pos
+                               end
+                       end
+               end
+       end
+       return false
+end
+
+
 local raillike_ids = {}
 local raillike_cur_id = 0
 function core.raillike_group(name)
@@ -151,7 +236,9 @@ function core.raillike_group(name)
        return id
 end
 
+
 -- HTTP callback interface
+
 function core.http_add_fetch(httpenv)
        httpenv.fetch = function(req, callback)
                local handle = httpenv.fetch_async(req)
@@ -170,6 +257,35 @@ function core.http_add_fetch(httpenv)
        return httpenv
 end
 
+
 function core.close_formspec(player_name, formname)
-       return minetest.show_formspec(player_name, formname, "")
+       return core.show_formspec(player_name, formname, "")
+end
+
+
+function core.cancel_shutdown_requests()
+       core.request_shutdown("", false, -1)
+end
+
+
+-- Callback handling for dynamic_add_media
+
+local dynamic_add_media_raw = core.dynamic_add_media_raw
+core.dynamic_add_media_raw = nil
+function core.dynamic_add_media(filepath, callback)
+       local ret = dynamic_add_media_raw(filepath)
+       if ret == false then
+               return ret
+       end
+       if callback == nil then
+               core.log("deprecated", "Calling minetest.dynamic_add_media without "..
+                       "a callback is deprecated and will stop working in future versions.")
+       else
+               -- At the moment async loading is not actually implemented, so we
+               -- immediately call the callback ourselves
+               for _, name in ipairs(ret) do
+                       callback(name)
+               end
+       end
+       return true
 end