feat: add new vent hordes & sounds, vent breaking

Content.Server/StationEvents/Components/VentHordeRuleComponent.cs

@@ -36,4 +36,16 @@ public sealed partial class VentHordeRuleComponent : Component
     /// </summary>
     [DataField]
     public SoundSpecifier? EndSound;
+
+    /// <summary>
+    /// starcup: The chance that a vent will break when entities are spawned.
+    /// </summary>
+    [DataField]
+    public float VentBreakChance;
+
+    /// <summary>
+    /// starcup: The entity that will replace the vent when it breaks.
+    /// </summary>
+    [DataField]
+    public string? VentReplacement = "ScrapSteel";
 }

Content.Server/StationEvents/Events/VentHordeRule.cs

@@ -83,7 +83,7 @@ protected override void Started(EntityUid uid, VentHordeRuleComponent component,
         // And start the spawn at the chosen vent.
         // The duration is the same as the time until expected gamerule end time, but that is only for convenience.
         // The spawn can happen early in certain circumstances anyway.
-        _horde.StartHordeSpawn(component.ChosenVent.Value, spawns.ToList(), duration, passiveSound: component.PassiveSound, endSound: component.EndSound); // starcup: Pass sounds
+        _horde.StartHordeSpawn(component.ChosenVent.Value, spawns.ToList(), duration, passiveSound: component.PassiveSound, endSound: component.EndSound, ventBreakChance: component.VentBreakChance, ventReplacement: component.VentReplacement); // starcup: Pass sounds, break vents and replace them
     }
 
     private EntityUid? ChooseVent()

Content.Server/VentHorde/Components/VentHordeSpawnerComponent.cs

@@ -54,7 +54,7 @@ public sealed partial class VentHordeSpawnerComponent : Component
     /// Plays on loop when a vent is selected as a spawner.
     /// </summary>
     [DataField]
-    public SoundSpecifier PassiveSound = new SoundPathSpecifier("/Audio/Machines/airlock_creaking.ogg")
+    public SoundSpecifier PassiveSound = new SoundCollectionSpecifier("VentCrawlGeneric") // starcup: new sound collection
     {
         Params = AudioParams.Default.WithVolume(-3f),
     };
@@ -74,4 +74,16 @@ public sealed partial class VentHordeSpawnerComponent : Component
     [DataField]
     [ViewVariables(VVAccess.ReadOnly)]
     public EntityUid? AudioStream;
+
+    /// <summary>
+    /// starcup: The chance that a vent will break when entities are spawned.
+    /// </summary>
+    [DataField]
+    public float VentBreakChance;
+
+    /// <summary>
+    /// starcup: The entity that will replace the vent when it breaks.
+    /// </summary>
+    [DataField]
+    public string? VentReplacement;
 }

Content.Server/VentHorde/Systems/VentHordeSystem.cs

