builtin/misc.lua

   1 -- Minetest: builtin/misc.lua
   2
   3 --
   4 -- Misc. API functions
   5 --
   6
   7 minetest.timers_to_add = {}
   8 minetest.timers = {}
   9 minetest.register_globalstep(function(dtime)
  10         for _, timer in ipairs(minetest.timers_to_add) do
  11                 table.insert(minetest.timers, timer)
  12         end
  13         minetest.timers_to_add = {}
  14         for index, timer in ipairs(minetest.timers) do
  15                 timer.time = timer.time - dtime
  16                 if timer.time <= 0 then
  17                         timer.func(unpack(timer.args or {}))
  18                         table.remove(minetest.timers,index)
  19                 end
  20         end
  21 end)
  22
  23 function minetest.after(time, func, ...)
  24         table.insert(minetest.timers_to_add, {time=time, func=func, args={...}})
  25 end
  26
  27 function minetest.check_player_privs(name, privs)
  28         local player_privs = minetest.get_player_privs(name)
  29         local missing_privileges = {}
  30         for priv, val in pairs(privs) do
  31                 if val then
  32                         if not player_privs[priv] then
  33                                 table.insert(missing_privileges, priv)
  34                         end
  35                 end
  36         end
  37         if #missing_privileges > 0 then
  38                 return false, missing_privileges
  39         end
  40         return true, ""
  41 end
  42
  43 local player_list = {}
  44
  45 minetest.register_on_joinplayer(function(player)
  46         player_list[player:get_player_name()] = player
  47 end)
  48
  49 minetest.register_on_leaveplayer(function(player)
  50         player_list[player:get_player_name()] = nil
  51 end)
  52
  53 function minetest.get_connected_players()
  54         local temp_table = {}
  55         for index, value in pairs(player_list) do
  56                 if value:is_player_connected() then
  57                         table.insert(temp_table, value)
  58                 end
  59         end
  60         return temp_table
  61 end
  62
  63 function minetest.hash_node_position(pos)
  64         return (pos.z+32768)*65536*65536 + (pos.y+32768)*65536 + pos.x+32768
  65 end
  66
  67 function minetest.get_item_group(name, group)
  68         if not minetest.registered_items[name] or not
  69                         minetest.registered_items[name].groups[group] then
  70                 return 0
  71         end
  72         return minetest.registered_items[name].groups[group]
  73 end
  74
  75 function minetest.get_node_group(name, group)
  76         return minetest.get_item_group(name, group)
  77 end
  78
  79 function minetest.string_to_pos(value)
  80         local p = {}
  81         p.x, p.y, p.z = string.match(value, "^([%d.-]+)[, ] *([%d.-]+)[, ] *([%d.-]+)$")
  82         if p.x and p.y and p.z then
  83                 p.x = tonumber(p.x)
  84                 p.y = tonumber(p.y)
  85                 p.z = tonumber(p.z)
  86                 return p
  87         end
  88         local p = {}
  89         p.x, p.y, p.z = string.match(value, "^%( *([%d.-]+)[, ] *([%d.-]+)[, ] *([%d.-]+) *%)$")
  90         if p.x and p.y and p.z then
  91                 p.x = tonumber(p.x)
  92                 p.y = tonumber(p.y)
  93                 p.z = tonumber(p.z)
  94                 return p
  95         end
  96         return nil
  97 end
  98
  99 assert(minetest.string_to_pos("10.0, 5, -2").x == 10)
 100 assert(minetest.string_to_pos("( 10.0, 5, -2)").z == -2)
 101 assert(minetest.string_to_pos("asd, 5, -2)") == nil)
 102
 103 function minetest.setting_get_pos(name)
 104         local value = minetest.setting_get(name)
 105         if not value then
 106                 return nil
 107         end
 108         return minetest.string_to_pos(value)
 109 end
 110
 111 -- To be overriden by protection mods
 112 function minetest.is_protected(pos, name)
 113         return false
 114 end
 115
 116 function minetest.record_protection_violation(pos, name)
 117         for _, func in pairs(minetest.registered_on_protection_violation) do
 118                 func(pos, name)
 119         end
 120 end
 121