Merge pull request #284 from MrDave1999/feat/issue-278

feat: allow moderators to reset the flag to its base position

src/Application/Common/Resources/Messages.resx

@@ -225,6 +225,9 @@
   <data name="InvalidAddCoins" xml:space="preserve">
     <value>Coins must be between 1 to 100</value>
   </data>
+  <data name="InvalidFlagColor" xml:space="preserve">
+    <value>Invalid color. Only 'red' and 'blue' are valid options for this command</value>
+  </data>
   <data name="InvalidInterval" xml:space="preserve">
     <value>The interval must be between 0 to {Max}</value>
   </data>
@@ -420,6 +423,9 @@
   <data name="ReportToAnotherPlayer" xml:space="preserve">
     <value>{CurrentPlayer} reported to {TargetPlayer} [Reason: {Reason}]</value>
   </data>
+  <data name="ResetFlagPosition" xml:space="preserve">
+    <value>{PlayerName} has reset the {ColorName} flag to its base position</value>
+  </data>
   <data name="ResetPlayerStats" xml:space="preserve">
     <value>{PlayerName} has reset their stats, such as score, kills and deaths</value>
   </data>

src/Application/Players/GeneralCommands/Resources/DetailedCommandInfo.resx

@@ -165,6 +165,7 @@ Beware! Enemies will see flag carriers on their radar as well!</value>
   <data name="Moderator" xml:space="preserve">
     <value>{Color1}/maps: {Color2}Displays a list of available maps in the game.
 {Color1}/settimeleft: {Color2}Sets the remaining time for the current game session.
+{Color1}/resetflag: {Color2}Resets the flag of a specific team to its base position.
 {Color1}/startrt: {Color2}Starts the rotation timer for the current map.
 {Color1}/stoprt: {Color2}Stops the rotation timer for the current map.
 {Color1}/showrm: {Color2}Allows to show flag carriers on the radar map.

src/Application/Teams/Flags/Systems/ResetFlagSystem.cs

@@ -0,0 +1,49 @@
+namespace CTF.Application.Teams.Flags.Systems;
+
+public class ResetFlagSystem(
+    IWorldService worldService,
+    TeamPickupService teamPickupService,
+    TeamSoundsService teamSoundsService,
+    FlagAutoReturnTimer flagAutoReturnTimer) : ISystem
+{
+    [PlayerCommand("resetflag")]
+    public void ResetToBasePosition(
+        Player player, 
+        [CommandParameter(Name = "red/blue")]string color)
+    {
+        if (player.HasLowerRoleThan(RoleId.Moderator))
+            return;
+
+        Team team = color.ToLower() switch
+        {
+            "red" => Team.Alpha,
+            "blue" => Team.Beta,
+            _ => null
+        };
+
+        if (team is null)
+        {
+            player.SendClientMessage(Color.Red, Messages.InvalidFlagColor);
+            return;
+        }
+
+        ResetFlagPosition(player, team);
+    }
+
+    private void ResetFlagPosition(Player player, Team team)
+    {
+        var message = Smart.Format(Messages.ResetFlagPosition, new
+        {
+            PlayerName = player.Name,
+            team.ColorName
+        });
+        team.IsFlagAtBasePosition = true;
+        team.Flag.RemoveCarrier();
+        teamPickupService.CreateFlagFromBasePosition(team);
+        teamPickupService.DestroyExteriorMarker(team);
+        teamSoundsService.PlayFlagReturnedSound(team);
+        flagAutoReturnTimer.Stop(team);
+        worldService.GameText($"~n~~n~~n~{team.GameText}{team.ColorName} flag returned!", 5000, 3);
+        worldService.SendClientMessage(Color.Yellow, message);
+    }
+}