From 8bca02032f53bd4f1d25519e285f5a850830e0d1 Mon Sep 17 00:00:00 2001
From: asleepyskye <skye@vixen.lgbt>
Date: Tue, 9 Sep 2025 10:43:00 -0400
Subject: [PATCH] feat(bot): add utility admin command

---
 PluralKit.Bot/CommandMeta/CommandTree.cs |  2 ++
 PluralKit.Bot/Commands/Admin.cs          | 30 ++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/PluralKit.Bot/CommandMeta/CommandTree.cs b/PluralKit.Bot/CommandMeta/CommandTree.cs
index 67379fe1..d1ab6da0 100644
--- a/PluralKit.Bot/CommandMeta/CommandTree.cs
+++ b/PluralKit.Bot/CommandMeta/CommandTree.cs
@@ -181,6 +181,8 @@ public partial class CommandTree
             await ctx.Execute<Admin>(Admin, a => a.SystemRecover(ctx));
         else if (ctx.Match("sd", "systemdelete"))
             await ctx.Execute<Admin>(Admin, a => a.SystemDelete(ctx));
+        else if (ctx.Match("sendmsg", "sendmessage"))
+            await ctx.Execute<Admin>(Admin, a => a.SendAdminMessage(ctx));
         else if (ctx.Match("al", "abuselog"))
             await HandleAdminAbuseLogCommand(ctx);
         else
diff --git a/PluralKit.Bot/Commands/Admin.cs b/PluralKit.Bot/Commands/Admin.cs
index a31b0dd0..da859616 100644
--- a/PluralKit.Bot/Commands/Admin.cs
+++ b/PluralKit.Bot/Commands/Admin.cs
@@ -9,6 +9,7 @@ using Myriad.Extensions;
 using Myriad.Cache;
 using Myriad.Rest;
 using Myriad.Types;
+using Myriad.Rest.Types.Requests;
 
 using PluralKit.Core;
 
@@ -496,4 +497,33 @@ public class Admin
         await ctx.Repository.DeleteAbuseLog(abuseLog.Id);
         await ctx.Reply($"{Emojis.Success} Successfully deleted abuse log entry.");
     }
+
+    public async Task SendAdminMessage(Context ctx)
+    {
+        ctx.AssertBotAdmin();
+
+        var account = await ctx.MatchUser();
+        if (account == null)
+            throw new PKError("You must pass an account to send an admin message to (either ID or @mention).");
+        if (!ctx.HasNext())
+            throw new PKError("You must provide a message to send.");
+
+        var content = ctx.RemainderOrNull(false).NormalizeLineEndSpacing();
+        var messageContent = $"## [Admin Message]\n\n{content}\n\nWe cannot read replies sent to this DM. If you wish to contact the staff team, please join the support server (<https://discord.gg/PczBt78>) or send us an email at <legal@pluralkit.me>.";
+
+        try
+        {
+            var dm = await _rest.CreateDm(account.Id);
+            var msg = await ctx.Rest.CreateMessage(dm.Id,
+                new MessageRequest { Content = messageContent }
+            );
+        }
+        catch (Exception)
+        {
+            await ctx.Reply(
+                $"{Emojis.Error} Error while sending DM.");
+        }
+
+        await ctx.Reply($"{Emojis.Success} Successfully sent message.");
+    }
 }
\ No newline at end of file