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})
 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
 277 function default.register_fence(name, def)
 278         minetest.register_craft({
 279                 output = name .. " 4",
 280                 recipe = {
 281                         { def.material, 'group:stick', def.material },
 282                         { def.material, 'group:stick', def.material },
 283                 }
 284         })
 285
 286         local fence_texture = "default_fence_overlay.png^" .. def.texture ..
 287                         "^default_fence_overlay.png^[makealpha:255,126,126"
 288         -- Allow almost everything to be overridden
 289         local default_fields = {
 290                 paramtype = "light",
 291                 drawtype = "nodebox",
 292                 node_box = {
 293                         type = "connected",
 294                         fixed = {{-1/8, -1/2, -1/8, 1/8, 1/2, 1/8}},
 295                         -- connect_top =
 296                         -- connect_bottom =
 297                         connect_front = {{-1/16,3/16,-1/2,1/16,5/16,-1/8},
 298                                 {-1/16,-5/16,-1/2,1/16,-3/16,-1/8}},
 299                         connect_left = {{-1/2,3/16,-1/16,-1/8,5/16,1/16},
 300                                 {-1/2,-5/16,-1/16,-1/8,-3/16,1/16}},
 301                         connect_back = {{-1/16,3/16,1/8,1/16,5/16,1/2},
 302                                 {-1/16,-5/16,1/8,1/16,-3/16,1/2}},
 303                         connect_right = {{1/8,3/16,-1/16,1/2,5/16,1/16},
 304                                 {1/8,-5/16,-1/16,1/2,-3/16,1/16}},
 305                 },
 306                 connects_to = {"group:fence", "group:wood", "group:tree", "group:wall"},
 307                 inventory_image = fence_texture,
 308                 wield_image = fence_texture,
 309                 tiles = {def.texture},
 310                 sunlight_propagates = true,
 311                 is_ground_content = false,
 312                 groups = {},
 313         }
 314         for k, v in pairs(default_fields) do
 315                 if def[k] == nil then
 316                         def[k] = v
 317                 end
 318         end
 319
 320         -- Always add to the fence group, even if no group provided
 321         def.groups.fence = 1
 322
 323         def.texture = nil
 324         def.material = nil
 325
 326         minetest.register_node(name, def)
 327 end
 328
 329
 330 --
 331 -- Fence rail registration helper
 332 --
 333
 334 function default.register_fence_rail(name, def)
 335         minetest.register_craft({
 336                 output = name .. " 16",
 337                 recipe = {
 338                         { def.material, def.material },
 339                         { "", ""},
 340                         { def.material, def.material },
 341                 }
 342         })
 343
 344         local fence_rail_texture = "default_fence_rail_overlay.png^" .. def.texture ..
 345                         "^default_fence_rail_overlay.png^[makealpha:255,126,126"
 346         -- Allow almost everything to be overridden
 347         local default_fields = {
 348                 paramtype = "light",
 349                 drawtype = "nodebox",
 350                 node_box = {
 351                         type = "connected",
 352                         fixed = {
 353                                 {-1/16,  3/16, -1/16, 1/16,  5/16, 1/16},
 354                                 {-1/16, -3/16, -1/16, 1/16, -5/16, 1/16}
 355                         },
 356                         -- connect_top =
 357                         -- connect_bottom =
 358                         connect_front = {
 359                                 {-1/16,  3/16, -1/2, 1/16,  5/16, -1/16},
 360                                 {-1/16, -5/16, -1/2, 1/16, -3/16, -1/16}},
 361                         connect_left = {
 362                                 {-1/2,  3/16, -1/16, -1/16,  5/16, 1/16},
 363                                 {-1/2, -5/16, -1/16, -1/16, -3/16, 1/16}},
 364                         connect_back = {
 365                                 {-1/16,  3/16, 1/16, 1/16,  5/16, 1/2},
 366                                 {-1/16, -5/16, 1/16, 1/16, -3/16, 1/2}},
 367                         connect_right = {
 368                                 {1/16,  3/16, -1/16, 1/2,  5/16, 1/16},
 369                                 {1/16, -5/16, -1/16, 1/2, -3/16, 1/16}},
 370                 },
 371                 connects_to = {"group:fence", "group:wall"},
 372                 inventory_image = fence_rail_texture,
 373                 wield_image = fence_rail_texture,
 374                 tiles = {def.texture},
 375                 sunlight_propagates = true,
 376                 is_ground_content = false,
 377                 groups = {},
 378         }
 379         for k, v in pairs(default_fields) do
 380                 if def[k] == nil then
 381                         def[k] = v
 382                 end
 383         end
 384
 385         -- Always add to the fence group, even if no group provided
 386         def.groups.fence = 1
 387
 388         def.texture = nil
 389         def.material = nil
 390
 391         minetest.register_node(name, def)
 392 end
 393
 394
 395 --
 396 -- Leafdecay
 397 --
 398
 399 -- Prevent decay of placed leaves
 400
 401 default.after_place_leaves = function(pos, placer, itemstack, pointed_thing)
 402         if placer and placer:is_player() and not placer:get_player_control().sneak then
 403                 local node = minetest.get_node(pos)
 404                 node.param2 = 1
 405                 minetest.set_node(pos, node)
 406         end
 407 end
 408
 409 -- Leafdecay
 410 local function leafdecay_after_destruct(pos, oldnode, def)
 411         for _, v in pairs(minetest.find_nodes_in_area(vector.subtract(pos, def.radius),
 412                         vector.add(pos, def.radius), def.leaves)) do
 413                 local node = minetest.get_node(v)
 414                 local timer = minetest.get_node_timer(v)
 415                 if node.param2 == 0 and not timer:is_started() then
 416                         timer:start(math.random(20, 120) / 10)
 417                 end
 418         end
 419 end
 420
 421 local function leafdecay_on_timer(pos, def)
 422         if minetest.find_node_near(pos, def.radius, def.trunks) then
 423                 return false
 424         end
 425
 426         local node = minetest.get_node(pos)
 427         local drops = minetest.get_node_drops(node.name)
 428         for _, item in ipairs(drops) do
 429                 local is_leaf
 430                 for _, v in pairs(def.leaves) do
 431                         if v == item then
 432                                 is_leaf = true
 433                         end
 434                 end
 435                 if minetest.get_item_group(item, "leafdecay_drop") ~= 0 or
 436                                 not is_leaf then
 437                         minetest.add_item({
 438                                 x = pos.x - 0.5 + math.random(),
 439                                 y = pos.y - 0.5 + math.random(),
 440                                 z = pos.z - 0.5 + math.random(),
 441                         }, item)
 442                 end
 443         end
 444
 445         minetest.remove_node(pos)
 446         minetest.check_for_falling(pos)
 447 end
 448
 449 function default.register_leafdecay(def)
 450         assert(def.leaves)
 451         assert(def.trunks)
 452         assert(def.radius)
 453         for _, v in pairs(def.trunks) do
 454                 minetest.override_item(v, {
 455                         after_destruct = function(pos, oldnode)
 456                                 leafdecay_after_destruct(pos, oldnode, def)
 457                         end,
 458                 })
 459         end
 460         for _, v in pairs(def.leaves) do
 461                 minetest.override_item(v, {
 462                         on_timer = function(pos)
 463                                 leafdecay_on_timer(pos, def)
 464                         end,
 465                 })
 466         end
 467 end
 468
 469
 470 --
 471 -- Convert dirt to something that fits the environment
 472 --
 473
 474 minetest.register_abm({
 475         label = "Grass spread",
 476         nodenames = {"default:dirt"},
 477         neighbors = {
 478                 "air",
 479                 "group:grass",
 480                 "group:dry_grass",
 481                 "default:snow",
 482         },
 483         interval = 6,
 484         chance = 50,
 485         catch_up = false,
 486         action = function(pos, node)
 487                 -- Check for darkness: night, shadow or under a light-blocking node
 488                 -- Returns if ignore above
 489                 local above = {x = pos.x, y = pos.y + 1, z = pos.z}
 490                 if (minetest.get_node_light(above) or 0) < 13 then
 491                         return
 492                 end
 493
 494                 -- Look for spreading dirt-type neighbours
 495                 local p2 = minetest.find_node_near(pos, 1, "group:spreading_dirt_type")
 496                 if p2 then
 497                         local n3 = minetest.get_node(p2)
 498                         minetest.set_node(pos, {name = n3.name})
 499                         return
 500                 end
 501
 502                 -- Else, any seeding nodes on top?
 503                 local name = minetest.get_node(above).name
 504                 -- Snow check is cheapest, so comes first
 505                 if name == "default:snow" then
 506                         minetest.set_node(pos, {name = "default:dirt_with_snow"})
 507                 -- Most likely case first
 508                 elseif minetest.get_item_group(name, "grass") ~= 0 then
 509                         minetest.set_node(pos, {name = "default:dirt_with_grass"})
 510                 elseif minetest.get_item_group(name, "dry_grass") ~= 0 then
 511                         minetest.set_node(pos, {name = "default:dirt_with_dry_grass"})
 512                 end
 513         end
 514 })
 515
 516
 517 --
 518 -- Grass and dry grass removed in darkness
 519 --
 520
 521 minetest.register_abm({
 522         label = "Grass covered",
 523         nodenames = {"group:spreading_dirt_type"},
 524         interval = 8,
 525         chance = 50,
 526         catch_up = false,
 527         action = function(pos, node)
 528                 local above = {x = pos.x, y = pos.y + 1, z = pos.z}
 529                 local name = minetest.get_node(above).name
 530                 local nodedef = minetest.registered_nodes[name]
 531                 if name ~= "ignore" and nodedef and not ((nodedef.sunlight_propagates or
 532                                 nodedef.paramtype == "light") and
 533                                 nodedef.liquidtype == "none") then
 534                         minetest.set_node(pos, {name = "default:dirt"})
 535                 end
 536         end
 537 })
 538
 539
 540 --
 541 -- Moss growth on cobble near water
 542 --
 543
 544 minetest.register_abm({
 545         label = "Moss growth",
 546         nodenames = {"default:cobble", "stairs:slab_cobble", "stairs:stair_cobble", "walls:cobble"},
 547         neighbors = {"group:water"},
 548         interval = 16,
 549         chance = 200,
 550         catch_up = false,
 551         action = function(pos, node)
 552                 if node.name == "default:cobble" then
 553                         minetest.set_node(pos, {name = "default:mossycobble"})
 554                 elseif node.name == "stairs:slab_cobble" then
 555                         minetest.set_node(pos, {name = "stairs:slab_mossycobble", param2 = node.param2})
 556                 elseif node.name == "stairs:stair_cobble" then
 557                         minetest.set_node(pos, {name = "stairs:stair_mossycobble", param2 = node.param2})
 558                 elseif node.name == "walls:cobble" then
 559                         minetest.set_node(pos, {name = "walls:mossycobble", param2 = node.param2})
 560                 end
 561         end
 562 })
 563
 564
 565 --
 566 -- NOTICE: This method is not an official part of the API yet.
 567 -- This method may change in future.
 568 --
 569
 570 function default.can_interact_with_node(player, pos)
 571         if player then
 572                 if minetest.check_player_privs(player, "protection_bypass") then
 573                         return true
 574                 end
 575         else
 576                 return false
 577         end
 578
 579         local meta = minetest.get_meta(pos)
 580         local owner = meta:get_string("owner")
 581
 582         if not owner or owner == "" or owner == player:get_player_name() then
 583                 return true
 584         end
 585
 586         -- Is player wielding the right key?
 587         local item = player:get_wielded_item()
 588         if item:get_name() == "default:key" then
 589                 local key_meta = item:get_meta()
 590
 591                 if key_meta:get_string("secret") == "" then
 592                         local key_oldmeta = item:get_metadata()
 593                         if key_oldmeta == "" or not minetest.parse_json(key_oldmeta) then
 594                                 return false
 595                         end
 596
 597                         key_meta:set_string("secret", minetest.parse_json(key_oldmeta).secret)
 598                         item:set_metadata("")
 599                 end
 600
 601                 return meta:get_string("key_lock_secret") == key_meta:get_string("secret")
 602         end
 603
 604         return false
 605 end