builtin/client/register.lua

   1
   2 core.callback_origins = {}
   3
   4 local getinfo = debug.getinfo
   5 debug.getinfo = nil
   6
   7 --- Runs given callbacks.
   8 --
   9 -- Note: this function is also called from C++
  10 -- @tparam table  callbacks a table with registered callbacks, like `core.registered_on_*`
  11 -- @tparam number mode      a RunCallbacksMode, as defined in src/script/common/c_internal.h
  12 -- @param         ...       arguments for the callback
  13 -- @return depends on mode
  14 function core.run_callbacks(callbacks, mode, ...)
  15         assert(type(callbacks) == "table")
  16         local cb_len = #callbacks
  17         if cb_len == 0 then
  18                 if mode == 2 or mode == 3 then
  19                         return true
  20                 elseif mode == 4 or mode == 5 then
  21                         return false
  22                 end
  23         end
  24         local ret
  25         for i = 1, cb_len do
  26                 local cb_ret = callbacks[i](...)
  27
  28                 if mode == 0 and i == 1 or mode == 1 and i == cb_len then
  29                         ret = cb_ret
  30                 elseif mode == 2 then
  31                         if not cb_ret or i == 1 then
  32                                 ret = cb_ret
  33                         end
  34                 elseif mode == 3 then
  35                         if cb_ret then
  36                                 return cb_ret
  37                         end
  38                         ret = cb_ret
  39                 elseif mode == 4 then
  40                         if (cb_ret and not ret) or i == 1 then
  41                                 ret = cb_ret
  42                         end
  43                 elseif mode == 5 and cb_ret then
  44                         return cb_ret
  45                 end
  46         end
  47         return ret
  48 end
  49
  50 function core.override_item(name, redefinition)
  51         if redefinition.name ~= nil then
  52                 error("Attempt to redefine name of "..name.." to "..dump(redefinition.name), 2)
  53         end
  54         if redefinition.type ~= nil then
  55                 error("Attempt to redefine type of "..name.." to "..dump(redefinition.type), 2)
  56         end
  57         local itemdef = core.get_item_def(name)
  58         if not itemdef then
  59                 error("Attempt to override non-existent item "..name, 2)
  60         end
  61         local nodedef = core.get_node_def(name)
  62         table.combine(itemdef, nodedef)
  63
  64         for k, v in pairs(redefinition) do
  65                 rawset(itemdef, k, v)
  66         end
  67         core.register_item_raw(itemdef)
  68 end
  69
  70 --
  71 -- Callback registration
  72 --
  73
  74 local function make_registration()
  75         local t = {}
  76         local registerfunc = function(func)
  77                 t[#t + 1] = func
  78                 core.callback_origins[func] = {
  79                         mod = core.get_current_modname() or "??",
  80                         name = getinfo(1, "n").name or "??"
  81                 }
  82                 --local origin = core.callback_origins[func]
  83                 --print(origin.name .. ": " .. origin.mod .. " registering cbk " .. tostring(func))
  84         end
  85         return t, registerfunc
  86 end
  87
  88 core.registered_globalsteps, core.register_globalstep = make_registration()
  89 core.registered_on_mods_loaded, core.register_on_mods_loaded = make_registration()
  90 core.registered_on_shutdown, core.register_on_shutdown = make_registration()
  91 core.registered_on_receiving_chat_message, core.register_on_receiving_chat_message = make_registration()
  92 core.registered_on_sending_chat_message, core.register_on_sending_chat_message = make_registration()
  93 core.registered_on_chatcommand, core.register_on_chatcommand = make_registration()
  94 core.registered_on_death, core.register_on_death = make_registration()
  95 core.registered_on_hp_modification, core.register_on_hp_modification = make_registration()
  96 core.registered_on_damage_taken, core.register_on_damage_taken = make_registration()
  97 core.registered_on_formspec_input, core.register_on_formspec_input = make_registration()
  98 core.registered_on_dignode, core.register_on_dignode = make_registration()
  99 core.registered_on_punchnode, core.register_on_punchnode = make_registration()
 100 core.registered_on_placenode, core.register_on_placenode = make_registration()
 101 core.registered_on_item_use, core.register_on_item_use = make_registration()
 102 core.registered_on_modchannel_message, core.register_on_modchannel_message = make_registration()
 103 core.registered_on_modchannel_signal, core.register_on_modchannel_signal = make_registration()
 104 core.registered_on_inventory_open, core.register_on_inventory_open = make_registration()
 105 core.registered_on_recieve_physics_override, core.register_on_recieve_physics_override = make_registration()
 106 core.registered_on_play_sound, core.register_on_play_sound = make_registration()
 107 core.registered_on_spawn_particle, core.register_on_spawn_particle = make_registration()
 108 core.registered_on_object_properties_change, core.register_on_object_properties_change = make_registration()
 109 core.registered_on_object_hp_change, core.register_on_object_hp_change = make_registration()
 110 core.registered_on_object_add, core.register_on_object_add = make_registration()
 111
 112 core.registered_nodes = {}
 113 core.registered_items = {}
 114 core.object_refs = {}