using CounterStrikeSharp.API; using CounterStrikeSharp.API.Core; using CounterStrikeSharp.API.Modules.Admin; using CounterStrikeSharp.API.Modules.Commands; using CounterStrikeSharp.API.Modules.Entities; using CS2_SimpleAdmin.Managers; using CS2_SimpleAdmin.Menus; using CS2_SimpleAdminApi; namespace CS2_SimpleAdmin; public partial class CS2_SimpleAdmin { /// /// Processes the 'gag' command, applying a muted penalty to target players with optional time and reason. /// /// The player issuing the gag command or null for console. /// The command input containing targets, time, and reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: "<#userid or name> [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnGagCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; var targets = GetTarget(command); if (targets == null) return; var playersToTarget = targets.Players.Where(player => player is { IsValid: true, IsHLTV: false }).ToList(); if (playersToTarget.Count > 1 && Config.OtherSettings.DisableDangerousCommands || playersToTarget.Count == 0) { return; } var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Helper.ParsePenaltyTime(command.GetArg(2)); playersToTarget.ForEach(player => { if (!caller!.CanTarget(player)) return; if (time < 0 && caller != null && caller.IsValid && Config.OtherSettings.ShowBanMenuIfNoTime) { DurationMenu.OpenMenu(caller, $"{_localizer?["sa_gag"] ?? "Gag"}: {player.PlayerName}", player, ManagePlayersMenu.GagMenu); return; } Gag(caller, player, time, reason, callerName, command); }); } /// /// Applies the gag penalty logic to an individual player, performing permission checks, notification, and logging. /// /// The player issuing the gag. /// The player to gag. /// Duration of the gag in minutes, 0 is permanent. /// Reason for the gag. /// Optional caller name for notifications. /// Optional command info for logging. /// If true, suppresses logging notifications. internal void Gag(CCSPlayerController? caller, CCSPlayerController player, int time, string reason, string? callerName = null, CommandInfo? command = null, bool silent = false) { if (DatabaseProvider == null || !player.IsValid || !player.UserId.HasValue) return; if (!caller.CanTarget(player)) return; if (!CheckValidMute(caller, time)) return; // Set default caller name if not provided callerName ??= caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Get player and admin information var playerInfo = PlayersInfo[player.SteamID]; var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Asynchronously handle gag logic Task.Run(async () => { int? penaltyId = await MuteManager.MutePlayer(playerInfo, adminInfo, reason, time); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedEvent(playerInfo, adminInfo, PenaltyType.Gag, reason, time, penaltyId); }); }); // Add penalty to the player's penalty manager PlayerPenaltyManager.AddPenalty(player.Slot, PenaltyType.Gag, Time.ActualDateTime().AddMinutes(time), time, reason); // Determine message keys and arguments based on gag time (permanent or timed) var (messageKey, activityMessageKey, playerArgs, adminActivityArgs) = time == 0 ? ("sa_player_gag_message_perm", "sa_admin_gag_message_perm", [reason, "CALLER"], ["CALLER", player.PlayerName, reason]) : ("sa_player_gag_message_time", "sa_admin_gag_message_time", new object[] { reason, time, "CALLER" }, new object[] { "CALLER", player.PlayerName, reason, time }); // Display center message to the gagged player Helper.DisplayCenterMessage(player, messageKey, callerName, playerArgs); // Display admin activity message to other players if (caller == null || !SilentPlayers.Contains(caller.Slot)) { Helper.ShowAdminActivity(activityMessageKey, callerName, false, adminActivityArgs); } // Increment the player's total gags count PlayersInfo[player.SteamID].TotalGags++; // Log the gag command and send Discord notification if (!silent) { if (command == null) Helper.LogCommand(caller, $"css_gag {(string.IsNullOrEmpty(player.PlayerName) ? player.SteamID.ToString() : player.PlayerName)} {time} {reason}"); else Helper.LogCommand(caller, command); } Helper.SendDiscordPenaltyMessage(caller, player, reason, time, PenaltyType.Gag, _localizer); } /// /// Adds a gag penalty to a player identified by SteamID, supporting offline players. /// /// The player issuing the command or null for console. /// SteamID of the target player. /// Duration in minutes (0 for permanent). /// Reason for the gag. internal void AddGag(CCSPlayerController? caller, SteamID steamid, int time, string reason) { // Set default caller name if not provided var callerName = !string.IsNullOrEmpty(caller?.PlayerName) ? caller.PlayerName : (_localizer?["sa_console"] ?? "Console"); var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; var player = Helper.GetPlayerFromSteamid64(steamid.SteamId64); if (player != null && player.IsValid) { if (!caller.CanTarget(player)) return; Gag(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(steamid)) return; // Asynchronous ban operation if player is not online or not found Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid.SteamId64, adminInfo, reason, time, 3); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamid, adminInfo, PenaltyType.Gag, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.SteamId64.ToString(), reason, time, PenaltyType.Gag, _localizer); } } /// /// Handles the 'addgag' command, which adds a gag penalty to a player specified by SteamID. /// /// The player issuing the command or null for console. /// Command input that includes SteamID, optional time, and reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: " [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnAddGagCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; // Set caller name var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Validate command arguments if (command.ArgCount < 2 || string.IsNullOrEmpty(command.GetArg(1))) return; // Validate and extract SteamID if (!Helper.ValidateSteamId(command.GetArg(1), out var steamId) || steamId == null) { command.ReplyToCommand("Invalid SteamID64."); return; } var steamid = steamId.SteamId64; var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Math.Max(0, Helper.ParsePenaltyTime(command.GetArg(2))); if (!CheckValidMute(caller, time)) return; // Get player and admin info var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Attempt to match player based on SteamID var player = Helper.GetPlayerFromSteamid64(steamid); if (player != null && player.IsValid) { // Check if caller can target the player if (!caller.CanTarget(player)) return; // Perform the gag for an online player Gag(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(new SteamID(steamId.SteamId64))) return; // Asynchronous gag operation for offline players Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid, adminInfo, reason, time); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamId, adminInfo, PenaltyType.Gag, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.ToString(), reason, time, PenaltyType.Gag, _localizer); command.ReplyToCommand($"Player with steamid {steamid} is not online. Gag has been added offline."); } // Log the gag command and respond to the command Helper.LogCommand(caller, command); } /// /// Handles removing a gag penalty ('ungag') of a player, either by SteamID or pattern match. /// /// The player issuing the ungag command or null for console. /// Command input containing SteamID or player name and optional reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: " [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnUngagCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerSteamId = caller?.SteamID.ToString() ?? _localizer?["sa_console"] ?? "Console"; var pattern = command.GetArg(1); var reason = command.ArgCount >= 2 ? string.Join(" ", Enumerable.Range(2, command.ArgCount - 2).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; if (pattern.Length <= 1) { command.ReplyToCommand($"Too short pattern to search."); return; } Helper.LogCommand(caller, command); // Check if pattern is a valid SteamID64 if (Helper.ValidateSteamId(pattern, out var steamId) && steamId != null) { var player = Helper.GetPlayerFromSteamid64(steamId.SteamId64); if (player != null && player.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(player.Slot, PenaltyType.Gag); Task.Run(async () => { await MuteManager.UnmutePlayer(player.SteamID.ToString(), callerSteamId, reason); }); command.ReplyToCommand($"Ungaged player {player.PlayerName}."); return; } } // If not a valid SteamID64, check by player name var nameMatches = Helper.GetPlayerFromName(pattern); var namePlayer = nameMatches.Count == 1 ? nameMatches.FirstOrDefault() : null; if (namePlayer != null && namePlayer.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(namePlayer.Slot, PenaltyType.Gag); if (namePlayer.UserId.HasValue && PlayersInfo[namePlayer.SteamID].TotalGags > 0) PlayersInfo[namePlayer.SteamID].TotalGags--; Task.Run(async () => { await MuteManager.UnmutePlayer(namePlayer.SteamID.ToString(), callerSteamId, reason); }); command.ReplyToCommand($"Ungaged player {namePlayer.PlayerName}."); } else { Task.Run(async () => { await MuteManager.UnmutePlayer(pattern, callerSteamId, reason); }); command.ReplyToCommand($"Ungaged offline player with pattern {pattern}."); } } /// /// Processes the 'mute' command, applying a voice mute penalty to target players with optional time and reason. /// /// The player issuing the mute command or null for console. /// The command input containing targets, time, and reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: "<#userid or name> [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnMuteCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; var targets = GetTarget(command); if (targets == null) return; var playersToTarget = targets.Players.Where(player => player is { IsValid: true, IsHLTV: false }).ToList(); if (playersToTarget.Count > 1 && Config.OtherSettings.DisableDangerousCommands || playersToTarget.Count == 0) { return; } var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Helper.ParsePenaltyTime(command.GetArg(2)); playersToTarget.ForEach(player => { if (!caller!.CanTarget(player)) return; if (time < 0 && caller != null && caller.IsValid && Config.OtherSettings.ShowBanMenuIfNoTime) { DurationMenu.OpenMenu(caller, $"{_localizer?["sa_mute"] ?? "Mute"}: {player.PlayerName}", player, ManagePlayersMenu.MuteMenu); return; } Mute(caller, player, time, reason, callerName, command); }); } /// /// Applies the mute penalty logic to an individual player, handling permissions, notifications, logging, and countdown timers. /// /// The player issuing the mute. /// The player to mute. /// Duration in minutes, 0 indicates permanent mute. /// Reason for the mute. /// Optional caller name for notification messages. /// Optional command info for logging. /// If true, suppresses some logging. internal void Mute(CCSPlayerController? caller, CCSPlayerController player, int time, string reason, string? callerName = null, CommandInfo? command = null, bool silent = false) { if (DatabaseProvider == null || !player.IsValid || !player.UserId.HasValue) return; if (!caller.CanTarget(player)) return; if (!CheckValidMute(caller, time)) return; // Set default caller name if not provided callerName ??= caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Get player and admin information var playerInfo = PlayersInfo[player.SteamID]; var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Set player's voice flags to muted player.VoiceFlags = VoiceFlags.Muted; // Asynchronously handle mute logic Task.Run(async () => { int? penaltyId = await MuteManager.MutePlayer(playerInfo, adminInfo, reason, time, 1); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedEvent(playerInfo, adminInfo, PenaltyType.Mute, reason, time, penaltyId); }); }); // Add penalty to the player's penalty manager PlayerPenaltyManager.AddPenalty(player.Slot, PenaltyType.Mute, Time.ActualDateTime().AddMinutes(time), time, reason); // Determine message keys and arguments based on mute time (permanent or timed) var (messageKey, activityMessageKey, playerArgs, adminActivityArgs) = time == 0 ? ("sa_player_mute_message_perm", "sa_admin_mute_message_perm", [reason, "CALLER"], ["CALLER", player.PlayerName, reason]) : ("sa_player_mute_message_time", "sa_admin_mute_message_time", new object[] { reason, time, "CALLER" }, new object[] { "CALLER", player.PlayerName, reason, time }); // Display center message to the muted player Helper.DisplayCenterMessage(player, messageKey, callerName, playerArgs); // Display admin activity message to other players if (caller == null || !SilentPlayers.Contains(caller.Slot)) { Helper.ShowAdminActivity(activityMessageKey, callerName, false, adminActivityArgs); } // Increment the player's total mutes count PlayersInfo[player.SteamID].TotalMutes++; // Log the mute command and send Discord notification if (!silent) { if (command == null) Helper.LogCommand(caller, $"css_mute {(string.IsNullOrEmpty(player.PlayerName) ? player.SteamID.ToString() : player.PlayerName)} {time} {reason}"); else Helper.LogCommand(caller, command); } Helper.SendDiscordPenaltyMessage(caller, player, reason, time, PenaltyType.Mute, _localizer); } /// /// Handles the 'addmute' command that adds a mute penalty to a player specified by SteamID. /// /// The player issuing the command or null for console. /// Command input includes SteamID, optional time, and reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: " [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnAddMuteCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; // Set caller name var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Validate command arguments if (command.ArgCount < 2 || string.IsNullOrEmpty(command.GetArg(1))) return; // Validate and extract SteamID if (!Helper.ValidateSteamId(command.GetArg(1), out var steamId) || steamId == null) { command.ReplyToCommand("Invalid SteamID64."); return; } var steamid = steamId.SteamId64; var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Math.Max(0, Helper.ParsePenaltyTime(command.GetArg(2))); if (!CheckValidMute(caller, time)) return; // Get player and admin info var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Attempt to match player based on SteamID var player = Helper.GetPlayerFromSteamid64(steamid); if (player != null && player.IsValid) { // Check if caller can target the player if (!caller.CanTarget(player)) return; // Perform the mute for an online player Mute(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(new SteamID(steamId.SteamId64))) return; // Asynchronous mute operation for offline players Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid, adminInfo, reason, time, 1); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamId, adminInfo, PenaltyType.Mute, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.ToString(), reason, time, PenaltyType.Mute, _localizer); command.ReplyToCommand($"Player with steamid {steamid} is not online. Mute has been added offline."); } // Log the mute command and respond to the command Helper.LogCommand(caller, command); } /// /// Asynchronously adds a mute penalty to a player by Steam ID. Handles both online and offline players. /// /// The admin/player issuing the mute. /// The Steam ID of the player to mute. /// Duration of the mute in minutes. /// Reason for the mute. /// Optional mute manager instance for handling database ops. internal void AddMute(CCSPlayerController? caller, SteamID steamid, int time, string reason, MuteManager? muteManager = null) { // Set default caller name if not provided var callerName = !string.IsNullOrEmpty(caller?.PlayerName) ? caller.PlayerName : (_localizer?["sa_console"] ?? "Console"); var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; var player = Helper.GetPlayerFromSteamid64(steamid.SteamId64); if (player != null && player.IsValid) { if (!caller.CanTarget(player)) return; Mute(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(steamid)) return; // Asynchronous ban operation if player is not online or not found Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid.SteamId64, adminInfo, reason, time, 1); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamid, adminInfo, PenaltyType.Mute, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.SteamId64.ToString(), reason, time, PenaltyType.Mute, _localizer); } } /// /// Handles the unmute command - removes mute penalty from player identified by SteamID or name. /// Can target both online and offline players. /// /// The admin/player issuing the unmute. /// The command arguments including target identifier and optional reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: "", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnUnmuteCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerSteamId = caller?.SteamID.ToString() ?? _localizer?["sa_console"] ?? "Console"; var pattern = command.GetArg(1); var reason = command.ArgCount >= 2 ? string.Join(" ", Enumerable.Range(2, command.ArgCount - 2).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; if (pattern.Length <= 1) { command.ReplyToCommand("Too short pattern to search."); return; } Helper.LogCommand(caller, command); // Check if pattern is a valid SteamID64 if (Helper.ValidateSteamId(pattern, out var steamId) && steamId != null) { var player = Helper.GetPlayerFromSteamid64(steamId.SteamId64); if (player != null && player.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(player.Slot, PenaltyType.Mute); player.VoiceFlags = VoiceFlags.Normal; Task.Run(async () => { await MuteManager.UnmutePlayer(player.SteamID.ToString(), callerSteamId, reason, 1); }); command.ReplyToCommand($"Unmuted player {player.PlayerName}."); return; } } // If not a valid SteamID64, check by player name var nameMatches = Helper.GetPlayerFromName(pattern); var namePlayer = nameMatches.Count == 1 ? nameMatches.FirstOrDefault() : null; if (namePlayer != null && namePlayer.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(namePlayer.Slot, PenaltyType.Mute); namePlayer.VoiceFlags = VoiceFlags.Normal; if (namePlayer.UserId.HasValue && PlayersInfo[namePlayer.SteamID].TotalMutes > 0) PlayersInfo[namePlayer.SteamID].TotalMutes--; Task.Run(async () => { await MuteManager.UnmutePlayer(namePlayer.SteamID.ToString(), callerSteamId, reason, 1); }); command.ReplyToCommand($"Unmuted player {namePlayer.PlayerName}."); } else { Task.Run(async () => { await MuteManager.UnmutePlayer(pattern, callerSteamId, reason, 1); }); command.ReplyToCommand($"Unmuted offline player with pattern {pattern}."); } } /// /// Issue a 'silence' penalty to a player - disables voice communication. /// Handles online and offline players, with duration and reason specified. /// /// The admin/player issuing the silence. /// Command containing target, duration, and optional reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: "<#userid or name> [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnSilenceCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; var targets = GetTarget(command); if (targets == null) return; var playersToTarget = targets.Players.Where(player => player is { IsValid: true, IsHLTV: false }).ToList(); if (playersToTarget.Count > 1 && Config.OtherSettings.DisableDangerousCommands || playersToTarget.Count == 0) { return; } var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Helper.ParsePenaltyTime(command.GetArg(2)); playersToTarget.ForEach(player => { if (!caller!.CanTarget(player)) return; if (time < 0 && caller != null && caller.IsValid && Config.OtherSettings.ShowBanMenuIfNoTime) { DurationMenu.OpenMenu(caller, $"{_localizer?["sa_silence"] ?? "Silence"}: {player.PlayerName}", player, ManagePlayersMenu.SilenceMenu); return; } Silence(caller, player, time, reason, callerName, command); }); } /// /// Applies silence logical processing for a player - updates database and notifies. /// /// Admin/player applying the silence. /// Target player. /// Duration of silence. /// Reason for silence. /// Optional name of silent admin or console. /// Optional command details for logging. /// If true, suppresses logging notifications. internal void Silence(CCSPlayerController? caller, CCSPlayerController player, int time, string reason, string? callerName = null, CommandInfo? command = null, bool silent = false) { if (DatabaseProvider == null || !player.IsValid || !player.UserId.HasValue) return; if (!caller.CanTarget(player)) return; if (!CheckValidMute(caller, time)) return; // Set default caller name if not provided callerName ??= caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Get player and admin information var playerInfo = PlayersInfo[player.SteamID]; var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Asynchronously handle silence logic Task.Run(async () => { int? penaltyId = await MuteManager.MutePlayer(playerInfo, adminInfo, reason, time, 2); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedEvent(playerInfo, adminInfo, PenaltyType.Silence, reason, time, penaltyId); }); }); // Add penalty to the player's penalty manager PlayerPenaltyManager.AddPenalty(player.Slot, PenaltyType.Silence, Time.ActualDateTime().AddMinutes(time), time, reason); player.VoiceFlags = VoiceFlags.Muted; // Determine message keys and arguments based on silence time (permanent or timed) var (messageKey, activityMessageKey, playerArgs, adminActivityArgs) = time == 0 ? ("sa_player_silence_message_perm", "sa_admin_silence_message_perm", [reason, "CALLER"], ["CALLER", player.PlayerName, reason]) : ("sa_player_silence_message_time", "sa_admin_silence_message_time", new object[] { reason, time, "CALLER" }, new object[] { "CALLER", player.PlayerName, reason, time }); // Display center message to the silenced player Helper.DisplayCenterMessage(player, messageKey, callerName, playerArgs); // Display admin activity message to other players if (caller == null || !SilentPlayers.Contains(caller.Slot)) { Helper.ShowAdminActivity(activityMessageKey, callerName, false, adminActivityArgs); } // Increment the player's total silences count PlayersInfo[player.SteamID].TotalSilences++; // Log the silence command and send Discord notification if (!silent) { if (command == null) Helper.LogCommand(caller, $"css_silence {(string.IsNullOrEmpty(player.PlayerName) ? player.SteamID.ToString() : player.PlayerName)} {time} {reason}"); else Helper.LogCommand(caller, command); } Helper.SendDiscordPenaltyMessage(caller, player, reason, time, PenaltyType.Silence, _localizer); } /// /// Handles the 'AddSilence' command, applying a silence penalty to a player specified by SteamID, /// with support for offline player penalties. /// /// The player/admin issuing the command. /// The command input containing SteamID, optional time, and reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: "<#userid or name> [time in minutes/0 perm] [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnAddSilenceCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; // Set caller name var callerName = caller == null ? _localizer?["sa_console"] ?? "Console" : caller.PlayerName; // Validate command arguments if (command.ArgCount < 2 || string.IsNullOrEmpty(command.GetArg(1))) return; // Validate and extract SteamID if (!Helper.ValidateSteamId(command.GetArg(1), out var steamId) || steamId == null) { command.ReplyToCommand("Invalid SteamID64."); return; } var steamid = steamId.SteamId64; var reason = command.ArgCount >= 3 ? string.Join(" ", Enumerable.Range(3, command.ArgCount - 3).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; var time = Math.Max(0, Helper.ParsePenaltyTime(command.GetArg(2))); if (!CheckValidMute(caller, time)) return; // Get player and admin info var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; // Attempt to match player based on SteamID var player = Helper.GetPlayerFromSteamid64(steamid); if (player != null && player.IsValid) { // Check if caller can target the player if (!caller.CanTarget(player)) return; // Perform the silence for an online player Silence(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(new SteamID(steamId.SteamId64))) return; // Asynchronous silence operation for offline players Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid, adminInfo, reason, time, 2); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamId, adminInfo, PenaltyType.Silence, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.ToString(), reason, time, PenaltyType.Silence, _localizer); command.ReplyToCommand($"Player with steamid {steamid} is not online. Silence has been added offline."); } // Log the silence command and respond to the command Helper.LogCommand(caller, command); } /// /// Adds a silence penalty to a player by Steam ID. Manages both online and offline player cases. /// /// Admin/player initiating the silence. /// Steam ID of player. /// Duration of silence. /// Reason for the penalty. /// Optional mute manager for DB operations. internal void AddSilence(CCSPlayerController? caller, SteamID steamid, int time, string reason, MuteManager? muteManager = null) { // Set default caller name if not provided var callerName = !string.IsNullOrEmpty(caller?.PlayerName) ? caller.PlayerName : (_localizer?["sa_console"] ?? "Console"); var adminInfo = caller != null && caller.UserId.HasValue ? PlayersInfo[caller.SteamID] : null; var player = Helper.GetPlayerFromSteamid64(steamid.SteamId64); if (player != null && player.IsValid) { if (!caller.CanTarget(player)) return; Silence(caller, player, time, reason, callerName, silent: true); } else { if (!caller.CanTarget(steamid)) return; // Asynchronous ban operation if player is not online or not found Task.Run(async () => { int? penaltyId = await MuteManager.AddMuteBySteamid(steamid.SteamId64, adminInfo, reason, time, 2); await Server.NextWorldUpdateAsync(() => { SimpleAdminApi?.OnPlayerPenaltiedAddedEvent(steamid, adminInfo, PenaltyType.Silence, reason, time, penaltyId); }); }); Helper.SendDiscordPenaltyMessage(caller, steamid.SteamId64.ToString(), reason, time, PenaltyType.Silence, _localizer); } } /// /// Removes the silence penalty from a player, either by SteamID, name, or offline pattern. /// Resets voice settings and updates notices accordingly. /// /// Admin/player issuing the unsilence. /// Command arguments with target pattern and optional reason. [RequiresPermissions("@css/chat")] [CommandHelper(minArgs: 1, usage: " [reason]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)] public void OnUnsilenceCommand(CCSPlayerController? caller, CommandInfo command) { if (DatabaseProvider == null) return; var callerSteamId = caller?.SteamID.ToString() ?? _localizer?["sa_console"] ?? "Console"; var pattern = command.GetArg(1); var reason = command.ArgCount >= 2 ? string.Join(" ", Enumerable.Range(2, command.ArgCount - 2).Select(command.GetArg)).Trim() : _localizer?["sa_unknown"] ?? "Unknown"; reason = string.IsNullOrWhiteSpace(reason) ? _localizer?["sa_unknown"] ?? "Unknown" : reason; if (pattern.Length <= 1) { command.ReplyToCommand("Too short pattern to search."); return; } Helper.LogCommand(caller, command); // Check if pattern is a valid SteamID64 if (Helper.ValidateSteamId(pattern, out var steamId) && steamId != null) { var player = Helper.GetPlayerFromSteamid64(steamId.SteamId64); if (player != null && player.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(player.Slot, PenaltyType.Silence); // Reset voice flags to normal player.VoiceFlags = VoiceFlags.Normal; Task.Run(async () => { await MuteManager.UnmutePlayer(player.SteamID.ToString(), callerSteamId, reason, 2); // Unmute by type 2 (silence) }); command.ReplyToCommand($"Unsilenced player {player.PlayerName}."); return; } } // If not a valid SteamID64, check by player name var nameMatches = Helper.GetPlayerFromName(pattern); var namePlayer = nameMatches.Count == 1 ? nameMatches.FirstOrDefault() : null; if (namePlayer != null && namePlayer.IsValid) { PlayerPenaltyManager.RemovePenaltiesByType(namePlayer.Slot, PenaltyType.Silence); // Reset voice flags to normal namePlayer.VoiceFlags = VoiceFlags.Normal; if (namePlayer.UserId.HasValue && PlayersInfo[namePlayer.SteamID].TotalSilences > 0) PlayersInfo[namePlayer.SteamID].TotalSilences--; Task.Run(async () => { await MuteManager.UnmutePlayer(namePlayer.SteamID.ToString(), callerSteamId, reason, 2); // Unmute by type 2 (silence) }); command.ReplyToCommand($"Unsilenced player {namePlayer.PlayerName}."); } else { Task.Run(async () => { await MuteManager.UnmutePlayer(pattern, callerSteamId, reason, 2); // Unmute by type 2 (silence) }); command.ReplyToCommand($"Unsilenced offline player with pattern {pattern}."); } } /// /// Validates mute penalty duration based on admin privileges and configured max duration. /// /// Admin/player issuing the mute. /// Requested duration in minutes. /// True if mute penalty duration is allowed; false otherwise. private bool CheckValidMute(CCSPlayerController? caller, int duration) { if (caller == null) return true; var canPermMute = AdminManager.PlayerHasPermissions(new SteamID(caller.SteamID), "@css/permmute"); if (duration <= 0 && !canPermMute) { caller.PrintToChat($"{_localizer!["sa_prefix"]} {_localizer["sa_ban_perm_restricted"]}"); return false; } if (duration <= Config.OtherSettings.MaxMuteDuration || canPermMute) return true; caller.PrintToChat($"{_localizer!["sa_prefix"]} {_localizer["sa_ban_max_duration_exceeded", Config.OtherSettings.MaxMuteDuration]}"); return false; } }