@jtff/miztemplate-lib 3.7.1 → 3.7.3

package/lua/lib/{Splash_Damage_3.0.lua → Splash_Damage_main.lua}

@@ -1,5 +1,17 @@
 --[[
-
+    04 April 2025 (Stevey666) - 3.1
+	  - Set default cluster munitions option to false, set this to true in the options if you want it
+          - Added missing radio commands for Cascade Scaling
+	  - Adjust default cascading to 2 (from 1)
+	  - Adjusted Ural-4320 to be a tanker and ammo carrier for cargo cookoff
+	  - Prevent weapons not in the list from being tracked
+	  - Moved some logging behind the debug mode flag
+	  - Ordnance Protection, added a max height ordnance protection will snap explosion to ground
+	  - Ordnance Protection, fixed enable/disable option
+	  - Added Giant Explosion feature
+	  - Adjusted some hydra70 values on recom. from ETBSmorgan
+	  
+	  
     09 March 2025 (Stevey666) - 3.0
       - Added ordinance protection gives a few options - stop the additional larger_explosion that tends to blow up your own bombs if theyre dropped at the same place if its within x m
 	  - Additional ordnance protection option that will cause a snap to ground larger_explosion if its within x meters of a recent larger explosion and within x seconds (can set in options)
@@ -79,8 +91,7 @@ splash_damage_options = {
     ["game_messages"] = false, --enable some messages on screen
     ["debug"] = false,  --enable debugging messages 
     ["weapon_missing_message"] = false, --false disables messages alerting you to weapons missing from the explTable
-    
-	["track_pre_explosion_debug"] = false, --Toggle to enable/disable pre-explosion tracking debugging
+    ["track_pre_explosion_debug"] = false, --Toggle to enable/disable pre-explosion tracking debugging
 	
     ["enable_radio_menu"] = true, --enables the in-game radio menu for modifying settings
     
@@ -104,7 +115,7 @@ splash_damage_options = {
     ["use_dynamic_blast_radius"] = true,   --if true, blast radius is calculated from explosion power; if false, blast_search_radius (90) is used
     ["dynamic_blast_radius_modifier"] = 2,  --multiplier for the blast radius
     
-    ["cascade_scaling"] = 1,    --multiplier for secondary (cascade) blast damage, 1 damage fades out too soon, 3 damage seems a good balance
+    ["cascade_scaling"] = 2,    --multiplier for secondary (cascade) blast damage, 1 damage fades out too soon, 2 or 3 damage seems a good balance
     ["cascade_explode_threshold"] = 60,   --only trigger cascade explosion if the unit's current health is <= this percent of its maximum, setting can help blow nearby jeeps but not tanks
     ["always_cascade_explode"] = false, --switch if you want everything to explode like with the original script
     
@@ -123,20 +134,30 @@ splash_damage_options = {
     ["ordnance_protection_radius"] = 10, --Distance in meters to protect nearby bombs
     ["detect_ordnance_destruction"] = true, --Toggle detection of ordnance destroyed by large explosions
     ["snap_to_ground_if_destroyed_by_large_explosion"] = true, --If the ordnance protection fails or is disabled we can snap larger_explosions to the ground (if enabled - power as set in weapon list) - so an explosion still does hit the ground
+    ["max_snapped_height"] = 80, --max height it will snap to ground from
     ["recent_large_explosion_snap"] = true, --enable looking for a recent large_explosion generated by the script
-    ["recent_large_explosion_range"] = 200, --range its looking for in meters for a recent large_explosion generated by the script
+    ["recent_large_explosion_range"] = 100, --range its looking for in meters for a recent large_explosion generated by the script
     ["recent_large_explosion_time"] = 4, --in seconds how long ago there was a recent large_explosion generated by the script
 
-    -- Cluster bomb settings
+    --Cluster bomb settings
     ["cluster_enabled"] = false,
-    ["cluster_base_length"] = 150,           -- Base forward spread (meters)
-    ["cluster_base_width"] = 200,            -- Base lateral spread (meters)
-    ["cluster_max_length"] = 300,            -- Max forward spread (meters)
-    ["cluster_max_width"] = 400,             -- Max lateral spread (meters)
-    ["cluster_min_length"] = 100,            -- Min forward spread
-    ["cluster_min_width"] = 150,             -- Min lateral spread
-    ["cluster_bomblet_reductionmodifier"] = true, -- Use equation to reduce number of bomblets (to make it look better)
-    ["cluster_bomblet_damage_modifier"] = 1,  -- Adjustable global modifier for bomblet explosive power
+    ["cluster_base_length"] = 150,           --Base forward spread (meters)
+    ["cluster_base_width"] = 200,            --Base lateral spread (meters)
+    ["cluster_max_length"] = 300,            --Max forward spread (meters)
+    ["cluster_max_width"] = 400,             --Max lateral spread (meters)
+    ["cluster_min_length"] = 100,            --Min forward spread
+    ["cluster_min_width"] = 150,             --Min lateral spread
+    ["cluster_bomblet_reductionmodifier"] = true, --Use equation to reduce number of bomblets (to make it look better)
+    ["cluster_bomblet_damage_modifier"] = 1,  --Adjustable global modifier for bomblet explosive power
+	
+	--Giant Explosion Options - Remember, any target you want to blow up needs to be named "GiantExplosionTarget(X)"  (X) being any value/name etc
+    ["giant_explosion_enabled"] = true,  --Toggle to enable/disable Giant Explosion
+    ["giant_explosion_power"] = 6000,    --Power in kg of TNT (default 8 tons)
+    ["giant_explosion_scale"] = 1,     --Size scale factor (default 1)
+    ["giant_explosion_duration"] = 3.0,  --Total duration in seconds (default 3s)
+    ["giant_explosion_count"] = 250,      --Number of explosions (default 300)
+    ["giant_explosion_target_static"] = true, --Toggle to true for static targets (store position once), false for dynamic (update every second)
+    ["giant_explosion_poll_rate"] = 1,    --Polling rate in seconds for flag checks (default 1s)
 }
 
 local script_enable = 1
@@ -198,7 +219,7 @@ flamesize:
     --3) Refueler ATZ-10
     ["ATZ-10"] = {
         cargoExplosion = true,
-        cargoExplosionMult = 1.8,
+        cargoExplosionMult = 2,
 		cargoExplosionPower = 200,
         cargoCookOff = false,
         cookOffCount = 0,
@@ -258,7 +279,7 @@ flamesize:
         flameSize = 1,
         flameDuration = 30,
     },
-
+--#Technically this is both ammo and fuel looking at the model
     ["Ural-4320"] = {
         cargoExplosion = true,
         cargoExplosionMult = 1,
@@ -269,7 +290,7 @@ flamesize:
         cookOffDuration = 20,
         cookOffRandomTiming = true,
         cookOffPowerRandom = 50,
-        isTanker = false,
+        isTanker = true,
         flameSize = 1,
         flameDuration = 30,
     },
@@ -499,7 +520,7 @@ explTable = {
     ["HYDRA_70_MK5"] = { explosive = 8, shaped_charge = false },
     ["HYDRA_70_M151"] = { explosive = 5, shaped_charge = false },
     ["HYDRA_70_M151_M433"] = { explosive = 5, shaped_charge = false },
-    ["HYDRA_70_M229"] = { explosive = 5, shaped_charge = false },
+    ["HYDRA_70_M229"] = { explosive = 10, shaped_charge = false },
     ["FFAR Mk1 HE"] = { explosive = 5, shaped_charge = false },
     ["FFAR Mk5 HEAT"] = { explosive = 8, shaped_charge = false },
     ["HVAR"] = { explosive = 5, shaped_charge = false },
@@ -551,7 +572,7 @@ explTable = {
     ["AGR_20"] = { explosive = 8, shaped_charge = false },
     ["AGR_20A"] = { explosive = 8, shaped_charge = false },
     ["AGR_20_M282"] = { explosive = 8, shaped_charge = false },
-    ["Hydra_70_M282_MPP"] = { explosive = 8, shaped_charge = false },
+    ["Hydra_70_M282_MPP"] = { explosive = 5, shaped_charge = true },
     ["BRM-1_90MM"] = { explosive = 8, shaped_charge = false },
 }
 
@@ -646,12 +667,346 @@ local function calculate_dispersion(velocity, burst_altitude)
     return math.max(splash_damage_options.cluster_min_length, math.min(splash_damage_options.cluster_max_length, length_jitter)),
            math.max(splash_damage_options.cluster_min_width, math.min(splash_damage_options.cluster_max_width, width_jitter))
 end
-----[[ ##### End of HELPER/UTILITY FUNCTIONS ##### ]]----
 
+
+
+
+
+
+
+
+
+----[[ ##### End of HELPER/UTILITY FUNCTIONS ##### ]]----
+giantExplosionTargets = {}
 cargoEffectsQueue = {}
 WpnHandler = {}
+tracked_target_position = nil --Store the last known position of TargetUnit for giant explosion
 tracked_weapons = {}
 local processedUnitsGlobal = {}
+
+function scanGiantExplosionTargets()
+    giantExplosionTargets = {}
+    local function findTargets(obj)
+        if obj:isExist() then
+            local name = obj:getName()
+            if string.find(name, "GiantExplosionTarget") then
+                local flagName = string.gsub(name, "Target", "")
+                table.insert(giantExplosionTargets, {
+                    name = name,
+                    flag = flagName,
+                    obj = obj,
+                    pos = obj:getPoint(),
+                    static = splash_damage_options.giant_explosion_target_static
+                })
+            end
+        end
+        return true
+    end
+    world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, {id = world.VolumeType.ALL}, findTargets)
+    if not splash_damage_options.giant_explosion_target_static then
+        timer.scheduleFunction(updateGiantExplosionPositions, {}, timer.getTime() + 1.0)
+    end
+end
+
+function updateTargetPosition()
+    for name, target in pairs(giantExplosionTargets) do
+        if target.obj:isExist() then
+            target.pos = target.obj:getPosition().p
+        end
+    end
+    return timer.getTime() + 1.0
+end
+
+
+--Giant Explosion Function
+function triggerGiantExplosion(params)
+    if not splash_damage_options.giant_explosion_enabled then
+        debugMsg("Giant Explosion is disabled in options.")
+        return
+    end
+
+    local initialPos = params.pos or {x = 0, y = 0, z = 0}
+    local explosionPower = params.power or splash_damage_options.giant_explosion_power
+    local sizeScale = params.scale or splash_damage_options.giant_explosion_scale
+    local totalDuration = params.duration or splash_damage_options.giant_explosion_duration
+    local explosionCount = params.count or splash_damage_options.giant_explosion_count
+
+    if not initialPos.x or not initialPos.y or not initialPos.z then
+        gameMsg("Error: Invalid position for giant explosion!")
+        debugMsg("No valid initial position set for giant explosion!")
+        return
+    end
+
+    debugMsg("Triggering giant fireball at X: " .. initialPos.x .. ", Y: " .. initialPos.y .. ", Z: " .. initialPos.z)
+
+    local function scheduleExplosion(pos, delay)
+        if not pos or not pos.x or not pos.y or not pos.z then
+            debugMsg("Error: Invalid position for explosion - pos: " .. tostring(pos))
+            return
+        end
+        timer.scheduleFunction(function(p)
+            if p and p.x and p.y and p.z then
+                trigger.action.explosion(p, explosionPower)
+            end
+        end, pos, timer.getTime() + delay)
+    end
+
+    -- Pre-explosion scan for cargo units
+    local scanRadius = 1500 * sizeScale -- 1500m base radius, scaled by sizeScale
+    local preExplosionTargets = {}
+    if splash_damage_options.enable_cargo_effects then
+        local volS = {
+            id = world.VolumeType.SPHERE,
+            params = { point = initialPos, radius = scanRadius }
+        }
+        local ifFound = function(foundObject)
+            if foundObject:isExist() then
+                local category = foundObject:getCategory()
+                if (category == Object.Category.UNIT and foundObject:getDesc().category == Unit.Category.GROUND_UNIT) or
+                   category == Object.Category.STATIC then
+                    table.insert(preExplosionTargets, {
+                        name = foundObject:getTypeName(),
+                        health = foundObject:getLife() or 0,
+                        position = foundObject:getPoint(),
+                        maxHealth = (category == Object.Category.UNIT and foundObject:getDesc().life) or foundObject:getLife() or 0,
+                        unit = foundObject
+                    })
+                end
+            end
+            return true
+        end
+        world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, volS, ifFound)
+        debugMsg("Pre-explosion scan for Giant Explosion: " .. #preExplosionTargets .. " targets found within " .. scanRadius .. "m")
+    end
+    -- Trigger the explosion
+    local maxRadius = 200 * sizeScale
+    local maxHeight = 500 * sizeScale
+    local adjustedExplosionCount = math.floor(explosionCount * (sizeScale ^ 2.5))
+    local stepTime = totalDuration / adjustedExplosionCount
+    local variance = 0.25 --Fixed at 25%
+
+    for i = 1, adjustedExplosionCount do
+        local progress = i / adjustedExplosionCount
+        local currentRadius = maxRadius * progress
+        local r = currentRadius * (0.9 + math.random() * 0.1)
+        local theta = math.random() * 2 * math.pi
+        local phi = math.acos(math.random())
+
+        local offsetX = r * math.sin(phi) * math.cos(theta)
+        local offsetZ = r * math.sin(phi) * math.sin(theta)
+        local offsetY = r * math.cos(phi)
+
+        offsetX = offsetX * (1 + (math.random() - 0.5) * variance)
+        offsetZ = offsetZ * (1 + (math.random() - 0.5) * variance)
+        offsetY = offsetY * (1 + (math.random() - 0.5) * variance * 0.5)
+
+        local blastPos = {
+            x = initialPos.x + offsetX,
+            y = land.getHeight({x = initialPos.x, y = initialPos.z}) + offsetY,
+            z = initialPos.z + offsetZ
+        }
+        if blastPos.y < land.getHeight({x = blastPos.x, y = blastPos.z}) then
+            blastPos.y = land.getHeight({x = blastPos.x, y = blastPos.z})
+        end
+
+        local delay = (i - 1) * stepTime + (math.random() - 0.5) * stepTime * variance
+        scheduleExplosion(blastPos, delay)
+    end
+
+    gameMsg("Expanding giant fireball over " .. totalDuration .. "s (scale " .. sizeScale .. ")!")
+
+    -- Post-explosion scan and cargo cook-off queuing
+    if splash_damage_options.enable_cargo_effects then
+        timer.scheduleFunction(function(args)
+            local centerPos = args[1]
+            local radius = args[2]
+            local preTargets = args[3]
+
+            local postExplosionTargets = {}
+            local volS = {
+                id = world.VolumeType.SPHERE,
+                params = { point = centerPos, radius = radius }
+            }
+            local ifFound = function(foundObject)
+                if foundObject:isExist() then
+                    local category = foundObject:getCategory()
+                    if (category == Object.Category.UNIT and foundObject:getDesc().category == Unit.Category.GROUND_UNIT) or
+                       category == Object.Category.STATIC then
+                        table.insert(postExplosionTargets, {
+                            name = foundObject:getTypeName(),
+                            health = foundObject:getLife() or 0,
+                            position = foundObject:getPoint(),
+                            maxHealth = (category == Object.Category.UNIT and foundObject:getDesc().life) or foundObject:getLife() or 0
+                        })
+                    end
+                end
+                return true
+            end
+            world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, volS, ifFound)
+            debugMsg("Post-explosion scan for Giant Explosion: " .. #postExplosionTargets .. " targets found within " .. radius .. "m")
+
+            -- Compare pre- and post-explosion targets
+            for _, preTarget in ipairs(preTargets) do
+                local found = false
+                local postHealth = 0
+                for _, postTarget in ipairs(postExplosionTargets) do
+                    if preTarget.name == postTarget.name and getDistance(preTarget.position, postTarget.position) < 1 then
+                        found = true
+                        postHealth = postTarget.health
+                        break
+                    end
+                end
+
+                local cargoData = cargoUnits[preTarget.name]
+                if cargoData and (not found or postHealth <= 0) then
+                    local distance = getDistance(initialPos, preTarget.position)
+                    if distance <= radius then
+                        local cargoPower = cargoData.cargoExplosionPower or explosionPower
+                        table.insert(cargoEffectsQueue, {
+                            name = preTarget.name,
+                            distance = distance,
+                            coords = preTarget.position,
+                            power = cargoPower,
+                            explosion = cargoData.cargoExplosion,
+                            cookOff = cargoData.cargoCookOff,
+                            cookOffCount = cargoData.cookOffCount,
+                            cookOffPower = cargoData.cookOffPower,
+                            cookOffDuration = cargoData.cookOffDuration,
+                            cookOffRandomTiming = cargoData.cookOffRandomTiming,
+                            cookOffPowerRandom = cargoData.cookOffPowerRandom,
+                            isTanker = cargoData.isTanker,
+                            flameSize = cargoData.flameSize,
+                            flameDuration = cargoData.flameDuration
+                        })
+                        debugMsg("Queued cargo effect for " .. preTarget.name .. " destroyed by Giant Explosion at " .. string.format("%.1f", distance) .. "m")
+                    end
+                end
+            end
+
+            -- Process queued cargo effects with prioritized flames
+            if #cargoEffectsQueue > 0 then
+                local flameIndex = 0 -- Separate index for flames
+                local otherIndex = 0 -- Index for explosions, cook-offs, debris
+                local processedCargoUnits = {}
+                local flamePositions = {}
+                for _, effect in ipairs(cargoEffectsQueue) do
+                    local unitKey = effect.name .. "_" .. effect.coords.x .. "_" .. effect.coords.z
+                    if not processedUnitsGlobal[unitKey] and not processedCargoUnits[unitKey] then
+                        -- Handle tanker flames first with minimal delay
+                        if effect.isTanker and effect.explosion then
+                            debugMsg("Triggering cargo explosion for tanker " .. effect.name .. " at " .. string.format("%.1f", effect.distance) .. "m with power " .. effect.power .. " scheduled at " .. flameIndex .. "s")
+                            timer.scheduleFunction(function(params)
+                                debugMsg("Executing cargo explosion at X: " .. string.format("%.0f", params[1].x) .. ", Y: " .. string.format("%.0f", params[1].y) .. ", Z: " .. string.format("%.0f", params[1].z) .. " with power " .. params[2])
+                                trigger.action.explosion(params[1], params[2])
+                            end, {effect.coords, effect.power}, timer.getTime() + flameIndex + 0.1)
+
+                                local flameSize = effect.flameSize or 3
+                                local flameDuration = effect.flameDuration
+                                local flameDensity = 1.0
+                                local effectId = effectSmokeId
+                                effectSmokeId = effectSmokeId + 1
+                                local isDuplicate = false
+                                for _, pos in pairs(flamePositions) do
+                                    if getDistance3D(effect.coords, pos) < 3 then
+                                        isDuplicate = true
+                                        debugMsg("Skipping duplicate flame for " .. effect.name .. " near X: " .. string.format("%.0f", pos.x) .. ", Y: " .. string.format("%.0f", pos.y) .. ", Z: " .. string.format("%.0f", pos.z))
+                                        break
+                                    end
+                                end
+                                if not isDuplicate then
+                                debugMsg("Adding flame effect for tanker " .. effect.name .. " at " .. string.format("%.1f", effect.distance) .. "m (Size: " .. flameSize .. ", Duration: " .. flameDuration .. "s, ID: " .. effectId .. ") scheduled at " .. flameIndex .. "s")
+                                    timer.scheduleFunction(function(params)
+                                        local terrainHeight = land.getHeight({x = params[1].x, y = params[1].z})
+                                        local adjustedCoords = {x = params[1].x, y = terrainHeight + 2, z = params[1].z}
+                                        debugMsg("Spawning flame effect at X: " .. string.format("%.0f", adjustedCoords.x) .. ", Y: " .. string.format("%.0f", adjustedCoords.y) .. ", Z: " .. string.format("%.0f", adjustedCoords.z))
+                                        trigger.action.explosion(adjustedCoords, 10) -- Small trigger explosion
+                                        trigger.action.effectSmokeBig(adjustedCoords, params[2], params[3], params[4])
+                                end, {effect.coords, flameSize, flameDensity, effectId}, timer.getTime() + flameIndex + 0.2)
+                                    timer.scheduleFunction(function(id)
+                                        debugMsg("Stopping flame effect for " .. effect.name .. " (ID: " .. id .. ")")
+                                        trigger.action.effectSmokeStop(id)
+                                end, effectId, timer.getTime() + flameIndex + flameDuration + 0.2)
+                                    table.insert(flamePositions, effect.coords)
+                                end
+                            flameIndex = flameIndex + 0.5 -- Fast spacing for flames (0.5s)
+                            end
+                        -- Handle non-tanker explosions, cook-offs, and debris
+                        if not effect.isTanker or (effect.explosion and not effect.isTanker) then
+                            if effect.explosion then
+                                debugMsg("Triggering cargo explosion for " .. effect.name .. " at " .. string.format("%.1f", effect.distance) .. "m with power " .. effect.power .. " scheduled at " .. otherIndex .. "s")
+                                timer.scheduleFunction(function(params)
+                                    debugMsg("Executing cargo explosion at X: " .. string.format("%.0f", params[1].x) .. ", Y: " .. string.format("%.0f", params[1].y) .. ", Z: " .. string.format("%.0f", params[1].z) .. " with power " .. params[2])
+                                    trigger.action.explosion(params[1], params[2])
+                                end, {effect.coords, effect.power}, timer.getTime() + otherIndex + 0.1)
+                        end
+                        if effect.cookOff and effect.cookOffCount > 0 then
+                                debugMsg("Scheduling " .. effect.cookOffCount .. " cook-off explosions for " .. effect.name .. " at " .. string.format("%.1f", effect.distance) .. "m over " .. effect.cookOffDuration .. "s starting at " .. otherIndex .. "s")
+                            for i = 1, effect.cookOffCount do
+                                local delay = effect.cookOffRandomTiming and math.random() * effect.cookOffDuration or (i - 1) * (effect.cookOffDuration / effect.cookOffCount)
+                                local basePower = effect.cookOffPower
+                                local powerVariation = effect.cookOffPowerRandom / 100
+                                local cookOffPower = effect.cookOffPowerRandom == 0 and basePower or basePower * (1 + powerVariation * (math.random() * 2 - 1))
+                                debugMsg("Cook-off #" .. i .. " for " .. effect.name .. " at " .. string.format("%.1f", effect.distance) .. "m scheduled at " .. string.format("%.3f", delay) .. "s with power " .. string.format("%.2f", cookOffPower))
+                                timer.scheduleFunction(function(params)
+                                    debugMsg("Executing cook-off at X: " .. string.format("%.0f", params[1].x) .. ", Y: " .. string.format("%.0f", params[1].y) .. ", Z: " .. string.format("%.0f", params[1].z) .. " with power " .. params[2])
+                                    trigger.action.explosion(params[1], params[2])
+                                    end, {effect.coords, cookOffPower}, timer.getTime() + otherIndex + delay)
+                            end
+                            if splash_damage_options.debris_effects then
+                                local debrisCount = math.random(splash_damage_options.debris_count_min, splash_damage_options.debris_count_max)
+                                for j = 1, debrisCount do
+                                    local theta = math.random() * 2 * math.pi
+                                    local phi = math.acos(math.random() * 2 - 1)
+                                    local minDist = splash_damage_options.debris_max_distance * 0.1
+                                    local maxDist = splash_damage_options.debris_max_distance
+                                    local r = math.random() * (maxDist - minDist) + minDist
+                                    local debrisX = effect.coords.x + r * math.sin(phi) * math.cos(theta)
+                                    local debrisZ = effect.coords.z + r * math.sin(phi) * math.sin(theta)
+                                    local terrainY = land.getHeight({x = debrisX, y = debrisZ})
+                                    local debrisY = terrainY + math.random() * maxDist
+                                    local debrisPos = {x = debrisX, y = debrisY, z = debrisZ}
+                                    local debrisPower = splash_damage_options.debris_power
+                                    local debrisDelay = (j - 1) * (effect.cookOffDuration / debrisCount)
+                                    timer.scheduleFunction(function(debrisArgs)
+                                        debugMsg("Debris explosion at X: " .. string.format("%.0f", debrisArgs[1].x) .. ", Y: " .. string.format("%.0f", debrisArgs[1].y) .. ", Z: " .. string.format("%.0f", debrisArgs[1].z) .. " with power " .. debrisArgs[2])
+                                        trigger.action.explosion(debrisArgs[1], debrisArgs[2])
+                                        end, {debrisPos, debrisPower}, timer.getTime() + otherIndex + debrisDelay)
+                                    end
+                                end
+                            end
+                            otherIndex = otherIndex + 1 -- Slower spacing for non-flame effects (1s)
+                        end
+                        processedCargoUnits[unitKey] = true
+                        processedUnitsGlobal[unitKey] = true
+                    end
+                end
+                cargoEffectsQueue = {} -- Clear the queue after processing
+            end
+        end, {initialPos, scanRadius, preExplosionTargets}, timer.getTime() + totalDuration + 1.0)
+    end
+end
+
+--Flag Checker for mission editor
+function checkGiantExplosionFlag()
+    for name, target in pairs(giantExplosionTargets) do
+        local flagName = name:gsub("GiantExplosionTarget", "GiantExplosionTarget")
+        local flagValue = trigger.misc.getUserFlag(flagName)
+        --commenting out as it spams every second 
+		debugMsg("Checking flag " .. flagName .. ": " .. flagValue)
+        if flagValue == 1 then
+            debugMsg("Triggering explosion for " .. name .. " at X:" .. target.pos.x .. " Y:" .. target.pos.y .. " Z:" .. target.pos.z)
+            triggerGiantExplosion({
+                pos = target.pos,
+                power = splash_damage_options.giant_explosion_power,
+                scale = splash_damage_options.giant_explosion_scale,
+                duration = splash_damage_options.giant_explosion_duration,
+                count = splash_damage_options.giant_explosion_count
+            })
+            trigger.action.setUserFlag(flagName, 2)
+        end
+    end
+    return timer.getTime() + splash_damage_options.giant_explosion_poll_rate
+end
   
 function getWeaponExplosive(name)
     local weaponData = explTable[name]
@@ -678,7 +1033,7 @@ function track_wpns_cluster_scan(args)
     }
     local bombletsFound = {}
     local allWeaponsFound = {}
-    -- General scan for all weapons
+    --General scan for all weapons
     world.searchObjects(Object.Category.WEAPON, scanVol, function(wpn)
         if wpn:isExist() then
             local wpnId = wpn.id_
@@ -700,7 +1055,7 @@ function track_wpns_cluster_scan(args)
         end
         return true
     end)
-    -- Log results
+    --Log results
     debugMsg("Scanned for submunition '" .. subName .. "' bomblets from '" .. parentName .. "': " .. #bombletsFound .. " found (Attempt " .. attempt .. ")")
     if #allWeaponsFound > 0 then
         local msg = "General scan for '" .. parentName .. "': " .. #allWeaponsFound .. " bomblets released, expected " .. subCount .. " '" .. subName .. "'"
@@ -722,7 +1077,7 @@ function track_wpns_cluster_scan(args)
     elseif #bombletsFound == 0 and #allWeaponsFound == 0 then
         debugMsg("No bomblets of any type detected for '" .. parentName .. "' (Attempt " .. attempt .. ")")
     end
-    -- Retry if no expected submunitions found
+    --Retry if no expected submunitions found
     if #bombletsFound == 0 and attempt < maxAttempts then
         debugMsg("No expected submunition '" .. subName .. "' found on attempt " .. attempt .. ", retrying in 0.5s")
         timer.scheduleFunction(track_wpns_cluster_scan, {parentPos, parentDir, parentName, subName, subCount, subPower, parentVel, attempt + 1}, timer.getTime() + 0.5)
@@ -797,7 +1152,7 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
                 --Tight scan while weapon exists
                 --local tightRadius = 50
                 --if splash_damage_options.use_dynamic_blast_radius then
-                -- tightRadius = math.pow(explosionPower, 1/3) * 5 * splash_damage_options.dynamic_blast_radius_modifier
+                --tightRadius = math.pow(explosionPower, 1/3) * 5 * splash_damage_options.dynamic_blast_radius_modifier
                 --end
 				local tightRadius = blastRadius --Use already calculated blastRadius
                 local volS = {
@@ -921,7 +1276,7 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
 
                 --Store pre-explosion state of all tracked weapons for detection
                 local preExplosionWeapons = {}
-                if splash_damage_options.detect_ordnance_destruction and splash_damage_options.larger_explosions then
+                if splash_damage_options.ordnance_protection and splash_damage_options.detect_ordnance_destruction and splash_damage_options.larger_explosions then
                     for id, data in pairs(tracked_weapons) do
                         if data.wpn:isExist() then
                             preExplosionWeapons[id] = {
@@ -948,7 +1303,7 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
 							if submunitionCount > 60 then submunitionCount = 60 end --Cap at 60
 						end
 					end
-                        -- Extended scan with general bomblet detection
+                        --Extended scan with general bomblet detection
                     timer.scheduleFunction(track_wpns_cluster_scan, {explosionPoint, wpnData.dir, wpnData.name, submunitionName, submunitionCount, submunitionPower, wpnData.speed}, timer.getTime() + 0.3)
 			else
 				--Standard explosion handling
@@ -961,7 +1316,7 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
 				blastWave(explosionPoint, splash_damage_options.blast_search_radius, wpnData.ordnance, explosionPower, isShapedCharge)
 			end
             --detect_ordnance_destruction comes before recent_large_explosion_snap in original
-            if splash_damage_options.detect_ordnance_destruction and splash_damage_options.larger_explosions then
+            if splash_damage_options.ordnance_protection and splash_damage_options.detect_ordnance_destruction and splash_damage_options.larger_explosions then
                 timer.scheduleFunction(function(args)
                     local explosionPoint = args[1]
                     local blastRadius = args[2]
@@ -997,19 +1352,20 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
                 end, {explosionPoint, blastRadius, wpnData.name, preExplosionWeapons}, timer.getTime() + 0.2)
             end
             --recent_large_explosion_snap comes after main explosion and detect_ordnance_destruction
-                    if splash_damage_options.larger_explosions and splash_damage_options.recent_large_explosion_snap then
+                    if splash_damage_options.ordnance_protection and splash_damage_options.larger_explosions and splash_damage_options.recent_large_explosion_snap and splash_damage_options.snap_to_ground_if_destroyed_by_large_explosion then
                         local currentTime = timer.getTime()
                         for id, data in pairs(tracked_weapons) do
                             if id ~= wpn_id_ and not data.wpn:isExist() then
                                 local terrainHeight = land.getHeight({x = data.pos.x, y = data.pos.z})
-            			local isMidAir = data.pos.y > terrainHeight + 5
+			        local weaponHeight = data.pos.y - terrainHeight --Calculate height above ground
+			        local isMidAir = weaponHeight > 5 --Still checks if above ground
                                     local snapTriggered = false
                                     for _, explosion in ipairs(recentExplosions) do
                                         local timeDiff = currentTime - explosion.time
                                         local distance = getDistance3D(data.pos, explosion.pos)
                                         debugMsg("Checking " .. data.name .. " at X: " .. data.pos.x .. ", Y: " .. data.pos.y .. ", Z: " .. data.pos.z .. " against explosion at X: " .. explosion.pos.x .. ", Y: " .. explosion.pos.y .. ", Z: " .. explosion.pos.z .. " - Distance: " .. distance .. "m, TimeDiff: " .. timeDiff .. "s")
                                         if timeDiff <= splash_damage_options.recent_large_explosion_time and distance <= splash_damage_options.recent_large_explosion_range then
-                                            if isMidAir then
+                    				if isMidAir and weaponHeight <= splash_damage_options.max_snapped_height then --New height check
                                                 local groundPos = { x = data.pos.x, y = terrainHeight, z = data.pos.z }
                                                 local destroyedWeaponPower, isShapedCharge = getWeaponExplosive(data.name)
                                                 destroyedWeaponPower = destroyedWeaponPower * splash_damage_options.overall_scaling
@@ -1019,11 +1375,13 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
                                                 if splash_damage_options.apply_shaped_charge_effects and isShapedCharge then
                                                     destroyedWeaponPower = destroyedWeaponPower * splash_damage_options.shaped_charge_multiplier
                                                 end
-                                    debugMsg("Weapon " .. data.name .. " detected recent large explosion within " .. splash_damage_options.recent_large_explosion_range .. "m and " .. splash_damage_options.recent_large_explosion_time .. "s, snapping to ground at X: " .. string.format("%.0f", groundPos.x) .. ", Y: " .. string.format("%.0f", groundPos.y) .. ", Z: " .. string.format("%.0f", groundPos.z) .. " with power " .. destroyedWeaponPower)
+                        debugMsg("Weapon " .. data.name .. " detected recent large explosion within " .. splash_damage_options.recent_large_explosion_range .. "m and " .. splash_damage_options.recent_large_explosion_time .. "s, snapping to ground at X: " .. string.format("%.0f", groundPos.x) .. ", Y: " .. string.format("%.0f", groundPos.y) .. ", Z: " .. string.format("%.0f", groundPos.z) .. " with power " .. destroyedWeaponPower .. " (Height: " .. string.format("%.0f", weaponHeight) .. "m)")
                                                 trigger.action.explosion(groundPos, destroyedWeaponPower)
                                                 snapTriggered = true
                                                 table.insert(weaponsToRemove, id)
                                                 break
+                    elseif isMidAir then
+                        debugMsg("Weapon " .. data.name .. " destroyed above max_snapped_height (" .. splash_damage_options.max_snapped_height .. "m) at " .. string.format("%.0f", weaponHeight) .. "m, skipping snap")
                                             else
                                                 debugMsg("Weapon " .. data.name .. " impacted ground within recent_large_explosion_range (" .. splash_damage_options.recent_large_explosion_range .. "m) and time (" .. splash_damage_options.recent_large_explosion_time .. "s), no snap needed")
                                     snapTriggered = true
@@ -1066,7 +1424,9 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
                 local chosenTargets = args[6]
                 local weaponName = args[7]
                 local wpnData = args[8]
+    		if splash_damage_options.debug then
                     debugMsg("Starting impact handling for " .. weaponName .. " at " .. timer.getTime() .. "s")
+    		end
                     local status, err = pcall(function()
                 --Log pre-explosion targets
                 if splash_damage_options.track_pre_explosion then
@@ -1093,7 +1453,9 @@ world.searchObjects({Object.Category.UNIT, Object.Category.STATIC}, tickVol, fun
                         local preExplosionTargets = innerArgs[3] or {}
                         local weaponName = innerArgs[4]
                         local weaponPower = innerArgs[5]
+						    if splash_damage_options.debug == true then
                                 debugMsg("Starting post-explosion analysis for " .. weaponName .. " at " .. timer.getTime() .. "s")
+							end
 
                         --Scan all units in wider radius
                         local postExplosionTargets = {}
@@ -1366,32 +1728,37 @@ function onWpnEvent(event)
         if event.weapon then
                 local ordnance = event.weapon
                 local typeName = trim(ordnance:getTypeName())
+            if splash_damage_options.debug then
                 env.info("Weapon fired: [" .. typeName .. "]")
                 debugMsg("Weapon fired: [" .. typeName .. "]")
-  
+            end
                 if string.find(typeName, "weapons.shells") then 
+                if splash_damage_options.debug then
                     debugMsg("Event shot, but not tracking: " .. typeName)
                 env.info("SplashDamage: event shot, but not tracking: " .. typeName .. " (" .. event.initiator:getTypeName() .. ")")
+		end
                     return
                 end
   
+            --Check if weapon is in explTable before tracking
                 if not explTable[typeName] then
                 env.info("SplashDamage: " .. typeName .. " missing from script (" .. event.initiator:getTypeName() .. ")")
                     if splash_damage_options.weapon_missing_message == true then
                         trigger.action.outText("SplashDamage: " .. typeName .. " missing from script (" .. (event.initiator and event.initiator:isExist() and event.initiator:getTypeName() or "no initiator") .. ")", 3)
-  --                  if mist and mist.utils and mist.utils.tableShow then --Only if MiST is present
- --                       local success, desc = pcall(mist.utils.tableShow, ordnance:getDesc())
- --                       if success then
---                            debugMsg("desc for [" .. typeName .. "]: " .. desc)
- --                       else
- --                           debugMsg("Could not retrieve description for [" .. typeName .. "]. Object may no longer exist.")
- --                       end
---                    end
+  --                if mist and mist.utils and mist.utils.tableShow then --Only if MiST is present
+ --                     local success, desc = pcall(mist.utils.tableShow, ordnance:getDesc())
+ --                     if success then
+--                          debugMsg("desc for [" .. typeName .. "]: " .. desc)
+ --                     else
+ --                         debugMsg("Could not retrieve description for [" .. typeName .. "]. Object may no longer exist.")
+ --                     end
+--                  end
                         env.info("Current keys in explTable:")
                         for k, v in pairs(explTable) do
                             env.info("Key: [" .. k .. "]")
                         end
                     end
+                return --Skip tracking this weapon since its not in the table
                 end
   
             if (ordnance:getDesc().category ~= 0) and event.initiator then
@@ -1634,7 +2001,7 @@ function addSplashDamageMenu()
     addValueAdjustmentCommands(infantryCantFireMenu, "infantry_cant_fire_health")
     local rocketMultiplierMenu = missionCommands.addSubMenu("Rocket Multiplier", debugGeneralMenu)
     addValueAdjustmentCommands(rocketMultiplierMenu, "rocket_multiplier")
-    --Page 2: Explosion
+    --Page 2/3: Explosions
     local explosionCargoMenu = missionCommands.addSubMenu("Explosion Settings", splash_damage_menu)
     local staticDamageMenu = missionCommands.addSubMenu("Static Damage Boost", explosionCargoMenu)
     addValueAdjustmentCommands(staticDamageMenu, "static_damage_boost")
@@ -1642,8 +2009,7 @@ function addSplashDamageMenu()
     missionCommands.addCommand("Toggle Larger Explosions", explosionCargoMenu, toggleSplashDamageSetting, "larger_explosions")
     local blastRadiusMenu = missionCommands.addSubMenu("Blast Search Radius", explosionCargoMenu)
     addValueAdjustmentCommands(blastRadiusMenu, "blast_search_radius")
-    local cascadeThresholdMenu = missionCommands.addSubMenu("Cascade Damage Threshold", explosionCargoMenu)
-    addValueAdjustmentCommands(cascadeThresholdMenu, "cascade_damage_threshold")
+
     local overallScalingMenu = missionCommands.addSubMenu("Overall Scaling", explosionCargoMenu)
     addValueAdjustmentCommands(overallScalingMenu, "overall_scaling")
     missionCommands.addCommand("Toggle Shaped Charge Effects", explosionCargoMenu, toggleSplashDamageSetting, "apply_shaped_charge_effects")
@@ -1652,13 +2018,16 @@ function addSplashDamageMenu()
     missionCommands.addCommand("Toggle Dynamic Blast Radius", explosionCargoMenu, toggleSplashDamageSetting, "use_dynamic_blast_radius")
     local dynamicBlastMenu = missionCommands.addSubMenu("Dynamic Blast Radius Modifier", explosionCargoMenu)
     addValueAdjustmentCommands(dynamicBlastMenu, "dynamic_blast_radius_modifier")
+	
+    local explosionCargoMenu = missionCommands.addSubMenu("Cascade Settings", splash_damage_menu)
     local cascadeScalingMenu = missionCommands.addSubMenu("Cascade Scaling", explosionCargoMenu)
     addValueAdjustmentCommands(cascadeScalingMenu, "cascade_scaling")
     local cascadeExplodeThresholdMenu = missionCommands.addSubMenu("Cascade Explode Threshold", explosionCargoMenu)
     addValueAdjustmentCommands(cascadeExplodeThresholdMenu, "cascade_explode_threshold")
+    local cascadeThresholdMenu = missionCommands.addSubMenu("Cascade Damage Threshold", explosionCargoMenu)
+    addValueAdjustmentCommands(cascadeThresholdMenu, "cascade_damage_threshold")
 
-
-    --Page 3: Cargo and Ordnance Protection 
+    --Page 4: Cargo and Ordnance Protection 
     local explosionCargoMenu = missionCommands.addSubMenu("Cargo and Ordnance", splash_damage_menu)
     missionCommands.addCommand("Toggle Always Cascade Explode", explosionCargoMenu, toggleSplashDamageSetting, "always_cascade_explode")
     missionCommands.addCommand("Toggle Tracking & Cargo Effects", explosionCargoMenu, toggleSplashDamageSetting, "track_pre_explosion")
@@ -1668,8 +2037,13 @@ function addSplashDamageMenu()
     local ordnanceRadiusMenu = missionCommands.addSubMenu("Ordnance Protection Radius", explosionCargoMenu)
     addValueAdjustmentCommands(ordnanceRadiusMenu, "ordnance_protection_radius")
     missionCommands.addCommand("Toggle Snap To Ground If Destroyed By LE", explosionCargoMenu, toggleSplashDamageSetting, "snap_to_ground_if_destroyed_by_large_explosion")
-	
-	--Page 4: Debris Settings 
+    local ordnanceRadiusMenu = missionCommands.addSubMenu("Ordnance Protection Radius", explosionCargoMenu)
+	local cargoThresholdMenu = missionCommands.addSubMenu("Max Snap Height", explosionCargoMenu)
+    addValueAdjustmentCommands(cargoThresholdMenu, "max_snapped_height")
+    missionCommands.addCommand("Toggle Recent Expl Track Snap", explosionCargoMenu, toggleSplashDamageSetting, "recent_large_explosion_snap")	
+
+	 
+	--Page 5: Debris Settings 
     local debrisMenu = missionCommands.addSubMenu("Debris Settings", splash_damage_menu)
     missionCommands.addCommand("Toggle Debris Effects", debrisMenu, toggleSplashDamageSetting, "debris_effects")
     local debrisCountMinMenu = missionCommands.addSubMenu("Min Debris Count", debrisMenu)
@@ -1681,7 +2055,7 @@ function addSplashDamageMenu()
     local debrisPowerMenu = missionCommands.addSubMenu("Debris Power", debrisMenu)
     addValueAdjustmentCommands(debrisPowerMenu, "debris_power")
 
-    --Page 5: Cluster Settings
+    --Page 6: Cluster Settings
     local clusterMenu = missionCommands.addSubMenu("Cluster Settings", splash_damage_menu)
     missionCommands.addCommand("Toggle Cluster Enabled", clusterMenu, toggleSplashDamageSetting, "cluster_enabled")
     local clusterBaseLengthMenu = missionCommands.addSubMenu("Cluster Base Length", clusterMenu)
@@ -1699,18 +2073,79 @@ function addSplashDamageMenu()
     missionCommands.addCommand("Toggle Bomblet Reduction Modifier", clusterMenu, toggleSplashDamageSetting, "cluster_bomblet_reductionmodifier")
     local clusterBombletDamageMenu = missionCommands.addSubMenu("Bomblet Damage Modifier", clusterMenu)
     addValueAdjustmentCommands(clusterBombletDamageMenu, "cluster_bomblet_damage_modifier")
+	
+	--Page 7: Giant Explosion Settings
+    local giantExplosionMenu = missionCommands.addSubMenu("Giant Explosion Settings", splash_damage_menu)
+    missionCommands.addCommand("Toggle Giant Explosion", giantExplosionMenu, toggleSplashDamageSetting, "giant_explosion_enabled")
+    missionCommands.addCommand("Toggle Static Target", giantExplosionMenu, toggleSplashDamageSetting, "giant_explosion_target_static")
+    for name, target in pairs(giantExplosionTargets) do
+        local displayName = name:gsub("GiantExplosionTarget", "GiantExplosionTarget")
+        missionCommands.addCommand("Detonate " .. displayName, giantExplosionMenu, function()
+            trigger.action.setUserFlag(displayName, 1)
+        end)
+            end
+    missionCommands.addCommand("Detonate All Giant Targets", giantExplosionMenu, function()
+        for name, target in pairs(giantExplosionTargets) do
+            local flagName = name:gsub("GiantExplosionTarget", "GiantExplosionTarget")
+            trigger.action.setUserFlag(flagName, 1)
+        end
+    end)
+    local powerMenu = missionCommands.addSubMenu("Explosion Power", giantExplosionMenu)
+    addValueAdjustmentCommands(powerMenu, "giant_explosion_power")
+    local scaleMenu = missionCommands.addSubMenu("Size Scale", giantExplosionMenu)
+    missionCommands.addCommand("+0.1", scaleMenu, updateSplashDamageSetting, "giant_explosion_scale", 0.1)
+    missionCommands.addCommand("+0.5", scaleMenu, updateSplashDamageSetting, "giant_explosion_scale", 0.5)
+    missionCommands.addCommand("-0.1", scaleMenu, updateSplashDamageSetting, "giant_explosion_scale", -0.1)
+    missionCommands.addCommand("-0.5", scaleMenu, updateSplashDamageSetting, "giant_explosion_scale", -0.5)
+    local durationMenu = missionCommands.addSubMenu("Duration", giantExplosionMenu)
+    missionCommands.addCommand("+0.25s", durationMenu, updateSplashDamageSetting, "giant_explosion_duration", 0.25)
+    missionCommands.addCommand("-0.25s", durationMenu, updateSplashDamageSetting, "giant_explosion_duration", -0.25)
+    local countMenu = missionCommands.addSubMenu("Explosion Count", giantExplosionMenu)
+    addValueAdjustmentCommands(countMenu, "giant_explosion_count")
     
 end
 
 if (script_enable == 1) then
-    gameMsg("SPLASH DAMAGE 3.0 SCRIPT RUNNING")
-    env.info("SPLASH DAMAGE 2. SCRIPT RUNNING")
+    gameMsg("SPLASH DAMAGE 3.1 SCRIPT RUNNING")
+    env.info("SPLASH DAMAGE 3.1 SCRIPT RUNNING")
 
     timer.scheduleFunction(function()
         protectedCall(track_wpns)
         return timer.getTime() + refreshRate
     end, {}, timer.getTime() + refreshRate)
 
+    if splash_damage_options.giant_explosion_enabled then
+        giantExplosionTargets = {} -- Ensure it’s fresh
+        local targetCount = 0
+        for coa = 0, 2 do
+            local groups = coalition.getGroups(coa)
+            if groups then
+                for _, group in pairs(groups) do
+                    local units = group:getUnits()
+                    if units then
+                        for _, unit in pairs(units) do
+                            local name = unit:getName()
+                            if name:find("GiantExplosionTarget") then
+                                local pos = unit:getPosition().p
+                                giantExplosionTargets[name] = {obj = unit, pos = pos}
+                                if splash_damage_options.giant_explosion_target_static then
+                                    giantExplosionTargets[name].pos = pos
+                            end
+                                debugMsg("Found GiantExplosionTarget: " .. name .. " at X:" .. pos.x .. " Y:" .. pos.y .. " Z:" .. pos.z)
+                                targetCount = targetCount + 1
+                end
+            end
+        end
+                end
+            end
+        end
+        debugMsg("Total GiantExplosionTargets found: " .. targetCount)
+        timer.scheduleFunction(checkGiantExplosionFlag, {}, timer.getTime() + splash_damage_options.giant_explosion_poll_rate)
+        if not splash_damage_options.giant_explosion_target_static then
+            timer.scheduleFunction(updateTargetPosition, {}, timer.getTime() + 1.0)
+        end
+    end
+
     world.addEventHandler(WpnHandler)
     addSplashDamageMenu()
 end