@@ -65,7 +65,9 @@ private void OnSpawnerAnchored(Entity<VentHordeSpawnerComponent> entity, ref Anc
     /// <param name="append">If an already active spawner is selected, will add entities to its list. Otherwise, will fail.</param>
     /// starcup: <param name="passiveSound">Will override the default sound in VentHordeSpawnerComponent if provided.</param>
     /// starcup: <param name="endSound">Will override the default sound in VentHordSpawnerComponent if provided.</param>
-    public void StartHordeSpawn(EntityUid uid, List<EntProtoId> spawns, TimeSpan spawnDelay, bool append = true, SoundSpecifier? passiveSound = null, SoundSpecifier? endSound = null)
+    /// starcup: <param name="ventBreakChance">Will remove the vent horde spawner entity.</param>
+    /// starcup: <param name="ventReplacement">Spawns a new entity in place of the removed vent horde spawner entity.</param>
+    public void StartHordeSpawn(EntityUid uid, List<EntProtoId> spawns, TimeSpan spawnDelay, string? ventReplacement, bool append = true, SoundSpecifier? passiveSound = null, SoundSpecifier? endSound = null, float ventBreakChance = 0)
     {
         if (TryComp<VentHordeSpawnerComponent>(uid, out var hordeSpawner))
         {
@@ -85,6 +87,10 @@ public void StartHordeSpawn(EntityUid uid, List<EntProtoId> spawns, TimeSpan spa
 
         if (endSound is not null)
             hordeSpawner.EndSound = endSound;
+
+        hordeSpawner.VentBreakChance = ventBreakChance;
+
+        hordeSpawner.VentReplacement = ventReplacement;
         // end starcup
 
         hordeSpawner.AudioStream = _audio.PlayPvs(hordeSpawner.PassiveSound, uid, hordeSpawner.PassiveSound.Params.WithLoop(true))?.Entity;
@@ -101,8 +107,6 @@ public void EndHordeSpawn(Entity<VentHordeSpawnerComponent> entity)
     {
         entity.Comp.AudioStream = _audio.Stop(entity.Comp.AudioStream);
 
-        _audio.PlayPvs(entity.Comp.EndSound, entity);
-
         foreach (var spawn in entity.Comp.Entities)
         {
             var spawned = Spawn(spawn, Transform(entity).Coordinates);
@@ -111,6 +115,22 @@ public void EndHordeSpawn(Entity<VentHordeSpawnerComponent> entity)
             _throwing.TryThrow(spawned, direction, throwSpeed);
         }
 
+        // begin starcup: Remove the horde spawner entity and spawn a replacement (perhaps a broken version of it).
+        if (_random.Prob(entity.Comp.VentBreakChance))
+        {
+            var xform = Transform(entity);
+            var brokenVent = Spawn(entity.Comp.VentReplacement, xform.Coordinates);
+            var newXform = Transform(brokenVent);
+            newXform.LocalRotation = xform.LocalRotation;
+            QueueDel(entity);
+            _audio.PlayPvs(entity.Comp.EndSound, brokenVent);
+        }
+        else
+        {
+            _audio.PlayPvs(entity.Comp.EndSound, entity);
+        }
+        // end starcup
+
         RemCompDeferred<VentHordeSpawnerComponent>(entity);
     }
 

Resources/Audio/_DEN/VentCritters/attributions.yml

@@ -0,0 +1,25 @@
+# SPDX-FileCopyrightText: 2025 Jakumba
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+- files: ["vent_xeno.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by MajorMoth, samples taken from freesound.org at ID's 800277, 803044, 795432, 806647, 806649"
+  source: "https://freesound.org"
+
+- files: ["vent_carp.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by MajorMoth, modified bite.ogg and metal_break4.ogg. Modified by Psymbiote for use with VentHordeRuleComponent."
+  source: "https://github.com/TheDenSS14/TheDen"
+
+- files: ["vent_harmless_critter.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by MajorMoth, samples taken from freesound.org at ID's 244015, 528191"
+  source: "https://freesound.org"
+
+- files: ["vent_slime.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by MajorMoth, samples taken from https://www.youtube.com/watch?v=hX5S4KC0hx0, https://www.youtube.com/watch?v=REOeff9WJ2o,
+https://www.youtube.com/watch?v=9XIDm_sZhx4,
+https://www.youtube.com/watch?v=jiTV8MwgL3c"
+  source: "https://www.youtube.com"

Resources/Audio/_starcup/Ambience/Objects/attributions.yml

@@ -0,0 +1,15 @@
+- files:
+  - vent_den.ogg
+  license: "CC-BY-NC-4.0"
+  copyright: "Modified by Psymbiote from MOUSE - MICE - RAT - TERRARIUM - SQUEAK.wav by tjandrasounds"
+  source: "https://freesound.org/s/251949/"
+- files:
+  - vent_infested.ogg
+  license: "CC-BY-4.0"
+  copyright: "Modified by Psymbiote from Ambience_AlienHive_00.wav by LittleRobotSoundFactory"
+  source: "https://freesound.org/s/270520/"
+- files:
+  - vent_pulsating.ogg
+  license: "CC-BY-4.0"
+  copyright: "Modified by Psymbiote from Guts - Spooky - HORROR by bolkmar."
+  source: "https://freesound.org/s/393783/"

Resources/Audio/_starcup/VentCritters/attributions.yml

@@ -0,0 +1,39 @@
+- files: ["vent_carp.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Modified by Psymbiote from the original file edited and composited by MajorMoth, modified bite.ogg and metal_break4.ogg"
+  source: "https://github.com/TheDenSS14/TheDen"
+
+- files: ["vent_mosquitoes.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by Psymbiote, samples taken from freesound.org at ID's 827925, 315908"
+  source: "https://freesound.org"
+
+- files: ["vent_leeches.ogg"]
+  license: "CC-BY-4.0"
+  copyright: "Edited and composited by Psymbiote, samples taken from freesound.org at ID's 616199, 616200 and 207930"
+  source: "https://freesound.org"
+
+- files: ["vent_snakes.ogg"]
+  license: "CC0-1.0"
+  copyright: "Edited and composited by Psymbiote, samples taken from freesound.org at ID's 706981 and 712920"
+  source: "https://freesound.org"
+
+- files: ["vent_spiders.ogg"]
+  license: "CC-BY-4.0"
+  copyright: "Edited and composited by Psymbiote from Metal Rattles by IENBA and arachnid_scream.ogg"
+  source: "https://freesound.org/s/849797"
+
+- files: ["vent_generic1.ogg", "vent_generic2.ogg", "vent_generic3.ogg"]
+  license: "CC-BY-4.0"
+  copyright: "Edited and composited by Psymbiote from Vent Crawling by ME_Studios_Official"
+  source: "https://freesound.org/s/652449/"
+
+- files: ["vent_flesh.ogg"]
+  license: "CC-BY-3.0"
+  copyright: "Edited and composited by Psymbiote from Crawling Through a Vent by Ultra-Edward on freesound.org ID 795872, small pest alien/creature by Brandon Morris on OpenGameArt, metal_scrape1.ogg and metal_slam2.ogg."
+  source: "https://freesound.org/s/849797"
+
+- files: ["vent_bugs.ogg"]
+  license: "CC-BY-SA-3.0"
+  copyright: "Edited and composited by Psymbiote, includes metal_thud1.ogg and metal_thud3.ogg."
+  source: "https://github.com/cmss13-devs/cmss13"

Resources/Prototypes/GameRules/events.yml

@@ -460,15 +460,26 @@
     earliestStart: 20
     minimumPlayers: 15
     weight: 5
-    duration: 5
-    maxDuration: 20
+    duration: 15
+    maxDuration: 30 # starcup: the new sounds are longer
   - type: VentHordeRule
-    table: !type:GroupSelector
-      rolls: 4, 8
+    # begin starcup
+    table: !type:AllSelector
       children:
-      - id: MobAdultSlimesBlueAngry
-      - id: MobAdultSlimesGreenAngry
-      - id: MobAdultSlimesYellowAngry
+      - id: PuddleSlime
+      - !type:GroupSelector
+        rolls: 4, 8
+        children:
+        - id: MobAdultSlimesBlueAngry
+        - id: MobAdultSlimesGreenAngry
+        - id: MobAdultSlimesYellowAngry
+    passiveSound:
+      path: /Audio/_DEN/VentCritters/vent_slime.ogg
+    endSound:
+      collection: MetalBreak
+    ventBreakChance: 1.0
+    ventReplacement: GasVentPumpBroken
+    # end starcup
 
 - type: entity
   id: SnakeSpawnHorde
@@ -481,15 +492,25 @@
     earliestStart: 20
     minimumPlayers: 15
     weight: 5
-    duration: 5
-    maxDuration: 20
+    duration: 30
+    maxDuration: 30 # starcup: the new sounds are longer
   - type: VentHordeRule
-    table: !type:GroupSelector
-      rolls: 4, 8
+    # begin starcup
+    table: !type:AllSelector
       children:
-      - id: MobPurpleSnake
-      - id: MobSmallPurpleSnake
-      - id: MobCobraSpace
+      - !type:GroupSelector
+        rolls: 4, 8
+        children:
+        - id: MobPurpleSnake
+        - id: MobSmallPurpleSnake
+        - id: MobCobraSpace
+    passiveSound:
+      path: /Audio/_starcup/VentCritters/vent_snakes.ogg
+    endSound:
+      collection: MetalBreak
+    ventBreakChance: 1.0
+    ventReplacement: GasVentPumpBroken
+    # end starcup
 
 - type: entity
   id: SpiderSpawnHorde
@@ -502,13 +523,24 @@
     earliestStart: 20
     minimumPlayers: 15
     weight: 5
-    duration: 5
-    maxDuration: 20
+    duration: 30
+    maxDuration: 30 # starcup: the new sounds are longer
   - type: VentHordeRule
-    table: !type:GroupSelector
-      rolls: 4, 8
+    # begin starcup
+    table: !type:AllSelector
       children:
-      - id: MobGiantSpiderAngry
+      - id: SpiderWeb
+      - !type:GroupSelector
+        rolls: 4, 8
+        children:
+        - id: MobGiantSpiderAngry
+    passiveSound:
+      path: /Audio/_starcup/VentCritters/vent_spiders.ogg
+    endSound:
+      collection: MetalBreak
+    ventBreakChance: 1.0
+    ventReplacement: GasVentPumpBroken
+    # end starcup
 
 - type: entity
   id: SpiderClownSpawnHorde
@@ -524,10 +556,17 @@
     duration: 5
     maxDuration: 20
   - type: VentHordeRule
-    table: !type:GroupSelector
-      rolls: 4, 8
+    # begin starcup
+    table: !type:AllSelector
       children:
-      - id: MobClownSpider
+      - id: SpiderWebClown
+      - !type:GroupSelector
+        rolls: 4, 8
+        children:
+        - id: MobClownSpider
+    ventBreakChance: 1.0
+    ventReplacement: GasVentPumpBroken
+    # end starcup
 
 - type: entity
   id: ZombieOutbreak

Resources/Prototypes/GameRules/pests.yml

@@ -55,8 +55,8 @@
       prob: 0.02
     - id: MobMouse2
       prob: 0.02
-    - id: MobMouseCancer
-      prob: 0.001
+    #- id: MobMouseCancer # starcup: disable cancer mouse spawn
+      #prob: 0.001
     specialEntries:
     - id: SpawnPointGhostRatKing
       prob: 0.001
@@ -71,13 +71,15 @@
   - type: VentCrittersRule
     entries:
     - id: MobCockroach
-      prob: 0.03
+      prob: 0.02
+    # begin starcup
+    - id: MobCockroachHL
+      prob: 0.02
     - id: MobMothroach
       prob: 0.004 # starcup: 0.008 -> 0.004
     #- id: MobMoproach # starcup: move to mothroach event
     #  prob: 0.004
-    - id: MobMoproach
-      prob: 0.004
+    # end starcup
 
 - type: entity
   id: SnailMigrationLowPop
@@ -140,6 +142,7 @@
       - !type:GroupSelector
         children: # Increased chances for special roaches on purpose. Makes it a bit more interesting.
         - id: MobCockroach
+        - id: MobCockroachHL # starcup
         - id: MobMothroach
         - id: MobMoproach
           weight: 0.5