Add animated particle support

Also implements an ignition failure sound.

README.md

@@ -32,6 +32,7 @@ SOFTWARE.
 ### [Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/)
  * `nether_book_`* (files starting with "nether_book"): Treer, 2019
  * `nether_portal_ignition_failure.ogg`: Treer, 2019
+ * `nether_particle_anim`* (files starting with "nether_particle_anim"): Treer, 2019
 
 ### [Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)](http://creativecommons.org/licenses/by-sa/3.0/)
  * `nether_rack.png`: Zeg9

init.lua

@@ -40,7 +40,10 @@ dofile(nether.path .. "/mapgen.lua")
 
 
 -- Portals are ignited by right-clicking with a mese crystal fragment
-nether.register_portal_ignition_item("default:mese_crystal_fragment")
+nether.register_portal_ignition_item(
+	"default:mese_crystal_fragment",
+	{name = "nether_portal_ignition_failure", gain = 0.3}
+)
 
 
 -- Use the Portal API to add a portal type which goes to the Nether
@@ -111,29 +114,34 @@ The expedition parties have found no diamonds or gold, and after an experienced
 		end
 	end,
 
-	on_ignite = function(portalDef, anochorPos, orientation)
+	on_ignite = function(portalDef, anchorPos, orientation)
+
+		-- make some sparks fly
+		local p1, p2 = portalDef.shape:get_p1_and_p2_from_anchorPos(anchorPos, orientation)
+		local pos = vector.divide(vector.add(p1, p2), 2)
+
+		local textureName = portalDef.particle_texture
+		if type(textureName) == "table" then textureName = textureName.name end
 
-		local make_sparks_fly = function(pos)
 		minetest.add_particlespawner({
-				amount = 14,
+			amount = 110,
 			time   = 0.1,
-				minpos = {x = pos.x - 0.25, y = pos.y - 0.25, z = pos.z - 0.25},
-				maxpos = {x = pos.x + 0.25, y = pos.y + 0.25, z = pos.z + 0.25},
+			minpos = {x = pos.x - 0.5, y = pos.y - 1.2, z = pos.z - 0.5},
+			maxpos = {x = pos.x + 0.5, y = pos.y + 1.2, z = pos.z + 0.5},
 			minvel = {x = -5, y = -1, z = -5},
 			maxvel = {x =  5, y =  1, z =  5},
 			minacc = {x =  0, y =  0, z =  0},
 			maxacc = {x =  0, y =  0, z =  0},
 			minexptime = 0.1,
 			maxexptime = 0.5,
-				minsize = 0.2,
-				maxsize = 0.8,
+			minsize = 0.2 * portalDef.particle_texture_scale,
+			maxsize = 0.8 * portalDef.particle_texture_scale,
 			collisiondetection = false,
-				texture = portalDef.particle_texture .. "^[colorize:#F4F:alpha",
+			texture = textureName .. "^[colorize:#F4F:alpha",
+			animation = portalDef.particle_texture_animation,
 			glow = 8
 		})
-		end
 
-		portalDef.shape.apply_func_to_wormhole_nodes(anochorPos, orientation, make_sparks_fly)
 	end
 	
 })

portal_api.lua

@@ -1064,11 +1064,12 @@ function run_wormhole(timerPos, time_elapsed)
 				minacc = {x = 0, y = 0, z = 0},
 				maxacc = {x = 0, y = 0, z = 0},
 				minexptime = 0.5,
-				maxexptime = 1.5,
-				minsize = 0.5,
-				maxsize = 1.5,
+				maxexptime = 1.7,
+				minsize = 0.5 * portal_definition.particle_texture_scale,
+				maxsize = 1.5 * portal_definition.particle_texture_scale,
 				collisiondetection = false,
 				texture   = portal_definition.particle_texture_colored,
+				animation = portal_definition.particle_texture_animation,
 				glow = 5
 			})
 		end
