diff --git a/mods/rp_tnt/API.md b/mods/rp_tnt/API.md index ef6b612..054998c 100644 --- a/mods/rp_tnt/API.md +++ b/mods/rp_tnt/API.md @@ -16,13 +16,14 @@ Note: The `igniter` is only used for logging purposes. ## `tnt.boom(pos, radius, sound)` -High-level TNT explosion. -Immediately blows up a TNT node at `pos`, -removes nodes, drops items, damages entities, spawns particles. +Blows up a TNT node. +This will remove the TNT node, cause an explosion at `pos`, +removes nodes around it, drops items, damages entities, spawns particles +and plays a sound effect. Parameters: -* `pos`: Position of TNT node. The TNT node is required! +* `pos`: Position of the TNT node. The TNT node is required! * `radius`: Explosion radius (default: read from `tnt_radius` setting) * `sound`: Sound name for explosion (default: `tnt_explode`) @@ -30,8 +31,8 @@ Parameters: ## `tnt.boom_notnt(pos, radius, sound, remove_nodes)` -High-level explosion. -Same as `tnt.boom` but works at any position. No TNT required. +Does an explosion. +Same as `tnt.boom` but works for non-TNT nodes as well. No TNT required. Parameters: @@ -41,14 +42,12 @@ Parameters: * `remove_nodes`: If true, will remove nodes, otherwise won't. (default: false) -## `tnt.explode(pos, radius, sound)` +## `tnt.explode(pos, radius)` Low-level explosion. -Immediately removes and drops nodes at `pos` -with a radius `radius` and plays a `sound`. -There are no particle effects nor is ther entity damage or -anything else. +Does a "raw" explosion that only removes nodes and drops items. +There are no particle effects, sounds, entity damage or anything else. +Useful if you want to customize the explosion effects. * `pos`: Center of the explosion -* `radius`: Explosion radius -* `sound`: Explosion sound (NOT optional) +* `radius`: Explosion radius (NO default value!) diff --git a/mods/rp_tnt/init.lua b/mods/rp_tnt/init.lua index 4d89eb3..786c40d 100644 --- a/mods/rp_tnt/init.lua +++ b/mods/rp_tnt/init.lua @@ -208,9 +208,7 @@ end -- TNT ground removal -function tnt.explode(pos, radius, sound) - play_tnt_sound(pos, sound) - +function tnt.explode(pos, radius) local pos = vector.round(pos) local vm = VoxelManip() local pr = PseudoRandom(os.time()) @@ -259,6 +257,7 @@ local function rawboom(pos, radius, sound, remove_nodes, is_tnt) end if remove_nodes then local drops = tnt.explode(pos, tnt_radius, sound) + play_tnt_sound(pos, sound) if is_tnt then minetest.log("action", "[rp_tnt] TNT exploded at "..minetest.pos_to_string(pos, 0)) else