feat(bot): Everything.

payphone/cogs/admin/cog.py

@@ -0,0 +1,61 @@
+from discord.ext import commands
+
+from tortoise import transactions
+
+from payphone import bot
+from payphone.cogs import base
+
+
+class Admin(base.Cog):
+    def __init__(self, bot_instance: bot.Payphone):
+        self.bot = bot_instance
+
+    @commands.group(invoke_without_command=True)
+    @commands.guild_only()
+    @commands.has_guild_permissions(manage_guild=True)
+    async def config(
+        self, ctx: commands.Context, setting: str = "", value: str | None = None
+    ) -> None:
+        """
+        Set up Payphone for the current server.
+
+        Settings:
+        - `prefix`: Set a custom prefix.
+
+        You can use `{prefix}help config <setting>` to get help about a specific configuration.
+        """
+
+        await ctx.send_help("config")
+
+    @config.command(extras={"help_name": "Prefix"})
+    @commands.guild_only()
+    @commands.has_guild_permissions(manage_guild=True)
+    @transactions.atomic()
+    async def prefix(self, ctx: commands.Context, prefix: str = "p.") -> None:
+        """
+        Set a custom bot prefix.
+
+        Options:
+        - `<prefix>`: The new custom prefix.
+
+        Permissions:
+        - Manage Server
+        """
+
+        try:
+            await self.bot.set_prefix(ctx.guild, prefix)
+        except ValueError:
+            await ctx.send("❌ The prefix must not be longer than 3 characters.")
+            return
+
+        await ctx.send(f"✅ The prefix was set to `{prefix}`!")
+
+
+def setup(b: bot.Payphone) -> None:
+    """Load the cog into the bot.
+
+    Args:
+        b (bot.Payphone): The bot instance to load the cog into.
+    """
+
+    b.add_cog(Admin(b))