@@ -1421,10 +1422,12 @@ local portaldef_default = {
 	wormhole_node_color        = 0,
 	frame_node_name            = "default:obsidian",
 	particle_texture           = "nether_particle.png",
+	particle_texture_animation = nil,
+	particle_texture_scale     = 1,
 	sounds = {
 		ambient    = {name = "nether_portal_ambient",    gain = 0.6, length = 3},
-		ignite     = {name = "nether_portal_ignite",     gain = 0.5},
-		extinguish = {name = "nether_portal_extinguish", gain = 0.5},
+		ignite     = {name = "nether_portal_ignite",     gain = 0.7},
+		extinguish = {name = "nether_portal_extinguish", gain = 0.6},
 		teleport   = {name = "nether_portal_teleport",   gain = 0.3}
 	}
 }
@@ -1454,9 +1457,15 @@ function nether.register_portal(name, portaldef)
 		portaldef.particle_color = minetest.rgba(rgb.r, rgb.g, rgb.b)
 	end
 	if portaldef.particle_texture_colored == nil then
-		-- Combine the particle texture with the particle color unless a colored particle texture was specified.
+		-- Combine the particle texture with the particle color unless a particle_texture_colored was specified.
+		if type(portaldef.particle_texture) == "table" and portaldef.particle_texture.animation ~= nil then
+			portaldef.particle_texture_colored   = portaldef.particle_texture.name .. "^[colorize:" .. portaldef.particle_color .. ":alpha"
+			portaldef.particle_texture_animation = portaldef.particle_texture.animation
+			portaldef.particle_texture_scale     = portaldef.particle_texture.scale or 1
+		else
 			portaldef.particle_texture_colored   = portaldef.particle_texture .. "^[colorize:" .. portaldef.particle_color .. ":alpha"
 		end
+	end
 
 	if portaldef.find_surface_anchorPos == nil then	-- default to using find_surface_target_y()
 		portaldef.find_surface_anchorPos = function(pos)
@@ -1499,16 +1508,21 @@ function nether.unregister_portal(name)
 	return result
 end
 
-function nether.register_portal_ignition_item(item_name)
+function nether.register_portal_ignition_item(item_name, ignition_failure_sound)
 
 	minetest.override_item(item_name, {
 		on_place = function(stack, _, pt)
+			local done = false
 			if pt.under and is_frame_node[minetest.get_node(pt.under).name] then
-				local done = ignite_portal(pt.under)
+				done = ignite_portal(pt.under)
 				if done and not minetest.settings:get_bool("creative_mode") then
 					stack:take_item()
 				end
 			end
+			if not done and ignition_failure_sound ~= nil then
+				minetest.sound_play(ignition_failure_sound, {pos = pt.under, max_hear_distance = 10})
+			end
+
 
 			return stack
 		end,

portal_api.txt

@@ -48,7 +48,9 @@ Call these functions only at load time:
     * Unregisters the portal from the engine, and deletes the entry with key
       `name` from `nether.registered_portals` and associated internal tables.
     * Returns true on success
-* register_portal_ignition_item(name)
+* register_portal_ignition_item(name, ignition_failure_sound)
+    * ignition_failure_sound is optional, it plays any time an attempt to use 
+      the item occurs if a portal is not ignited.
 
 
 
@@ -82,6 +84,20 @@ Used by `nether.register_portal`.
         -- Optional. Will default to a colour matching the wormhole_node_color
         -- if not specified.
 
+        particle_texture    = "image.png",
+        -- Optional. Animation and particle scale may also be specified, e.g:
+        -- particle_texture = {
+        --      name = "nether_particle_anim1.png",
+        --      animation = {
+        --          type = "vertical_frames",
+        --          aspect_w = 7,
+        --          aspect_h = 7,
+        --          length = 1,
+        --      },
+        --      scale = 1.5
+        --  },      
+        -- See lua_api.txt for Tile Animation definition
+
         frame_node_name     = "default:obsidian",
         -- Required. For best results, have your portal constructed of a 
         -- material nobody else is using.