feat: spawning grenade effect event (#828)

* feat: spawning grenade effect event

* fix: respect DynamicPatching

* fix: position change

Author: VALERA771

EXILED/Exiled.Events/EventArgs/Map/SpawningGrenadeEffectEventArgs.cs

@@ -0,0 +1,49 @@
+// -----------------------------------------------------------------------
+// <copyright file="SpawningGrenadeEffectEventArgs.cs" company="ExMod Team">
+// Copyright (c) ExMod Team. All rights reserved.
+// Licensed under the CC BY-SA 3.0 license.
+// </copyright>
+// -----------------------------------------------------------------------
+
+namespace Exiled.Events.EventArgs.Map
+{
+    using Exiled.API.Features.Pickups;
+    using Exiled.API.Features.Pickups.Projectiles;
+    using Exiled.Events.EventArgs.Interfaces;
+
+    using UnityEngine;
+
+    /// <summary>
+    /// Contains all information before grenade explosion effect is spawned.
+    /// </summary>
+    public class SpawningGrenadeEffectEventArgs : IPickupEvent, IDeniableEvent
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="SpawningGrenadeEffectEventArgs"/> class.
+        /// </summary>
+        /// <param name="effectGrenade"><inheritdoc cref="Projectile"/></param>
+        /// <param name="isAllowed"><inheritdoc cref="IsAllowed"/></param>
+        public SpawningGrenadeEffectEventArgs(TimeGrenadeProjectile effectGrenade, bool isAllowed = false)
+        {
+            Projectile = effectGrenade;
+            Position = effectGrenade.Position;
+            IsAllowed = isAllowed;
+        }
+
+        /// <summary>
+        /// Gets or sets a position of this effect.
+        /// </summary>
+        public Vector3 Position { get; set; }
+
+        /// <inheritdoc/>
+        public bool IsAllowed { get; set; }
+
+        /// <inheritdoc/>
+        public Pickup Pickup => Projectile;
+
+        /// <summary>
+        /// Gets the projectile that is exploding.
+        /// </summary>
+        public TimeGrenadeProjectile Projectile { get; }
+    }
+}

EXILED/Exiled.Events/Events.cs

@@ -98,6 +98,8 @@ public override void OnEnabled()
             LabApi.Events.Handlers.Scp127Events.GainingExperience += Handlers.Scp127.OnGainingExperience;
             LabApi.Events.Handlers.Scp127Events.GainExperience += Handlers.Scp127.OnGainedExperience;
 
+            LabApi.Events.Handlers.ServerEvents.ProjectileExploding += Handlers.Map.OnSpawningGrenadeEffect;
+
             ServerConsole.ReloadServerName();
         }
 
@@ -140,6 +142,8 @@ public override void OnDisabled()
             LabApi.Events.Handlers.Scp127Events.Talked -= Handlers.Scp127.OnTalked;
             LabApi.Events.Handlers.Scp127Events.GainingExperience -= Handlers.Scp127.OnGainingExperience;
             LabApi.Events.Handlers.Scp127Events.GainExperience -= Handlers.Scp127.OnGainedExperience;
+
+            LabApi.Events.Handlers.ServerEvents.ProjectileExploding -= Handlers.Map.OnSpawningGrenadeEffect;
         }
 
         /// <summary>

EXILED/Exiled.Events/Handlers/Map.cs

@@ -10,6 +10,7 @@ namespace Exiled.Events.Handlers
 #pragma warning disable SA1623 // Property summary documentation should match accessors
 
     using Exiled.API.Features.Pickups;
+    using Exiled.API.Features.Pickups.Projectiles;
     using Exiled.Events.EventArgs.Map;
     using Exiled.Events.Features;
 
@@ -130,6 +131,11 @@ public static class Map
         /// </summary>
         public static Event<GeneratingEventArgs> Generating { get; set; } = new();
 
+        /// <summary>
+        /// Invoked before grenade explosion effect is spawned.
+        /// </summary>
+        public static Event<SpawningGrenadeEffectEventArgs> SpawningGrenadeEffect { get; set; } = new();
+
         /// <summary>
         /// Called before placing a decal.
         /// </summary>
@@ -260,5 +266,21 @@ public static class Map
         /// </summary>
         /// <param name="ev">The <see cref="GeneratingEventArgs"/> instnace.</param>
         public static void OnGenerating(GeneratingEventArgs ev) => Generating.InvokeSafely(ev);
+
+        /// <summary>
+        /// Called before grenade explosion effect is spawned.
+        /// </summary>
+        /// <param name="ev">The <see cref="LabApi.Events.Arguments.ServerEvents.ProjectileExplodingEventArgs"/> instance.</param>
+        public static void OnSpawningGrenadeEffect(LabApi.Events.Arguments.ServerEvents.ProjectileExplodingEventArgs ev)
+        {
+            if (!SpawningGrenadeEffect.Patched)
+                return;
+
+            SpawningGrenadeEffectEventArgs exiledEv = new(Pickup.Get<TimeGrenadeProjectile>(ev.TimedGrenade.Base), true);
+            SpawningGrenadeEffect.InvokeSafely(exiledEv);
+
+            ev.Position = exiledEv.Position;
+            ev.IsAllowed = exiledEv.IsAllowed;
+        }
     }
 }