mods/default/functions.lua

   1 --
   2 -- Sounds
   3 --
   4
   5 function default.node_sound_defaults(table)
   6         table = table or {}
   7         table.footstep = table.footstep or
   8                         {name = "", gain = 1.0}
   9         table.dug = table.dug or
  10                         {name = "default_dug_node", gain = 0.25}
  11         table.place = table.place or
  12                         {name = "default_place_node_hard", gain = 1.0}
  13         return table
  14 end
  15
  16 function default.node_sound_stone_defaults(table)
  17         table = table or {}
  18         table.footstep = table.footstep or
  19                         {name = "default_hard_footstep", gain = 0.3}
  20         table.dug = table.dug or
  21                         {name = "default_hard_footstep", gain = 1.0}
  22         default.node_sound_defaults(table)
  23         return table
  24 end
  25
  26 function default.node_sound_dirt_defaults(table)
  27         table = table or {}
  28         table.footstep = table.footstep or
  29                         {name = "default_dirt_footstep", gain = 0.4}
  30         table.dug = table.dug or
  31                         {name = "default_dirt_footstep", gain = 1.0}
  32         table.place = table.place or
  33                         {name = "default_place_node", gain = 1.0}
  34         default.node_sound_defaults(table)
  35         return table
  36 end
  37
  38 function default.node_sound_sand_defaults(table)
  39         table = table or {}
  40         table.footstep = table.footstep or
  41                         {name = "default_sand_footstep", gain = 0.12}
  42         table.dug = table.dug or
  43                         {name = "default_sand_footstep", gain = 0.24}
  44         table.place = table.place or
  45                         {name = "default_place_node", gain = 1.0}
  46         default.node_sound_defaults(table)
  47         return table
  48 end
  49
  50 function default.node_sound_gravel_defaults(table)
  51         table = table or {}
  52         table.footstep = table.footstep or
  53                         {name = "default_gravel_footstep", gain = 0.4}
  54         table.dug = table.dug or
  55                         {name = "default_gravel_footstep", gain = 1.0}
  56         table.place = table.place or
  57                         {name = "default_place_node", gain = 1.0}
  58         default.node_sound_defaults(table)
  59         return table
  60 end
  61
  62 function default.node_sound_wood_defaults(table)
  63         table = table or {}
  64         table.footstep = table.footstep or
  65                         {name = "default_wood_footstep", gain = 0.3}
  66         table.dug = table.dug or
  67                         {name = "default_wood_footstep", gain = 1.0}
  68         default.node_sound_defaults(table)
  69         return table
  70 end
  71
  72 function default.node_sound_leaves_defaults(table)
  73         table = table or {}
  74         table.footstep = table.footstep or
  75                         {name = "default_grass_footstep", gain = 0.45}
  76         table.dug = table.dug or
  77                         {name = "default_grass_footstep", gain = 0.7}
  78         table.place = table.place or
  79                         {name = "default_place_node", gain = 1.0}
  80         default.node_sound_defaults(table)
  81         return table
  82 end
  83
  84 function default.node_sound_glass_defaults(table)
  85         table = table or {}
  86         table.footstep = table.footstep or
  87                         {name = "default_glass_footstep", gain = 0.3}
  88         table.dig = table.dig or
  89                         {name = "default_glass_footstep", gain = 0.5}
  90         table.dug = table.dug or
  91                         {name = "default_break_glass", gain = 1.0}
  92         default.node_sound_defaults(table)
  93         return table
  94 end
  95
  96 function default.node_sound_metal_defaults(table)
  97         table = table or {}
  98         table.footstep = table.footstep or
  99                         {name = "default_metal_footstep", gain = 0.4}
 100         table.dig = table.dig or
 101                         {name = "default_dig_metal", gain = 0.5}
 102         table.dug = table.dug or
 103                         {name = "default_dug_metal", gain = 0.5}
 104         table.place = table.place or
 105                         {name = "default_place_node_metal", gain = 0.5}
 106         default.node_sound_defaults(table)
 107         return table
 108 end
 109
 110 function default.node_sound_water_defaults(table)
 111         table = table or {}
 112         table.footstep = table.footstep or
 113                         {name = "default_water_footstep", gain = 0.2}
 114         default.node_sound_defaults(table)
 115         return table
 116 end
 117
 118 function default.node_sound_snow_defaults(table)
 119         table = table or {}
 120         table.footstep = table.footstep or
 121                         {name = "default_snow_footstep", gain = 0.2}
 122         table.dig = table.dig or
 123                         {name = "default_snow_footstep", gain = 0.3}
 124         table.dug = table.dug or
 125                         {name = "default_snow_footstep", gain = 0.3}
 126         table.place = table.place or
 127                         {name = "default_place_node", gain = 1.0}
 128         default.node_sound_defaults(table)
 129         return table
 130 end
 131
 132
 133 --
 134 -- Lavacooling
 135 --
 136
 137 default.cool_lava = function(pos, node)
 138         if node.name == "default:lava_source" then
 139                 minetest.set_node(pos, {name = "default:obsidian"})
 140         else -- Lava flowing
 141                 minetest.set_node(pos, {name = "default:stone"})
 142         end
 143         minetest.sound_play("default_cool_lava",
 144                 {pos = pos, max_hear_distance = 16, gain = 0.25}, true)
 145 end
 146
 147 if minetest.settings:get_bool("enable_lavacooling") ~= false then
 148         minetest.register_abm({
 149                 label = "Lava cooling",
 150                 nodenames = {"default:lava_source", "default:lava_flowing"},
 151                 neighbors = {"group:cools_lava", "group:water"},
 152                 interval = 2,
 153                 chance = 2,
 154                 catch_up = false,
 155                 action = function(...)
 156                         default.cool_lava(...)
 157                 end,
 158         })
 159 end
 160
 161
 162 --
 163 -- Optimized helper to put all items in an inventory into a drops list
 164 --
 165
 166 function default.get_inventory_drops(pos, inventory, drops)
 167         local inv = minetest.get_meta(pos):get_inventory()
 168         local n = #drops
 169         for i = 1, inv:get_size(inventory) do
 170                 local stack = inv:get_stack(inventory, i)
 171                 if stack:get_count() > 0 then
 172                         drops[n+1] = stack:to_table()
 173                         n = n + 1
 174                 end
 175         end
 176 end
 177
 178
 179 --
 180 -- Papyrus and cactus growing
 181 --
 182
 183 -- Wrapping the functions in ABM action is necessary to make overriding them possible
 184
 185 function default.grow_cactus(pos, node)
 186         if node.param2 >= 4 then
 187                 return
 188         end
 189         pos.y = pos.y - 1
 190         if minetest.get_item_group(minetest.get_node(pos).name, "sand") == 0 then
 191                 return
 192         end
 193         pos.y = pos.y + 1
 194         local height = 0
 195         while node.name == "default:cactus" and height < 4 do
 196                 height = height + 1
 197                 pos.y = pos.y + 1
 198                 node = minetest.get_node(pos)
 199         end
 200         if height == 4 or node.name ~= "air" then
 201                 return
 202         end
 203         if minetest.get_node_light(pos) < 13 then
 204                 return
 205         end
 206         minetest.set_node(pos, {name = "default:cactus"})
 207         return true
 208 end
 209
 210 function default.grow_papyrus(pos, node)
 211         pos.y = pos.y - 1
 212         local name = minetest.get_node(pos).name
 213         if name ~= "default:dirt_with_grass" and name ~= "default:dirt" then
 214                 return
 215         end
 216         if not minetest.find_node_near(pos, 3, {"group:water"}) then
 217                 return
 218         end
 219         pos.y = pos.y + 1
 220         local height = 0
 221         while node.name == "default:papyrus" and height < 4 do
 222                 height = height + 1
 223                 pos.y = pos.y + 1
 224                 node = minetest.get_node(pos)
 225         end
 226         if height == 4 or node.name ~= "air" then
 227                 return
 228         end
 229         if minetest.get_node_light(pos) < 13 then
 230                 return
 231         end
 232         minetest.set_node(pos, {name = "default:papyrus"})
 233         return true
 234 end
 235
 236 minetest.register_abm({
 237         label = "Grow cactus",
 238         nodenames = {"default:cactus"},
 239         neighbors = {"group:sand"},
 240         interval = 12,
 241         chance = 83,
 242         action = function(...)
 243                 default.grow_cactus(...)
 244         end
 245 })
 246
 247 minetest.register_abm({
 248         label = "Grow papyrus",
 249         nodenames = {"default:papyrus"},
 250         neighbors = {"default:dirt", "default:dirt_with_grass"},
 251         interval = 14,
 252         chance = 71,
 253         action = function(...)
 254                 default.grow_papyrus(...)
 255         end
 256 })
 257
 258
 259 --
 260 -- Dig upwards
 261 --
 262
 263 function default.dig_up(pos, node, digger)
 264         if digger == nil then return end
 265         local np = {x = pos.x, y = pos.y + 1, z = pos.z}
 266         local nn = minetest.get_node(np)
 267         if nn.name == node.name then
 268                 minetest.node_dig(np, nn, digger)
 269         end
 270 end
 271
 272
 273 --
 274 -- Fence registration helper
 275 --
 276 local fence_collision_extra = minetest.settings:get_bool("enable_fence_tall") and 3/8 or 0
 277
 278 function default.register_fence(name, def)
 279         minetest.register_craft({
 280                 output = name .. " 4",
 281                 recipe = {
 282                         { def.material, 'group:stick', def.material },
 283                         { def.material, 'group:stick', def.material },
 284                 }
 285         })
 286
 287         local fence_texture = "default_fence_overlay.png^" .. def.texture ..
 288                         "^default_fence_overlay.png^[makealpha:255,126,126"
 289         -- Allow almost everything to be overridden
 290         local default_fields = {
 291                 paramtype = "light",
 292                 drawtype = "nodebox",
 293                 node_box = {
 294                         type = "connected",
 295                         fixed = {-1/8, -1/2, -1/8, 1/8, 1/2, 1/8},
 296                         -- connect_top =
 297                         -- connect_bottom =
 298                         connect_front = {{-1/16,  3/16, -1/2,   1/16,  5/16, -1/8 },
 299                                          {-1/16, -5/16, -1/2,   1/16, -3/16, -1/8 }},
 300                         connect_left =  {{-1/2,   3/16, -1/16, -1/8,   5/16,  1/16},
 301                                          {-1/2,  -5/16, -1/16, -1/8,  -3/16,  1/16}},
 302                         connect_back =  {{-1/16,  3/16,  1/8,   1/16,  5/16,  1/2 },
 303                                          {-1/16, -5/16,  1/8,   1/16, -3/16,  1/2 }},
 304                         connect_right = {{ 1/8,   3/16, -1/16,  1/2,   5/16,  1/16},
 305                                          { 1/8,  -5/16, -1/16,  1/2,  -3/16,  1/16}}
 306                 },
 307                 collision_box = {
 308                         type = "connected",
 309                         fixed = {-1/8, -1/2, -1/8, 1/8, 1/2 + fence_collision_extra, 1/8},
 310                         -- connect_top =
 311                         -- connect_bottom =
 312                         connect_front = {-1/8, -1/2, -1/2,  1/8, 1/2 + fence_collision_extra, -1/8},
 313                         connect_left =  {-1/2, -1/2, -1/8, -1/8, 1/2 + fence_collision_extra,  1/8},
 314                         connect_back =  {-1/8, -1/2,  1/8,  1/8, 1/2 + fence_collision_extra,  1/2},
 315                         connect_right = { 1/8, -1/2, -1/8,  1/2, 1/2 + fence_collision_extra,  1/8}
 316                 },
 317                 connects_to = {"group:fence", "group:wood", "group:tree", "group:wall"},
 318                 inventory_image = fence_texture,
 319                 wield_image = fence_texture,
 320                 tiles = {def.texture},
 321                 sunlight_propagates = true,
 322                 is_ground_content = false,
 323                 groups = {},
 324         }
 325         for k, v in pairs(default_fields) do
 326                 if def[k] == nil then
 327                         def[k] = v
 328                 end
 329         end
 330
 331         -- Always add to the fence group, even if no group provided
 332         def.groups.fence = 1
 333
 334         def.texture = nil
 335         def.material = nil
 336
 337         minetest.register_node(name, def)
 338 end
 339
 340
 341 --
 342 -- Fence rail registration helper
 343 --
 344
 345 function default.register_fence_rail(name, def)
 346         minetest.register_craft({
 347                 output = name .. " 16",
 348                 recipe = {
 349                         { def.material, def.material },
 350                         { "", ""},
 351                         { def.material, def.material },
 352                 }
 353         })
 354
 355         local fence_rail_texture = "default_fence_rail_overlay.png^" .. def.texture ..
 356                         "^default_fence_rail_overlay.png^[makealpha:255,126,126"
 357         -- Allow almost everything to be overridden
 358         local default_fields = {
 359                 paramtype = "light",
 360                 drawtype = "nodebox",
 361                 node_box = {
 362                         type = "connected",
 363                         fixed = {{-1/16,  3/16, -1/16, 1/16,  5/16, 1/16},
 364                                  {-1/16, -3/16, -1/16, 1/16, -5/16, 1/16}},
 365                         -- connect_top =
 366                         -- connect_bottom =
 367                         connect_front = {{-1/16,  3/16, -1/2,   1/16,  5/16, -1/16},
 368                                          {-1/16, -5/16, -1/2,   1/16, -3/16, -1/16}},
 369                         connect_left =  {{-1/2,   3/16, -1/16, -1/16,  5/16,  1/16},
 370                                          {-1/2,  -5/16, -1/16, -1/16, -3/16,  1/16}},
 371                         connect_back =  {{-1/16,  3/16,  1/16,  1/16,  5/16,  1/2 },
 372                                          {-1/16, -5/16,  1/16,  1/16, -3/16,  1/2 }},
 373                         connect_right = {{ 1/16,  3/16, -1/16,  1/2,   5/16,  1/16},
 374                                          { 1/16, -5/16, -1/16,  1/2,  -3/16,  1/16}}
 375                 },
 376                 collision_box = {
 377                         type = "connected",
 378                         fixed = {-1/8, -1/2, -1/8, 1/8, 1/2 + fence_collision_extra, 1/8},
 379                         -- connect_top =
 380                         -- connect_bottom =
 381                         connect_front = {-1/8, -1/2, -1/2,  1/8, 1/2 + fence_collision_extra, -1/8},
 382                         connect_left =  {-1/2, -1/2, -1/8, -1/8, 1/2 + fence_collision_extra,  1/8},
 383                         connect_back =  {-1/8, -1/2,  1/8,  1/8, 1/2 + fence_collision_extra,  1/2},
 384                         connect_right = { 1/8, -1/2, -1/8,  1/2, 1/2 + fence_collision_extra,  1/8}
 385                 },
 386                 connects_to = {"group:fence", "group:wall"},
 387                 inventory_image = fence_rail_texture,
 388                 wield_image = fence_rail_texture,
 389                 tiles = {def.texture},
 390                 sunlight_propagates = true,
 391                 is_ground_content = false,
 392                 groups = {},
 393         }
 394         for k, v in pairs(default_fields) do
 395                 if def[k] == nil then
 396                         def[k] = v
 397                 end
 398         end
 399
 400         -- Always add to the fence group, even if no group provided
 401         def.groups.fence = 1
 402
 403         def.texture = nil
 404         def.material = nil
 405
 406         minetest.register_node(name, def)
 407 end
 408
 409
 410 --
 411 -- Leafdecay
 412 --
 413
 414 -- Prevent decay of placed leaves
 415
 416 default.after_place_leaves = function(pos, placer, itemstack, pointed_thing)
 417         if placer and placer:is_player() then
 418                 local node = minetest.get_node(pos)
 419                 node.param2 = 1
 420                 minetest.set_node(pos, node)
 421         end
 422 end
 423
 424 -- Leafdecay
 425 local function leafdecay_after_destruct(pos, oldnode, def)
 426         for _, v in pairs(minetest.find_nodes_in_area(vector.subtract(pos, def.radius),
 427                         vector.add(pos, def.radius), def.leaves)) do
 428                 local node = minetest.get_node(v)
 429                 local timer = minetest.get_node_timer(v)
 430                 if node.param2 ~= 1 and not timer:is_started() then
 431                         timer:start(math.random(20, 120) / 10)
 432                 end
 433         end
 434 end
 435
 436 local movement_gravity = tonumber(
 437         minetest.settings:get("movement_gravity")) or 9.81
 438
 439 local function leafdecay_on_timer(pos, def)
 440         if minetest.find_node_near(pos, def.radius, def.trunks) then
 441                 return false
 442         end
 443
 444         local node = minetest.get_node(pos)
 445         local drops = minetest.get_node_drops(node.name)
 446         for _, item in ipairs(drops) do
 447                 local is_leaf
 448                 for _, v in pairs(def.leaves) do
 449                         if v == item then
 450                                 is_leaf = true
 451                         end
 452                 end
 453                 if minetest.get_item_group(item, "leafdecay_drop") ~= 0 or
 454                                 not is_leaf then
 455                         minetest.add_item({
 456                                 x = pos.x - 0.5 + math.random(),
 457                                 y = pos.y - 0.5 + math.random(),
 458                                 z = pos.z - 0.5 + math.random(),
 459                         }, item)
 460                 end
 461         end
 462
 463         minetest.remove_node(pos)
 464         minetest.check_for_falling(pos)
 465
 466         -- spawn a few particles for the removed node
 467         minetest.add_particlespawner({
 468                 amount = 8,
 469                 time = 0.001,
 470                 minpos = vector.subtract(pos, {x=0.5, y=0.5, z=0.5}),
 471                 maxpos = vector.add(pos, {x=0.5, y=0.5, z=0.5}),
 472                 minvel = vector.new(-0.5, -1, -0.5),
 473                 maxvel = vector.new(0.5, 0, 0.5),
 474                 minacc = vector.new(0, -movement_gravity, 0),
 475                 maxacc = vector.new(0, -movement_gravity, 0),
 476                 minsize = 0,
 477                 maxsize = 0,
 478                 node = node,
 479         })
 480 end
 481
 482 function default.register_leafdecay(def)
 483         assert(def.leaves)
 484         assert(def.trunks)
 485         assert(def.radius)
 486         for _, v in pairs(def.trunks) do
 487                 minetest.override_item(v, {
 488                         after_destruct = function(pos, oldnode)
 489                                 leafdecay_after_destruct(pos, oldnode, def)
 490                         end,
 491                 })
 492         end
 493         for _, v in pairs(def.leaves) do
 494                 minetest.override_item(v, {
 495                         on_timer = function(pos)
 496                                 leafdecay_on_timer(pos, def)
 497                         end,
 498                 })
 499         end
 500 end
 501
 502
 503 --
 504 -- Convert dirt to something that fits the environment
 505 --
 506
 507 minetest.register_abm({
 508         label = "Grass spread",
 509         nodenames = {"default:dirt"},
 510         neighbors = {
 511                 "air",
 512                 "group:grass",
 513                 "default:snow",
 514         },
 515         interval = 6,
 516         chance = 50,
 517         catch_up = false,
 518         action = function(pos, node)
 519                 -- Check for darkness: night, shadow or under a light-blocking node
 520                 -- Returns if ignore above
 521                 local above = {x = pos.x, y = pos.y + 1, z = pos.z}
 522                 if (minetest.get_node_light(above) or 0) < 13 then
 523                         return
 524                 end
 525
 526                 -- Look for spreading dirt-type neighbours
 527                 local p2 = minetest.find_node_near(pos, 1, "group:spreading_dirt_type")
 528                 if p2 then
 529                         local n3 = minetest.get_node(p2)
 530                         minetest.set_node(pos, {name = n3.name})
 531                         return
 532                 end
 533
 534                 -- Else, any seeding nodes on top?
 535                 local name = minetest.get_node(above).name
 536                 -- Snow check is cheapest, so comes first
 537                 if name == "default:snow" then
 538                         minetest.set_node(pos, {name = "default:dirt_with_snow"})
 539                 elseif minetest.get_item_group(name, "grass") ~= 0 then
 540                         minetest.set_node(pos, {name = "default:dirt_with_grass"})
 541                 end
 542         end
 543 })
 544
 545
 546 --
 547 -- Grass and dry grass removed in darkness
 548 --
 549
 550 minetest.register_abm({
 551         label = "Grass covered",
 552         nodenames = {"group:spreading_dirt_type", "default:dry_dirt_with_dry_grass"},
 553         interval = 8,
 554         chance = 50,
 555         catch_up = false,
 556         action = function(pos, node)
 557                 local above = {x = pos.x, y = pos.y + 1, z = pos.z}
 558                 local name = minetest.get_node(above).name
 559                 local nodedef = minetest.registered_nodes[name]
 560                 if name ~= "ignore" and nodedef and not ((nodedef.sunlight_propagates or
 561                                 nodedef.paramtype == "light") and
 562                                 nodedef.liquidtype == "none") then
 563                         if node.name == "default:dry_dirt_with_dry_grass" then
 564                                 minetest.set_node(pos, {name = "default:dry_dirt"})
 565                         else
 566                                 minetest.set_node(pos, {name = "default:dirt"})
 567                         end
 568                 end
 569         end
 570 })
 571
 572
 573 --
 574 -- Moss growth on cobble near water
 575 --
 576
 577 local moss_correspondences = {
 578         ["default:cobble"] = "default:mossycobble",
 579         ["stairs:slab_cobble"] = "stairs:slab_mossycobble",
 580         ["stairs:stair_cobble"] = "stairs:stair_mossycobble",
 581         ["stairs:stair_inner_cobble"] = "stairs:stair_inner_mossycobble",
 582         ["stairs:stair_outer_cobble"] = "stairs:stair_outer_mossycobble",
 583         ["walls:cobble"] = "walls:mossycobble",
 584 }
 585 minetest.register_abm({
 586         label = "Moss growth",
 587         nodenames = {"default:cobble", "stairs:slab_cobble", "stairs:stair_cobble",
 588                 "stairs:stair_inner_cobble", "stairs:stair_outer_cobble",
 589                 "walls:cobble"},
 590         neighbors = {"group:water"},
 591         interval = 16,
 592         chance = 200,
 593         catch_up = false,
 594         action = function(pos, node)
 595                 node.name = moss_correspondences[node.name]
 596                 if node.name then
 597                         minetest.set_node(pos, node)
 598                 end
 599         end
 600 })
 601
 602 --
 603 -- Register a craft to copy the metadata of items
 604 --
 605
 606 function default.register_craft_metadata_copy(ingredient, result)
 607         minetest.register_craft({
 608                 type = "shapeless",
 609                 output = result,
 610                 recipe = {ingredient, result}
 611         })
 612
 613         minetest.register_on_craft(function(itemstack, player, old_craft_grid, craft_inv)
 614                 if itemstack:get_name() ~= result then
 615                         return
 616                 end
 617
 618                 local original
 619                 local index
 620                 for i = 1, #old_craft_grid do
 621                         if old_craft_grid[i]:get_name() == result then
 622                                 original = old_craft_grid[i]
 623                                 index = i
 624                         end
 625                 end
 626                 if not original then
 627                         return
 628                 end
 629                 local copymeta = original:get_meta():to_table()
 630                 itemstack:get_meta():from_table(copymeta)
 631                 -- put the book with metadata back in the craft grid
 632                 craft_inv:set_stack("craft", index, original)
 633         end)
 634 end
 635
 636
 637 --
 638 -- NOTICE: This method is not an official part of the API yet.
 639 -- This method may change in future.
 640 --
 641
 642 function default.can_interact_with_node(player, pos)
 643         if player and player:is_player() then
 644                 if minetest.check_player_privs(player, "protection_bypass") then
 645                         return true
 646                 end
 647         else
 648                 return false
 649         end
 650
 651         local meta = minetest.get_meta(pos)
 652         local owner = meta:get_string("owner")
 653
 654         if not owner or owner == "" or owner == player:get_player_name() then
 655                 return true
 656         end
 657
 658         -- Is player wielding the right key?
 659         local item = player:get_wielded_item()
 660         if minetest.get_item_group(item:get_name(), "key") == 1 then
 661                 local key_meta = item:get_meta()
 662
 663                 if key_meta:get_string("secret") == "" then
 664                         local key_oldmeta = item:get_metadata()
 665                         if key_oldmeta == "" or not minetest.parse_json(key_oldmeta) then
 666                                 return false
 667                         end
 668
 669                         key_meta:set_string("secret", minetest.parse_json(key_oldmeta).secret)
 670                         item:set_metadata("")
 671                 end
 672
 673                 return meta:get_string("key_lock_secret") == key_meta:get_string("secret")
 674         end
 675
 676         return false
 677 end