From b115eb0d93e506f0a46e26d731e7dee60ae34d42 Mon Sep 17 00:00:00 2001
From: Vera Aguilera Puerto <6766154+Zumorica@users.noreply.github.com>
Date: Fri, 25 Mar 2022 13:08:32 +0100
Subject: [PATCH] Adds PlayGlobalSound command. (#7249)

---
 .../Commands/PlayGlobalSound.cs               | 60 +++++++++++++++++++
 .../commands/play-global-sound-command.ftl    |  3 +
 2 files changed, 63 insertions(+)
 create mode 100644 Content.Server/Administration/Commands/PlayGlobalSound.cs
 create mode 100644 Resources/Locale/en-US/administration/commands/play-global-sound-command.ftl

diff --git a/Content.Server/Administration/Commands/PlayGlobalSound.cs b/Content.Server/Administration/Commands/PlayGlobalSound.cs
new file mode 100644
index 0000000000..7e92ece246
--- /dev/null
+++ b/Content.Server/Administration/Commands/PlayGlobalSound.cs
@@ -0,0 +1,60 @@
+using Content.Shared.Administration;
+using Robust.Server.Player;
+using Robust.Shared.Audio;
+using Robust.Shared.Console;
+using Robust.Shared.Player;
+
+namespace Content.Server.Administration.Commands;
+
+/// <summary>
+///     Command that allows admins to play global sounds.
+/// </summary>
+[AdminCommand(AdminFlags.Fun)]
+public sealed class PlayGlobalSound : IConsoleCommand
+{
+    [Dependency] private IPlayerManager _playerManager = default!;
+
+
+    public string Command => "playglobalsound";
+    public string Description => Loc.GetString("play-global-sound-command-description");
+    public string Help => Loc.GetString("play-global-sound-command-help");
+    public void Execute(IConsoleShell shell, string argStr, string[] args)
+    {
+        Filter filter;
+
+        switch (args.Length)
+        {
+            // No arguments, show command help.
+            case 0:
+                shell.WriteLine(Help);
+                return;
+
+            // No users, play sound for everyone.
+            case 1:
+                // Filter.Broadcast does resolves IPlayerManager, so use this instead.
+                filter = Filter.Empty().AddAllPlayers(_playerManager);
+                break;
+
+            // One or more users specified.
+            default:
+                filter = Filter.Empty();
+
+                // Skip the first argument, which is the sound path.
+                for (var i = 1; i < args.Length; i++)
+                {
+                    var username = args[i];
+
+                    if (!_playerManager.TryGetSessionByUsername(username, out var session))
+                    {
+                        shell.WriteError(Loc.GetString("play-global-sound-command-player-not-found", ("username", username)));
+                        continue;
+                    }
+
+                    filter.AddPlayer(session);
+                }
+                break;
+        }
+
+        SoundSystem.Play(filter, args[0], AudioParams.Default);
+    }
+}
diff --git a/Resources/Locale/en-US/administration/commands/play-global-sound-command.ftl b/Resources/Locale/en-US/administration/commands/play-global-sound-command.ftl
new file mode 100644
index 0000000000..2be289fd5f
--- /dev/null
+++ b/Resources/Locale/en-US/administration/commands/play-global-sound-command.ftl
@@ -0,0 +1,3 @@
+play-global-sound-command-description = Plays a global sound for a specific player or for every connected player if no players are specified.
+play-global-sound-command-help = playglobalsound <path> [user 1] ... [user n]
+play-global-sound-command-player-not-found = Player "{$username}" not found.