add more example scripts

Author: Elektryk-Andrzej

Code/Examples/BreachScript.cs

@@ -0,0 +1,21 @@
+namespace SER.Code.Examples;
+
+public class BreachScript : Example
+{
+    public override string Name => "breach";
+
+    public override string Content =>
+        """
+        !-- CustomCommand breach
+
+        Cassie jingle "Containment breach detected . All heavy containment doors locked ." ""
+
+        CloseDoor HeavyContainment
+        LockDoor HeavyContainment 30s
+
+        Wait 30s
+
+        Cassie jingle "Lockdown lifted ." ""
+        UnlockDoor HeavyContainment
+        """;
+}

Code/Examples/GnomingTimeScript.cs

@@ -0,0 +1,27 @@
+namespace SER.Code.Examples;
+
+public class GnomingTimeScript : Example
+{
+    public override string Name => "gnomingTime";
+
+    public override string Content =>
+        """
+        !-- OnEvent Death
+
+        if {VarExists @evAttacker} is false
+            stop
+        end
+
+        @plr = @evAttacker
+
+        # lower scale by .1 when killing someone
+        SetSize @plr ({@plr scaleX} - .1) ({@plr scaleY} - .1) ({@plr scaleZ} - .1)
+        Hint @plr 5s "KILLED PLAYER - IT'S GNOMING TIME!"
+
+        Wait 15s
+
+        # return them to normal
+        SetSize @plr ({@plr scaleX} + .1) ({@plr scaleY} + .1) ({@plr scaleZ} + .1)
+        Hint @plr 5s "Gnoming potential depleted :("
+        """;
+}

Code/Examples/HotPotatoScript.cs

@@ -0,0 +1,39 @@
+namespace SER.Code.Examples;
+
+public class HotPotatoScript : Example
+{
+    public override string Name => "hotPotato";
+
+    public override string Content =>
+        """
+        !-- OnEvent RoundStarted
+
+        forever
+            Wait 1m
+
+            # Get a random player from the alive players
+            @potatoCarrier = LimitPlayers @alivePlayers 1
+
+            Hint @potatoCarrier 3s "YOU HAVE THE HOT POTATO! DROP IT OR DIE!"
+            GiveItem @potatoCarrier GunA7
+
+            Wait 3s
+
+            # Check if they still have the item (GunA7) in their inventory
+            &inv = {@potatoCarrier inventory}
+            over &inv
+                with *item
+
+                if {ItemInfo *item type} isnt "GunA7"
+                    continue
+                end
+
+                Explode @potatoCarrier
+                Broadcast @all 5s "{@potatoCarrier name} failed the Hot Potato!"
+                stop
+            end
+                
+            Broadcast @all 5s "The Hot Potato has been neutralized... for now."
+        end
+        """;
+}

Code/Examples/KillStreakScript.cs

@@ -0,0 +1,35 @@
+namespace SER.Code.Examples;
+
+public class KillStreakScript : Example
+{
+    public override string Name => "killStreak";
+
+    public override string Content =>
+        """
+        !-- OnEvent Death
+
+        if {VarExists @evAttacker} is true
+            # increment killer's streak
+            if {HasPlayerData @evAttacker "streak"}
+                $new = ({GetPlayerData @evAttacker "streak"} + 1)
+            else
+                $new = 1
+            end
+
+            # save the new kill streak
+            SetPlayerData @evAttacker "streak" $new
+
+            # announce milestone
+            if $new is 5
+                Broadcast @all 5s "{@evAttacker name} is on a KILLING SPREE (5 Kills)!"
+            elif $new is 10
+                Broadcast @all 5s "{@evAttacker name} is UNSTOPPABLE (10 Kills)!"
+            end
+        end
+
+        if {VarExists @evPlayer} is true
+            # reset the victim's streak
+            SetPlayerData @evPlayer "streak" 0
+        end
+        """;
+}

Code/Examples/PinataLootScript.cs

@@ -0,0 +1,39 @@
+namespace SER.Code.Examples;
+
+public class PinataLootScript : Example
+{
+    public override string Name => "pinataLoot";
+
+    public override string Content =>
+        """
+        !-- OnEvent Hurt
+
+        # Only trigger if the victim exists
+        if {VarExists @evPlayer} is false
+            stop
+        end
+        
+        # Only trigger if the victim is SCP-173
+        if {@evPlayer role} isnt "Scp173"
+            stop
+        end
+
+        # Trigger only with 25% chance
+        if {Chance 25%} is false
+            stop
+        end
+
+        # 80% to get pills, 20% to get medkit
+        if {Chance 80%} is true
+            *pickup = CreatePickup Painkillers
+        else
+            *pickup = CreatePickup Medkit
+        end
+
+        SpawnPickupPlayer *pickup @evPlayer
+        
+        if {VarExists @evAttacker} is true
+            Hint @evAttacker 3s "You hit the piñata!"
+        end
+        """;
+}

Code/Examples/SurfaceSmiteScript.cs

@@ -0,0 +1,28 @@
+using JetBrains.Annotations;
+
+namespace SER.Code.Examples;
+
+[UsedImplicitly]
+public class SurfaceSmiteScript : Example
+{
+    public override string Name => "surfaceSmite";
+
+    public override string Content =>
+        """
+        !-- CustomCommand surfacesmite
+        -- availableFor RemoteAdmin
+        -- description "Kills a random player currently in the Surface Zone."
+
+        # 1. Get all players on the surface and limit the selection to 1 random person.
+        @target = LimitPlayers @surfacePlayers 1
+
+        # 2. Check if anyone was actually found to avoid a runtime error.
+        if {AmountOf @target} > 0
+            # 3. Execute the kill with a custom reason.
+            Kill @target "The surface is no longer safe."
+            Broadcast @sender 5s "Eliminated {@target nickname} from the surface."
+        else
+            Broadcast @sender 5s "No players found in the Surface Zone."
+        end
+        """;
+}