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; + +/// +/// Command that allows admins to play global sounds. +/// +[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 [user 1] ... [user n] +play-global-sound-command-player-not-found = Player "{$username}" not found.