Merge pull request 'feat: add advanced translator cog with proxy and languages' (#13) from translator into main

Reviewed-on: #13

hiring/__init__.py

@@ -0,0 +1,4 @@
+from .hiring import setup
+
+# This function is required for the cog to be loaded by Red.
+# It simply imports the setup function from the main cog file.

hiring/hiring.py

@@ -0,0 +1,253 @@
+import discord
+from redbot.core import commands, Config
+from redbot.core.bot import Red
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from hiring.hiring import Hiring
+
+# --- Modals for the Application Forms ---
+
+class StaffApplicationModal(discord.ui.Modal, title="Staff Application"):
+    chosen_plan = discord.ui.TextInput(label="What plan are you interested in?")
+    tox_level = discord.ui.TextInput(label="What is your toxicity level tolerance?")
+    describe_server = discord.ui.TextInput(label="Please describe your server.", style=discord.TextStyle.paragraph)
+    server_link = discord.ui.TextInput(label="Server Link")
+
+    async def on_submit(self, interaction: discord.Interaction):
+        embed = discord.Embed(
+            title="New Staff Application",
+            description=f"Submitted by {interaction.user.mention}",
+            color=0xadd8e6
+        )
+        embed.add_field(name="Chosen Plan", value=self.chosen_plan.value, inline=False)
+        embed.add_field(name="Toxicity Level", value=self.tox_level.value, inline=False)
+        embed.add_field(name="Server Description", value=self.describe_server.value, inline=False)
+        embed.add_field(name="Server Link", value=self.server_link.value, inline=False)
+        
+        await interaction.response.send_message("Your application has been submitted!", ephemeral=True)
+        if isinstance(interaction.channel, discord.TextChannel):
+            await interaction.channel.send(embed=embed)
+
+
+class PMApplicationModal(discord.ui.Modal, title="PM Application"):
+    ad = discord.ui.TextInput(label="Please provide your server ad.", style=discord.TextStyle.paragraph)
+    reqs = discord.ui.TextInput(label="What are your requirements?")
+    tox_level = discord.ui.TextInput(label="What is your toxicity level tolerance?")
+    chosen_plan = discord.ui.TextInput(label="What plan are you interested in?")
+
+    async def on_submit(self, interaction: discord.Interaction):
+        embed = discord.Embed(
+            title="New PM Application",
+            description=f"Submitted by {interaction.user.mention}",
+            color=0xadd8e6
+        )
+        embed.add_field(name="Server Ad", value=f"```\n{self.ad.value}\n```", inline=False)
+        embed.add_field(name="Requirements", value=self.reqs.value, inline=False)
+        embed.add_field(name="Toxicity Level", value=self.tox_level.value, inline=False)
+        embed.add_field(name="Chosen Plan", value=self.chosen_plan.value, inline=False)
+        await interaction.response.send_message("Your application has been submitted!", ephemeral=True)
+        if isinstance(interaction.channel, discord.TextChannel):
+            await interaction.channel.send(embed=embed)
+
+class HPMApplicationModal(discord.ui.Modal, title="HPM Application"):
+    ad = discord.ui.TextInput(label="Please provide your server ad.", style=discord.TextStyle.paragraph)
+    reqs = discord.ui.TextInput(label="What are your requirements?")
+    
+    async def on_submit(self, interaction: discord.Interaction):
+        embed = discord.Embed(
+            title="New HPM Application",
+            description=f"Submitted by {interaction.user.mention}",
+            color=0xadd8e6
+        )
+        embed.add_field(name="Server Ad", value=f"```\n{self.ad.value}\n```", inline=False)
+        embed.add_field(name="Requirements", value=self.reqs.value, inline=False)
+        await interaction.response.send_message("Your application has been submitted!", ephemeral=True)
+        if isinstance(interaction.channel, discord.TextChannel):
+            await interaction.channel.send(embed=embed)
+
+
+# --- Reusable Ticket Creation Logic ---
+async def create_ticket(interaction: discord.Interaction, role_type: str, category_id: Optional[int], modal: discord.ui.Modal):
+    if not interaction.guild:
+        await interaction.response.send_message("This interaction must be used in a server.", ephemeral=True)
+        return
+
+    if not category_id:
+        await interaction.response.send_message(f"The category for '{role_type}' applications has not been set by an admin.", ephemeral=True)
+        return
+        
+    category = interaction.guild.get_channel(category_id)
+    if not isinstance(category, discord.CategoryChannel):
+        await interaction.response.send_message(f"The category for '{role_type}' applications is invalid or has been deleted.", ephemeral=True)
+        return
+        
+    ticket_name = f"{role_type}-app-{interaction.user.name}"
+    
+    try:
+        overwrites = {
+            interaction.guild.default_role: discord.PermissionOverwrite(read_messages=False),
+            interaction.user: discord.PermissionOverwrite(read_messages=True, send_messages=True),
+            interaction.guild.me: discord.PermissionOverwrite(read_messages=True, send_messages=True)
+        }
+        ticket_channel = await interaction.guild.create_text_channel(
+            name=ticket_name, 
+            category=category,
+            overwrites=overwrites
+        )
+        await ticket_channel.send(f"Welcome {interaction.user.mention}! Please fill out the form to complete your application.")
+        await interaction.response.send_modal(modal)
+
+    except discord.Forbidden:
+        if interaction.response.is_done():
+             await interaction.followup.send("I don't have permission to create channels in that category.", ephemeral=True)
+        else:
+             await interaction.response.send_message("I don't have permission to create channels in that category.", ephemeral=True)
+    except Exception as e:
+        if interaction.response.is_done():
+            await interaction.followup.send(f"An unexpected error occurred: {e}", ephemeral=True)
+        else:
+            await interaction.response.send_message(f"An unexpected error occurred: {e}", ephemeral=True)
+
+
+# --- Button Views for Commands ---
+
+class HireView(discord.ui.View):
+    def __init__(self, cog: "Hiring"):
+        super().__init__(timeout=None)
+        self.cog = cog
+
+    @discord.ui.button(label="Staff", style=discord.ButtonStyle.primary, custom_id="staff_apply_button")
+    async def staff_button(self, interaction: discord.Interaction, button: discord.ui.Button):
+        if not interaction.guild: return
+        category_id = await self.cog.config.guild(interaction.guild).staff_category()
+        await create_ticket(interaction, "staff", category_id, StaffApplicationModal())
+
+    @discord.ui.button(label="PM", style=discord.ButtonStyle.secondary, custom_id="pm_apply_button")
+    async def pm_button(self, interaction: discord.Interaction, button: discord.ui.Button):
+        if not interaction.guild: return
+        category_id = await self.cog.config.guild(interaction.guild).pm_category()
+        await create_ticket(interaction, "pm", category_id, PMApplicationModal())
+
+    @discord.ui.button(label="HPM", style=discord.ButtonStyle.success, custom_id="hpm_apply_button")
+    async def hpm_button(self, interaction: discord.Interaction, button: discord.ui.Button):
+        if not interaction.guild: return
+        category_id = await self.cog.config.guild(interaction.guild).hpm_category()
+        await create_ticket(interaction, "hpm", category_id, HPMApplicationModal())
+
+
+class WorkView(discord.ui.View):
+    def __init__(self, cog: "Hiring"):
+        super().__init__(timeout=None)
+        self.cog = cog
+
+    @discord.ui.button(label="Apply for PM Position", style=discord.ButtonStyle.blurple, custom_id="work_apply_button")
+    async def work_button(self, interaction: discord.Interaction, button: discord.ui.Button):
+        if not interaction.guild: return
+        category_id = await self.cog.config.guild(interaction.guild).pm_category()
+        await create_ticket(interaction, "pm", category_id, PMApplicationModal())
+
+
+class Hiring(commands.Cog):
+    """
+    A cog for managing staff and PM applications.
+    """
+
+    def __init__(self, bot: Red):
+        self.bot = bot
+        self.config = Config.get_conf(self, identifier=1122334455, force_registration=True)
+
+        default_guild = {
+            "hpm_category": None,
+            "pm_category": None,
+            "staff_category": None,
+            "work_channel": None # New setting for the /work command channel
+        }
+        self.config.register_guild(**default_guild)
+        # We need to make sure the views are persistent so buttons work after a restart
+        self.bot.add_view(HireView(self))
+        self.bot.add_view(WorkView(self))
+
+
+    # --- Commands ---
+    @commands.hybrid_command() # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def hire(self, ctx: commands.Context):
+        """Post the application message with buttons in the current channel."""
+        embed = discord.Embed(
+            title="Start an Application",
+            description="Click a button below to open a ticket for the role you are interested in.",
+            color=0xadd8e6
+        )
+        await ctx.send(embed=embed, view=HireView(self))
+
+    @commands.hybrid_command() # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def work(self, ctx: commands.Context):
+        """Post the PM hiring message in the configured work channel."""
+        if not ctx.guild:
+            return
+        work_channel_id = await self.config.guild(ctx.guild).work_channel()
+        if not work_channel_id:
+            await ctx.send("The work channel has not been set. Please use `[p]hiringset workchannel` to set it.", ephemeral=True)
+            return
+
+        work_channel = ctx.guild.get_channel(work_channel_id)
+        if not isinstance(work_channel, discord.TextChannel):
+            await ctx.send("The configured work channel is invalid or has been deleted.", ephemeral=True)
+            return
+            
+        embed = discord.Embed(
+            title="Now Hiring: Partnership Managers",
+            description="We are for talented Partnership Managers (PMs) to join our team. If you are interested in applying, please click the button below to begin the application process.",
+            color=0xadd8e6
+        )
+        try:
+            await work_channel.send(embed=embed, view=WorkView(self))
+            await ctx.send(f"Hiring message posted in {work_channel.mention}.", ephemeral=True)
+        except discord.Forbidden:
+            await ctx.send(f"I don't have permission to send messages in {work_channel.mention}.", ephemeral=True)
+
+
+    # --- Settings Commands ---
+    @commands.group(aliases=["hset"]) # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def hiringset(self, ctx: commands.Context):
+        """Configure the Hiring cog settings."""
+        pass
+
+    @hiringset.command(name="staffcategory")
+    async def set_staff_category(self, ctx: commands.Context, category: discord.CategoryChannel):
+        """Set the category for Staff applications."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).staff_category.set(category.id)
+        await ctx.send(f"Staff application category set to **{category.name}**.")
+
+    @hiringset.command(name="pmcategory")
+    async def set_pm_category(self, ctx: commands.Context, category: discord.CategoryChannel):
+        """Set the category for PM applications."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).pm_category.set(category.id)
+        await ctx.send(f"PM application category set to **{category.name}**.")
+
+    @hiringset.command(name="hpmcategory")
+    async def set_hpm_category(self, ctx: commands.Context, category: discord.CategoryChannel):
+        """Set the category for HPM applications."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).hpm_category.set(category.id)
+        await ctx.send(f"HPM application category set to **{category.name}**.")
+        
+    @hiringset.command(name="workchannel")
+    async def set_work_channel(self, ctx: commands.Context, channel: discord.TextChannel):
+        """Set the channel where the /work hiring message will be posted."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).work_channel.set(channel.id)
+        await ctx.send(f"The work channel has been set to {channel.mention}.")
+
+
+async def setup(bot: Red):
+    await bot.add_cog(Hiring(bot))
+

hiring/info.json

@@ -0,0 +1,15 @@
+{
+  "author": [ "unstableCogs" ],
+  "install_msg": "Thank you for installing the Hiring cog! Use `[p]help Hiring` for a list of commands.",
+  "name": "Hiring",
+  "short": "A ticket-based system for staff and PM applications.",
+  "description": "Provides /hire and /work commands to manage the staff and PM hiring process through a ticket system with forms and buttons.",
+  "tags": [
+    "hiring",
+    "tickets",
+    "utility",
+    "modmail"
+  ],
+  "requirements": [],
+  "end_user_data_statement": "This cog stores user IDs and the content of their applications for the duration of the hiring process."
+}

info.json

@@ -1,6 +1,6 @@
 {
     "author" : ["KWUK"],
-    "install_msg" : "Thank you for installing my repo! If you need support, create an issue on Gitea or ping me in KWDS.",
+    "install_msg" : "Thank you for installing my repo! If you need support, create an issue on Gitea or ping me in KWDS. Cogs: hiring, kbump, kofishop, modmail, mors, pp, rpg, iservice, welcomer. ",
     "name" : "unstable-cogs",
     "short" : "Cogs for Red-DiscordBot!",
     "description" : "Cogs for Red-DiscordBot!",

kofishop/__init__.py

@@ -0,0 +1 @@
+from .kofishop import setup

kofishop/kofishop.py

@@ -0,0 +1,175 @@
+import discord
+from redbot.core import commands, Config
+from redbot.core.bot import Red
+from typing import Optional
+
+# --- Modals for the Commands ---
+
+class OrderModal(discord.ui.Modal, title="Commission/Shop Order"):
+    def __init__(self, cog: "KofiShop"):
+        super().__init__()
+        self.cog = cog
+
+    comm_type = discord.ui.TextInput(label="What type of commission/item is this?")
+    payment_status = discord.ui.TextInput(label="Is this free or paid?")
+    description = discord.ui.TextInput(label="Please describe your request.", style=discord.TextStyle.paragraph)
+    questions = discord.ui.TextInput(label="Any questions for the artist?", style=discord.TextStyle.paragraph, required=False)
+
+    async def on_submit(self, interaction: discord.Interaction):
+        if not interaction.guild:
+            return await interaction.response.send_message("This must be used in a server.", ephemeral=True)
+
+        order_channel_id = await self.cog.config.guild(interaction.guild).order_channel()
+        if not order_channel_id:
+            return await interaction.response.send_message("The order channel has not been set by an admin.", ephemeral=True)
+
+        order_channel = interaction.guild.get_channel(order_channel_id)
+        if not isinstance(order_channel, discord.TextChannel):
+            return await interaction.response.send_message("The configured order channel is invalid.", ephemeral=True)
+
+        embed = discord.Embed(
+            title="New Order Placed",
+            description=f"Submitted by {interaction.user.mention}",
+            color=0x00ff00 # Green for new orders
+        )
+        embed.add_field(name="Item/Commission Type", value=self.comm_type.value, inline=False)
+        embed.add_field(name="Payment Status", value=self.payment_status.value, inline=False)
+        embed.add_field(name="Description", value=self.description.value, inline=False)
+        if self.questions.value:
+            embed.add_field(name="Questions", value=self.questions.value, inline=False)
+        
+        try:
+            await order_channel.send(embed=embed)
+            await interaction.response.send_message("Your order has been successfully submitted!", ephemeral=True)
+        except discord.Forbidden:
+            await interaction.response.send_message("I don't have permission to send messages in the order channel.", ephemeral=True)
+
+class ReviewModal(discord.ui.Modal, title="Leave a Review"):
+    def __init__(self, cog: "KofiShop"):
+        super().__init__()
+        self.cog = cog
+
+    item_name = discord.ui.TextInput(label="What item/commission are you reviewing?")
+    rating = discord.ui.TextInput(label="Rating (e.g., 10/10)")
+    review_text = discord.ui.TextInput(label="Your Review", style=discord.TextStyle.paragraph)
+
+    async def on_submit(self, interaction: discord.Interaction):
+        if not interaction.guild:
+            return await interaction.response.send_message("This must be used in a server.", ephemeral=True)
+
+        review_channel_id = await self.cog.config.guild(interaction.guild).review_channel()
+        if not review_channel_id:
+            return await interaction.response.send_message("The review channel has not been set by an admin.", ephemeral=True)
+
+        review_channel = interaction.guild.get_channel(review_channel_id)
+        if not isinstance(review_channel, discord.TextChannel):
+            return await interaction.response.send_message("The configured review channel is invalid.", ephemeral=True)
+
+        embed = discord.Embed(
+            title=f"New Review for: {self.item_name.value}",
+            description=f"Submitted by {interaction.user.mention}",
+            color=0xadd8e6 # Pastel Blue
+        )
+        embed.add_field(name="Rating", value=self.rating.value, inline=False)
+        embed.add_field(name="Review", value=self.review_text.value, inline=False)
+        
+        try:
+            await review_channel.send(embed=embed)
+            await interaction.response.send_message("Thank you! Your review has been submitted.", ephemeral=True)
+        except discord.Forbidden:
+            await interaction.response.send_message("I don't have permission to send messages in the review channel.", ephemeral=True)
+
+
+class KofiShop(commands.Cog):
+    """
+    A cog to manage Ko-fi shop orders and reviews.
+    """
+
+    def __init__(self, bot: Red):
+        self.bot = bot
+        self.config = Config.get_conf(self, identifier=5566778899, force_registration=True)
+
+        default_guild = {
+            "order_channel": None,
+            "review_channel": None,
+            "waitlist_channel": None
+        }
+        self.config.register_guild(**default_guild)
+
+    # --- Commands ---
+    @commands.hybrid_command()
+    @commands.guild_only()
+    async def order(self, ctx: commands.Context):
+        """Place an order for a shop or commission item."""
+        if not ctx.interaction:
+            return
+        # We pass `self` (the cog instance) to the modal
+        await ctx.interaction.response.send_modal(OrderModal(self))
+
+    @commands.hybrid_command()
+    @commands.guild_only()
+    async def review(self, ctx: commands.Context):
+        """Leave a review for a completed shop or commission item."""
+        if not ctx.interaction:
+            return
+        await ctx.interaction.response.send_modal(ReviewModal(self))
+
+    @commands.hybrid_command() # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def waitlist(self, ctx: commands.Context, user: discord.Member, *, item: str):
+        """Add a user and their requested item to the waitlist."""
+        if not ctx.guild or not isinstance(ctx.channel, discord.TextChannel):
+             return await ctx.send("This command must be used in a server's text channel.", ephemeral=True)
+        
+        waitlist_channel_id = await self.config.guild(ctx.guild).waitlist_channel()
+        if not waitlist_channel_id:
+            return await ctx.send("The waitlist channel has not been set by an admin.", ephemeral=True)
+
+        waitlist_channel = ctx.guild.get_channel(waitlist_channel_id)
+        if not isinstance(waitlist_channel, discord.TextChannel):
+            return await ctx.send("The configured waitlist channel is invalid.", ephemeral=True)
+
+        message = f"**{item}** ིྀ  {user.mention} ✧  in {ctx.channel.mention}"
+        
+        try:
+            await waitlist_channel.send(message)
+            await ctx.send(f"{user.mention} has been added to the waitlist for '{item}'.", ephemeral=True)
+        except discord.Forbidden:
+            await ctx.send(f"I don't have permission to send messages in the waitlist channel.", ephemeral=True)
+
+    # --- Settings Commands ---
+    @commands.group(aliases=["kset"]) # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def kofiset(self, ctx: commands.Context):
+        """
+        Configure the KofiShop settings.
+        """
+        pass
+
+    @kofiset.command(name="orderchannel")
+    async def kofiset_order(self, ctx: commands.Context, channel: discord.TextChannel):
+        """Set the channel where new orders will be sent."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).order_channel.set(channel.id)
+        await ctx.send(f"Order channel has been set to {channel.mention}.")
+
+    @kofiset.command(name="reviewchannel")
+    async def kofiset_review(self, ctx: commands.Context, channel: discord.TextChannel):
+        """Set the channel where new reviews will be sent."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).review_channel.set(channel.id)
+        await ctx.send(f"Review channel has been set to {channel.mention}.")
+
+    @kofiset.command(name="waitlistchannel")
+    async def kofiset_waitlist(self, ctx: commands.Context, channel: discord.TextChannel):
+        """Set the channel where waitlist notifications will be sent."""
+        if not ctx.guild: return
+        await self.config.guild(ctx.guild).waitlist_channel.set(channel.id)
+        await ctx.send(f"Waitlist channel has been set to {channel.mention}.")
+
+
+async def setup(bot: Red):
+    await bot.add_cog(KofiShop(bot))
+

modmail/__init__.py

@@ -0,0 +1 @@
+from .modmail import setup

modmail/modmail.py

@@ -0,0 +1,218 @@
+import discord
+from redbot.core import commands, Config
+from redbot.core.bot import Red
+from typing import Optional
+
+class ModMail(commands.Cog):
+    """
+    A configurable, forum-based ModMail system.
+    """
+
+    def __init__(self, bot: Red):
+        self.bot = bot
+        # Initialize Red's Config system for storing settings per-server.
+        self.config = Config.get_conf(self, identifier=9876543210, force_registration=True)
+
+        # Define the default settings for each server.
+        default_guild = {
+            "modmail_forum": None,  # The ID of the forum channel for tickets
+            "enabled": False,       # Whether the system is on or off
+            "active_threads": {}    # A dictionary to track {user_id: thread_id}
+        }
+
+        # Register the default settings.
+        self.config.register_guild(**default_guild)
+
+    @commands.Cog.listener()
+    async def on_message(self, message: discord.Message):
+        """
+        This is the core event listener. It handles both incoming DMs from users
+        and outgoing replies from staff.
+        """
+        # Ignore messages from bots to prevent loops.
+        if message.author.bot:
+            return
+
+        # --- Part 1: Handling DMs from Users ---
+        if isinstance(message.channel, discord.DMChannel):
+            await self.handle_dm(message)
+        
+        # --- Part 2: Handling Replies from Staff ---
+        elif isinstance(message.channel, discord.Thread):
+            await self.handle_staff_reply(message)
+
+    async def handle_dm(self, message: discord.Message):
+        """Handles messages sent directly to the bot."""
+        # Find a mutual server with the user.
+        guild = next((g for g in self.bot.guilds if g.get_member(message.author.id)), None)
+        if not guild:
+            return
+
+        settings = await self.config.guild(guild).all()
+        if not settings["enabled"] or not settings["modmail_forum"]:
+            return
+
+        forum_channel = guild.get_channel(settings["modmail_forum"])
+        if not isinstance(forum_channel, discord.ForumChannel):
+            return
+
+        active_threads = settings["active_threads"]
+        user_id_str = str(message.author.id)
+
+        # Check if the user already has an active thread.
+        if user_id_str in active_threads:
+            thread_id = active_threads[user_id_str]
+            thread = guild.get_thread(thread_id)
+            if thread:
+                # Relay the message to the existing thread.
+                await thread.send(f"**{message.author.display_name}:** {message.content}")
+                await message.add_reaction("✅")
+                return
+            else:
+                # The thread was deleted, so we clean up our records.
+                async with self.config.guild(guild).active_threads() as threads:
+                    del threads[user_id_str]
+
+        # Create a new thread for the user.
+        try:
+            thread_name = f"ModMail | {message.author.name}"
+            embed = discord.Embed(
+                title=f"New ModMail Thread",
+                description=f"**User:** {message.author.mention} (`{message.author.id}`)",
+                color=0xadd8e6 # Light grey pastel blue
+            )
+            embed.add_field(name="Initial Message", value=message.content, inline=False)
+            embed.set_footer(text="Staff can reply in this thread to send a message.")
+            
+            thread_with_message = await forum_channel.create_thread(name=thread_name, embed=embed)
+            thread = thread_with_message.thread
+
+            async with self.config.guild(guild).active_threads() as threads:
+                threads[user_id_str] = thread.id
+            
+            await message.channel.send("Your message has been received, and a ModMail ticket has been opened. Staff will be with you shortly.")
+            await message.add_reaction("✅")
+        except discord.Forbidden:
+            print(f"ModMail: I don't have permission to create threads in {forum_channel.name}.")
+        except Exception as e:
+            print(f"ModMail: An unexpected error occurred: {e}")
+
+    async def handle_staff_reply(self, message: discord.Message):
+        """Handles messages sent by staff inside a ModMail thread."""
+        guild = message.guild
+        if not guild:
+            return
+
+        active_threads = await self.config.guild(guild).active_threads()
+        
+        # Find which user this thread belongs to by checking our records.
+        thread_id_str = str(message.channel.id)
+        user_id = None
+        for uid, tid in active_threads.items():
+            if str(tid) == thread_id_str:
+                user_id = int(uid)
+                break
+        
+        if not user_id:
+            # This is a regular thread, not a ModMail thread we're tracking.
+            return
+
+        user = guild.get_member(user_id)
+        if not user:
+            # User might have left the server.
+            await message.channel.send("⚠️ **Error:** Could not find the user. They may have left the server.")
+            return
+
+        # Send the staff's message to the user's DMs.
+        try:
+            embed = discord.Embed(
+                description=message.content,
+                color=0xadd8e6 # Light grey pastel blue
+            )
+            embed.set_author(name="Staff Response") # Anonymize the staff member
+            
+            await user.send(embed=embed)
+            await message.add_reaction("📨") # Add a mail icon to show it was sent
+        except discord.Forbidden:
+            await message.channel.send("⚠️ **Error:** I could not send a DM to this user. They may have DMs disabled.")
+        except Exception as e:
+            await message.channel.send(f"⚠️ **Error:** An unexpected error occurred: {e}")
+
+
+    # --- Settings and Management Commands ---
+    @commands.group(aliases=["mmset"]) # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def modmailset(self, ctx: commands.Context):
+        """
+        Configure the ModMail settings for this server.
+        """
+        pass
+
+    @modmailset.command(name="forum")
+    async def modmailset_forum(self, ctx: commands.Context, channel: discord.ForumChannel):
+        """Set the forum channel where ModMail tickets will be created."""
+        if not ctx.guild:
+            return
+        await self.config.guild(ctx.guild).modmail_forum.set(channel.id)
+        await ctx.send(f"The ModMail forum has been set to {channel.mention}.")
+
+    @modmailset.command(name="toggle")
+    async def modmailset_toggle(self, ctx: commands.Context):
+        """Enable or disable the ModMail system on this server."""
+        if not ctx.guild:
+            return
+        current_status = await self.config.guild(ctx.guild).enabled()
+        new_status = not current_status
+        await self.config.guild(ctx.guild).enabled.set(new_status)
+        status_text = "enabled" if new_status else "disabled"
+        await ctx.send(f"The ModMail system has been {status_text}.")
+
+    @modmailset.command(name="close")
+    async def modmailset_close(self, ctx: commands.Context, *, reason: Optional[str] = "No reason provided."):
+        """
+        Close the current ModMail thread.
+
+        You must run this command inside the thread you wish to close.
+        """
+        if not ctx.guild or not isinstance(ctx.channel, discord.Thread):
+            await ctx.send("This command can only be run inside a ModMail thread.")
+            return
+
+        active_threads = await self.config.guild(ctx.guild).active_threads()
+        thread_id_str = str(ctx.channel.id)
+        user_id = None
+        for uid, tid in active_threads.items():
+            if str(tid) == thread_id_str:
+                user_id = int(uid)
+                break
+        
+        if not user_id:
+            await ctx.send("This does not appear to be an active ModMail thread.")
+            return
+
+        # Clean up our records.
+        async with self.config.guild(ctx.guild).active_threads() as threads:
+            del threads[str(user_id)]
+
+        # Notify the user.
+        user = self.bot.get_user(user_id)
+        if user:
+            try:
+                embed = discord.Embed(
+                    title="ModMail Ticket Closed",
+                    description=f"Your ticket has been closed by staff.\n\n**Reason:** {reason}",
+                    color=0xadd8e6
+                )
+                await user.send(embed=embed)
+            except discord.Forbidden:
+                pass # Can't notify user if DMs are closed
+
+        # Archive the thread.
+        await ctx.send(f"Ticket closed by {ctx.author.mention}. Archiving thread...")
+        await ctx.channel.edit(archived=True, locked=True)
+
+# This required function allows Red to load the cog.
+async def setup(bot: Red):
+    await bot.add_cog(ModMail(bot))
+

translator/__init__.py

@@ -0,0 +1,4 @@
+from .translator import Translator
+
+async def setup(bot):
+    await bot.add_cog(Translator(bot))

translator/commands.py

@@ -0,0 +1,286 @@
+# -*- coding: utf-8 -*-
+import discord
+import json
+from typing import Optional
+from redbot.core import commands, app_commands
+from redbot.core.utils.chat_formatting import box, pagify
+
+class CommandsMixin:
+    """This class holds all the commands for the cog."""
+
+    @commands.hybrid_command(aliases=["ts"])
+    @app_commands.describe(
+        to_language="The language to translate to.",
+        text="The text to translate. For prefix commands, wrap multi-word text in quotes.",
+        from_language="[Optional] The language to translate from. Defaults to Common."
+    )
+    async def translate(self, ctx: commands.Context, to_language: str, text: str, from_language: Optional[str] = None):
+        """Translates text from one language to another."""
+        
+        from_lang_name = from_language if from_language else "common"
+        
+        from_matches = await self._find_language(from_lang_name)
+        if not from_matches:
+            return await ctx.send(f"Could not find the 'from' language: `{from_lang_name}`")
+        if len(from_matches) > 1:
+            possible = [f"`{self.all_languages[k]['name']}` (`{k}`)" for k in from_matches]
+            return await ctx.send(f"Multiple 'from' languages found for `{from_lang_name}`. Please be more specific:\n" + ", ".join(possible))
+        from_lang_key = from_matches[0]
+
+        to_matches = await self._find_language(to_language)
+        if not to_matches:
+            return await ctx.send(f"Could not find the 'to' language: `{to_language}`")
+        if len(to_matches) > 1:
+            possible = [f"`{self.all_languages[k]['name']}` (`{k}`)" for k in to_matches]
+            return await ctx.send(f"Multiple 'to' languages found for `{to_language}`. Please be more specific:\n" + ", ".join(possible))
+        to_lang_key = to_matches[0]
+        
+        from_lang_obj = self.all_languages[from_lang_key]
+        to_lang_obj = self.all_languages[to_lang_key]
+        
+        try:
+            common_text = from_lang_obj['from_func'](text)
+            translated_text = to_lang_obj['to_func'](common_text)
+        except Exception as e:
+            await ctx.send(f"An error occurred during translation: `{e}`")
+            return
+
+        webhook = None
+        if ctx.guild and ctx.guild.me.guild_permissions.manage_webhooks:
+            for wh in await ctx.channel.webhooks():
+                if wh.name == "Translator Cog Webhook":
+                    webhook = wh
+                    break
+            if webhook is None:
+                webhook = await ctx.channel.create_webhook(name="Translator Cog Webhook")
+
+        if webhook:
+            if ctx.interaction:
+                await ctx.interaction.response.defer(ephemeral=True)
+                await webhook.send(content=translated_text, username=ctx.author.display_name, avatar_url=ctx.author.display_avatar.url)
+                await ctx.interaction.followup.send("Translation sent.", ephemeral=True)
+            else:
+                if ctx.channel.permissions_for(ctx.guild.me).manage_messages:
+                    try:
+                        await ctx.message.delete()
+                    except discord.Forbidden:
+                        pass
+                await webhook.send(content=translated_text, username=ctx.author.display_name, avatar_url=ctx.author.display_avatar.url)
+        else:
+            embed = discord.Embed(title=f"Translation to {to_lang_obj['name']}", color=await ctx.embed_color())
+            embed.add_field(name="Original Text", value=box(text), inline=False)
+            embed.add_field(name="Translated Text", value=box(translated_text), inline=False)
+            await ctx.send(embed=embed)
+
+    @commands.hybrid_command()
+    async def languages(self, ctx: commands.Context):
+        """Lists all available languages."""
+        sorted_langs = sorted(self.all_languages.values(), key=lambda x: x['name'])
+        lang_list = [f"* `{lang['name']}`" for lang in sorted_langs]
+        output = "Available Languages:\n" + "\n".join(lang_list)
+        pages = [box(page) for page in pagify(output, page_length=1000)]
+        await ctx.send_interactive(pages, box_lang="md")
+    
+    @commands.group(aliases=["px"], invoke_without_command=True)
+    async def proxy(self, ctx: commands.Context):
+        """Toggles your translation proxy on or off."""
+        current_setting = await self.config.user(ctx.author).proxy_enabled()
+        new_setting = not current_setting
+        await self.config.user(ctx.author).proxy_enabled.set(new_setting)
+        status = "enabled" if new_setting else "disabled"
+        await ctx.send(f"Proxying is now `{status}`.")
+    
+    @proxy.command(name="list")
+    async def proxy_list(self, ctx: commands.Context):
+        """Shows your currently registered sonas."""
+        sonas = await self.config.user(ctx.author).sonas()
+        if not sonas:
+            return await ctx.send("You have no sonas registered.")
+
+        msg = "Your registered sonas:\n"
+        for name, data in sonas.items():
+            display_name = data.get("display_name", name)
+            lang_name = self.all_languages.get(data['language'], {}).get('name', 'Unknown Language')
+            
+            if 'claws' in data:
+                start_claw, end_claw = data['claws']
+            elif 'brackets' in data: # Fallback for old data
+                start_claw, end_claw = data['brackets']
+            else:
+                continue
+
+            claw_info = f"Starts with `{start_claw}`" if not end_claw else f"`{start_claw}` and `{end_claw}`"
+            msg += f" - **{display_name}** (Internal Name: `{name}`): Translates to `{lang_name}`. Claws: {claw_info}\n"
+        
+        for page in pagify(msg):
+            await ctx.send(page)
+
+    @proxy.command(name="add", aliases=["+"])
+    async def proxy_add(self, ctx: commands.Context, name: str, language: str, display_name: str, start_claw: str, end_claw: str = "", avatar: Optional[str] = None):
+        """Registers a new sona with a name and avatar."""
+        matches = await self._find_language(language)
+        if not matches:
+            return await ctx.send(f"Language `{language}` not found.")
+        if len(matches) > 1:
+            possible = [f"`{self.all_languages[k]['name']}` (`{k}`)" for k in matches]
+            return await ctx.send(f"Multiple languages found for `{language}`. Please be more specific:\n" + ", ".join(possible))
+        
+        lang_key = matches[0]
+        sona_key = name.lower()
+
+        avatar_url = avatar
+        if not avatar_url and ctx.message.attachments:
+            avatar_url = ctx.message.attachments[0].url
+
+        async with self.config.user(ctx.author).sonas() as sonas:
+            if sona_key in sonas:
+                return await ctx.send(f"A sona named `{name}` already exists.")
+            sonas[sona_key] = {
+                "display_name": display_name,
+                "avatar_url": avatar_url,
+                "language": lang_key, 
+                "claws": [start_claw, end_claw]
+            }
+        
+        await ctx.send(f"Sona `{name}` registered as `{display_name}` to translate to `{self.all_languages[lang_key]['name']}`.")
+
+    @proxy.command(name="remove", aliases=["-"])
+    async def proxy_remove(self, ctx: commands.Context, *, name: str):
+        """Removes a sona."""
+        sona_key = name.lower()
+        async with self.config.user(ctx.author).sonas() as sonas:
+            if sona_key not in sonas:
+                return await ctx.send(f"No sona named `{name}` found.")
+            del sonas[sona_key]
+        await ctx.send(f"Sona `{name}` has been removed.")
+
+    @proxy.group()
+    async def sona(self, ctx: commands.Context):
+        """Commands for managing a sona's appearance."""
+        pass
+    
+    @proxy.group(name="auto")
+    async def proxy_auto(self, ctx: commands.Context):
+        """Manage automatic translation in a channel."""
+        pass
+
+    @proxy_auto.command(name="set")
+    async def proxy_auto_set(self, ctx: commands.Context, sona_name: str):
+        """Sets a sona to automatically translate your messages in this channel."""
+        sona_key = sona_name.lower()
+        sonas = await self.config.user(ctx.author).sonas()
+        if sona_key not in sonas:
+            return await ctx.send(f"No sona named `{sona_name}` found. Please register it first.")
+
+        async with self.config.channel(ctx.channel).autotranslate_users() as autotranslate_users:
+            autotranslate_users[str(ctx.author.id)] = sona_key
+        
+        await ctx.send(f"Autotranslation enabled for you in this channel as **{sonas[sona_key]['display_name']}**.")
+
+    @proxy_auto.command(name="off")
+    async def proxy_auto_off(self, ctx: commands.Context):
+        """Disables autotranslation for you in this channel."""
+        async with self.config.channel(ctx.channel).autotranslate_users() as autotranslate_users:
+            if str(ctx.author.id) in autotranslate_users:
+                del autotranslate_users[str(ctx.author.id)]
+                await ctx.send("Autotranslation has been disabled for you in this channel.")
+            else:
+                await ctx.send("You do not have autotranslation enabled in this channel.")
+
+    @sona.command(name="name")
+    async def sona_name(self, ctx: commands.Context, name: str, *, display_name: str):
+        """Changes the display name of a sona."""
+        sona_key = name.lower()
+        async with self.config.user(ctx.author).sonas() as sonas:
+            if sona_key not in sonas:
+                return await ctx.send(f"No sona named `{name}` found.")
+            sonas[sona_key]["display_name"] = display_name
+        await ctx.send(f"Sona `{name}`'s display name has been changed to `{display_name}`.")
+
+    @sona.command(name="avatar")
+    async def sona_avatar(self, ctx: commands.Context, name: str, url: Optional[str] = None):
+        """Changes the avatar of a sona.
+        
+        You can either provide a direct image URL or upload an image with the command.
+        """
+        sona_key = name.lower()
+        
+        if not url and not ctx.message.attachments:
+            return await ctx.send("You must provide an image URL or upload an image.")
+
+        avatar_url = url
+        if ctx.message.attachments:
+            avatar_url = ctx.message.attachments[0].url
+
+        async with self.config.user(ctx.author).sonas() as sonas:
+            if sona_key not in sonas:
+                return await ctx.send(f"No sona named `{name}` found.")
+            sonas[sona_key]["avatar_url"] = avatar_url
+
+        await ctx.send(f"Sona `{name}`'s avatar has been updated.")
+
+
+    @commands.group(aliases=["tset"])
+    @commands.has_permissions(manage_guild=True)
+    async def translatorset(self, ctx: commands.Context):
+        """Admin commands for the Translator cog."""
+        pass
+
+    @translatorset.group(name="language", aliases=["lang"])
+    async def translatorset_language(self, ctx: commands.Context):
+        """Manage custom languages."""
+        pass
+
+    @translatorset_language.command(name="add", aliases=["+"])
+    async def translatorset_language_add(self, ctx: commands.Context, name: str, *, json_map: str):
+        """Adds a new custom language."""
+        lang_key = name.lower()
+        if lang_key in self.all_languages:
+            return await ctx.send(f"A language with the key `{lang_key}` already exists.")
+
+        try:
+            lang_map = json.loads(json_map)
+            if not isinstance(lang_map, dict):
+                raise ValueError("JSON map must be an object/dictionary.")
+        except (json.JSONDecodeError, ValueError) as e:
+            return await ctx.send(f"Invalid JSON map provided: `{e}`")
+
+        new_lang_data = {'name': name.capitalize(), 'type': 'greedy', 'map': lang_map, 'is_custom': True}
+        
+        async with self.config.languages() as languages:
+            languages[lang_key] = new_lang_data
+        
+        await self._initialize_languages()
+        await ctx.send(f"Custom language `{name}` added successfully.")
+
+    @translatorset_language.command(name="remove", aliases=["-"])
+    async def translatorset_language_remove(self, ctx: commands.Context, name: str):
+        """Removes a custom language."""
+        lang_key = name.lower()
+        current_data = await self.config.languages()
+        lang_obj = current_data.get(lang_key)
+
+        if not lang_obj or not lang_obj.get('is_custom', False):
+            return await ctx.send(f"No custom language named `{name}` found.")
+
+        async with self.config.languages() as languages:
+            if lang_key in languages:
+                del languages[lang_key]
+        
+        await self._initialize_languages()
+        await ctx.send(f"Custom language `{name}` removed.")
+
+    @translatorset_language.command(name="listcustom")
+    async def translatorset_language_listcustom(self, ctx: commands.Context):
+        """Lists all custom-added languages."""
+        custom_langs = [f"`{lang['name']}`" for lang in self.all_languages.values() if lang.get('is_custom')]
+        if not custom_langs:
+            return await ctx.send("There are no custom languages.")
+        await ctx.send("Custom Languages:\n" + ", ".join(custom_langs))
+
+    @translatorset_language.command(name="listbase")
+    async def translatorset_language_listbase(self, ctx: commands.Context):
+        """Lists all base (built-in) languages."""
+        base_langs = [f"`{lang['name']}`" for lang in self.all_languages.values() if not lang.get('is_custom')]
+        await ctx.send("Base Languages:\n" + ", ".join(base_langs))
+

translator/info.json

@@ -0,0 +1,17 @@
+{
+  "author": [
+    "unstableCogs"
+  ],
+  "install_msg": "Thank you for installing the Translator cog. Use the `/translate` command to get started.",
+  "name": "Translator",
+  "short": "Translates text into various fantasy and fun languages.",
+  "description": "A feature-rich translator cog ported from a web application. Supports numerous languages from Common to Valspiren, Sinary, and more. Includes a command to list all available languages.",
+  "tags": [
+    "translate",
+    "fun",
+    "roleplay",
+    "language"
+  ],
+  "requirements": [],
+  "end_user_data_statement": "This cog does not store any end user data."
+}

translator/languages/__init__.py

@@ -0,0 +1 @@
+

translator/languages/abyssal.py

@@ -0,0 +1,8 @@
+MAP = {'a':'azg','b':'braz','c':'kraz','d':'dorg','e':'ezg','f':'fraz','g':'gor','h':'hath','i':'ix','j':'jraz','k':'kral','l':'laz','m':'maz','n':'naz','o':'oz','p':'praz','q':'qor','r':'raz','s':'saz','t':'taz','u':'uzg','v':'vraz','w':'waz','x':'xul','y':'yaz','z':'zaz'}
+
+def get_language():
+    return {
+        'name': 'Abyssal',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/angelic.py

@@ -0,0 +1,8 @@
+MAP = {'a':'adriel','b':'baraqiel','c':'camael','d':'divinus','e':'elohim','f':'fanuel','g':'gloria','h':'hesed','i':'israfel','j':'jophiel','k':'kyrie','l':'lux','m':'michael','n':'netzach','o':'ophaniel','p':'peniel','q':'qadish','r':'raphael','s':'seraph','t':'tiferet','u':'uriel','v':'virtues','w':'wele\'el','x':'xathanael','y':'yesod','z':'zadkiel'}
+
+def get_language():
+    return {
+        'name': 'Angelic',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/aquan.py

@@ -0,0 +1,9 @@
+MAP = {'a':'aqua','b':'blub','c':'\'cress','d':'drop','e':'eelee','f':'flow','g':'glur','h':'hydro','i':'ishi','j':'\'jyr','k':'\'kyr','l':'luu','m':'\'myr','n':'\'nyr','o':'oro','p':'ploop','q':'\'qyr','r':'\'ryp','s':'sh\'l','t':'tide','u':'\'urn','v':'\'vyr','w':'wash','x':'\'xyr','y':'\'yyr','z':'\'zyr'}
+
+def get_language():
+    return {
+        'name': 'Aquan',
+        'type': 'greedy',
+        'map': MAP
+    }
+

translator/languages/aquatic.py

@@ -0,0 +1,8 @@
+MAP = {'a':'abyss','b':'brine','c':'coral','d':'depth','e':'eel','f':'fin','g':'gurgle','h':'hydro','i':'ink','j':'jelly','k':'krill','l':'lagoon','m':'murk','n':'naut','o':'ocean','p':'pearl','q':'quatic','r':'reef','s':'salt','t':'tide','u':'urchin','v':'void','w':'wave','x':'xiph','y':'yacht','z':'zone'}
+
+def get_language():
+    return {
+        'name': 'Aquatic',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/arachnid.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'arr','b':'\'brach','c':'ch\'t','d':'\'drach','e':'\'err','f':'\'fune','g':'\'goss','h':'\'harr','i':'\'itt','j':'\'jarr','k':'klik\'','l':'\'lar','m':'\'marr','n':'\'narr','o':'\'orr','p':'\'parr','q':'\'qarr','r':'\'rarr','s':'skitter\'','t':'th\'k','u':'\'urr','v':'\'varr','w':'web\'','x':'\'xarr','y':'\'yarr','z':'\'zarr'}
+
+def get_language():
+    return {
+        'name': 'Arachnid',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/avain.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'aara','b':'\'bree','c':'chir\'','d':'\'dree','e':'eek','f':'\'flutter','g':'gree\'','h':'hrooa','i':'ii\'','j':'\'jakk','k':'kree\'','l':'\'liri','m':'\'meeka','n':'\'neer','o':'\'oroo','p':'pip\'','q':'\'qree','r':'\'reea','s':'\'skraw','t':'tweet\'','u':'\'urr','v':'\'vree','w':'\'warble','x':'\'xee','y':'\'yari','z':'\'zeer'}
+
+def get_language():
+    return {
+        'name': 'Avian',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/celestial.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'ana','b':'\'bara','c':'\'cera','d':'\'dona','e':'\'elara','f':'\'fana','g':'\'gala','h':'\'hylia','i':'\'iana','j':'\'jana','k':'\'kana','l':'\'lora','m':'\'mara','n':'\'nara','o':'\'ora','p':'\'pera','q':'\'qana','r':'\'ria','s':'\'sera','t':'\'tara','u':'\'ura','v':'\'vara','w':'\'wana','x':'\'xara','y':'\'yana','z':'\'zara'}
+
+def get_language():
+    return {
+        'name': 'Celestial',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/common.py

@@ -0,0 +1,8 @@
+# This language is handled by its 'rule' type in the main cog.
+# It doesn't need a map.
+
+def get_language():
+    return {
+        'name': 'Common',
+        'type': 'rule'
+    }

translator/languages/construct.py

@@ -0,0 +1,8 @@
+MAP = {'a':'auto','b':'bolt','c':'clank','d':'diode','e':'engine','f':'forge','g':'gear','h':'hydro','i':'iron','j':'joint','k':'kinetic','l':'link','m':'motor','n':'node','o':'optic','p':'piston','q':'quantum','r':'rivet','s':'servo','t':'titan','u':'unit','v':'volt','w':'whirr','x':'xenon','y':'yoke','z':'zinc'}
+
+def get_language():
+    return {
+        'name': 'Construct',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/devilish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'ayl','b':'\'baal','c':'\'cress','d':'\'drev','e':'\'eyl','f':'\'fane','g':'\'gyl','h':'hysh\'','i':'\'iyl','j':'\'jex','k':'\'krys','l':'\'lyl','m':'\'mal','n':'\'nyl','o':'\'oyl','p':'\'prax','q':'\'qyl','r':'\'ryl','s':'\'shayd','t':'\'trys','u':'\'uyl','v':'\'vyl','w':'\'wryl','x':'\'xyl','y':'\'yyl','z':'\'zyll'}
+
+def get_language():
+    return {
+        'name': 'Devilish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/draconic.py

@@ -0,0 +1,8 @@
+MAP = {'a':'ax','b':'baxis','c':'caex','d':'drak','e':'ess','f':'faex','g':'gix','h':'heth','i':'ir','j':'jyss','k':'kex','l':'lix','m':'maex','n':'nex','o':'oth','p':'pex','q':'qexis','r':'rax','s':'syth','t':'thrax','u':'ur','v':'vyx','w':'wess','x':'xis','y':'yth','z':'zix'}
+
+def get_language():
+    return {
+        'name': 'Draconic',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/dwarvish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'az','b':'bar','c':'krag','d':'dur','e':'ek','f':'fol','g':'grum','h':'hur','i':'in','j':'jor','k':'kaz','l':'lur','m':'mor','n':'nur','o':'ok','p':'por','q':'qur','r':'ruk','s':'son','t':'thor','u':'um','v':'val','w':'wor','x':'xor','z':'zul'}
+
+def get_language():
+    return {
+        'name': 'Dwarvish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/elemental.py

@@ -0,0 +1,8 @@
+MAP = {'a':'aer','b':'breeze','c':'cinder','d':'dust','e':'ember','f':'flow','g':'gust','h':'hail','i':'ignis','j':'jet','k':'kinetic','l':'lava','m':'mist','n':'nova','o':'ozone','p':'pyre','q':'quake','r':'rain','s':'stone','t':'terra','u':'umbra','v':'vapor','w':'wave','x':'xenon','y':'yon','z':'zephyr'}
+
+def get_language():
+    return {
+        'name': 'Elemental',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/elvish.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+
+MAP = {'a':'ael','b':'\'eth','c':'cal','d':'dor','e':'elen','f':'fae','g':'\'gan','h':'h<EFBFBD>r','i':'ia','j':'yel','k':'\'ken','l':'lael','m':'mel','n':'n<EFBFBD>n','o':'oia','p':'\'pes','q':'qen','r':'rae','s':'sil','t':'t<EFBFBD>','u':'ui','v':'vae','w':'win','x':'\'xal','y':'yl','z':'z<EFBFBD>r'}
+
+def get_language():
+    return {
+        'name': 'Elvish',
+        'type': 'greedy',
+        'map': MAP
+    }
+

translator/languages/feline.py

@@ -0,0 +1,8 @@
+MAP = {'a':'meow','b':'brrt','c':'chrr','d':'drrt','e':'eek','f':'frrt','g':'grrowl','h':'hiss','i':'mii','j':'jrr','k':'krr','l':'lrr','m':'mrow','n':'nyah','o':'oww','p':'purr','q':'qrr','r':'rrr','s':'sss','t':'trill','u':'urr','v':'vrr','w':'wrr','x':'xrr','y':'yowl','z':'zzz'}
+
+def get_language():
+    return {
+        'name': 'Feline',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/fiendish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'az\'ael','b':'ba\'al','c':'cre\'z','d':'dre\'th','e':'esh\'','f':'fiir\'','g':'gre\'th','h':'ha\'el','i':'i\'z','j':'je\'th','k':'krez\'','l':'le\'th','m':'morn\'','n':'ne\'th','o':'o\'z','p':'pre\'th','q':'qe\'th','r':'re\'th','s':'se\'th','t':'te\'th','u':'u\'z','v':'ve\'th','w':'we\'th','x':'xith\'','y':'ye\'th','z':'zael\''}
+
+def get_language():
+    return {
+        'name': 'Fiendish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/gnomish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'akk','b':'bink','c':'clank','d':'dink','e':'enk','f':'fizz','g':'giz','h':'hink','i':'ink','j':'jink','k':'kink','l':'link','m':'mink','n':'nink','o':'onk','p':'sprok','q':'qink','r':'rink','s':'sprock','t':'tink','u':'unk','v':'vink','w':'whirr','x':'xink','y':'yink','z':'zink'}
+
+def get_language():
+    return {
+        'name': 'Gnomish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/goblin.py

@@ -0,0 +1,8 @@
+MAP = {'a':'az','b':'bik','c':'clik','d':'dik','e':'ek','f':'fiz','g':'gib','h':'hik','i':'ik','j':'jik','k':'krik','l':'lik','m':'mik','n':'nik','o':'ok','p':'pik','q':'qik','r':'rik','s':'snik','t':'tik','u':'uk','v':'vik','w':'wik','x':'xik','y':'yik','z':'zik'}
+
+def get_language():
+    return {
+        'name': 'Goblin',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/halftongue.py

@@ -0,0 +1,8 @@
+MAP = {'a':'apple','b':'bramble','c':'crumpet','d':'dale','e':'elderberry','f':'fiddle','g':'garden','h':'hearth','i':'iris','j':'jam','k':'kettle','l':'lazy','m':'meadow','n':'nimble','o':'oats','p':'pudding','q':'quaint','r':'river','s':'sunny','t':'tater','u':'underhill','v':'vine','w':'willow','x':'extra','y':'yarn','z':'zesty'}
+
+def get_language():
+    return {
+        'name': 'Half-Tongue',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/herbilore.py

@@ -0,0 +1,8 @@
+MAP = {'a':'aloe','b':'bark','c':'clover','d':'dand','e':'elder','f':'fern','g':'groot','h':'herb','i':'ivy','j':'juni','k':'kelp','l':'leaf','m':'moss','n':'nettle','o':'oak','p':'petal','q':'quin','r':'root','s':'sprout','t':'thyme','u':'ursi','v':'vine','w':'willow','x':'xylem','y':'yarrow','z':'zinni'}
+
+def get_language():
+    return {
+        'name': 'Herbilore',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/infernal.py

@@ -0,0 +1,8 @@
+MAP = {'a':'az\'','b':'\'baal','c':'\'krez','d':'\'drak','e':'ez\'','f':'\'fel','g':'\'gor','h':'\'hath','i':'iz\'','j':'\'jaz','k':'\'kraz','l':'\'laz','m':'\'mor','n':'\'naz','o':'oz\'','p':'\'paz','q':'\'qaz','r':'\'raz','s':'\'saz','t':'\'taz','u':'uz\'','v':'\'vaz','w':'\'waz','x':'\'xaz','y':'\'yaz','z':'\'zaz'}
+
+def get_language():
+    return {
+        'name': 'Infernal',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/kitsune.py

@@ -0,0 +1,9 @@
+MAP = {'a':'ka','b':'be','c':'chi','d':'de','e':'e','f':'fu','g':'ga','h':'hi','i':'i','j':'ji','k':'ki','l':'ru','m':'ma','n':'na','o':'o','p':'pe','q':'kyu','r':'re','s':'sa','t':'to','u':'u','v':'ve','w':'wa','x':'za','y':'ya','z':'ze'}
+
+def get_language():
+    return {
+        'name': 'Kitsune',
+        'type': 'greedy',
+        'map': MAP,
+        'separator': ''
+    }

translator/languages/leet.py

@@ -0,0 +1,9 @@
+MAP = {'a':'4','b':'8','c':'(','d':')','e':'3','f':'|=','g':'6','h':'#','i':'1','j':']','k':'|<','l':'1','m':'/\\/\\','n':'/\\/','o':'0','p':'|D','q':'(,)','r':'|2','s':'5','t':'7','u':'|_|','v':'\\/','w':'\\/\\/','x':'><','y':'`/','z':'2'}
+
+def get_language():
+    return {
+        'name': 'Leet Speak',
+        'type': 'special',
+        'map': MAP
+   
+    }

translator/languages/lizardfolk.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'ax','b':'\'bax','c':'\'caz','d':'\'daz','e':'\'ex','f':'\'fax','g':'\'gaz','h':'h\'ss','i':'\'ix','j':'\'jax','k':'sk\'ex','l':'\'lax','m':'\'max','n':'\'nax','o':'\'ox','p':'\'pax','q':'\'qax','r':'\'rax','s':'s\'lith','t':'\'char','u':'\'ux','v':'\'vax','w':'\'wax','x':'\'xax','y':'\'yax','z':'\'zax'}
+
+def get_language():
+    return {
+        'name': 'Lizardfolk',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/morsecode.py

@@ -0,0 +1,8 @@
+MAP = {'a':'.-','b':'-...','c':'-.-.','d':'-..','e':'.','f':'..-.','g':'--.','h':'....','i':'..','j':'.---','k':'-.-','l':'.-..','m':'--','n':'-.','o':'---','p':'.--.','q':'--.-','r':'.-.','s':'...','t':'-','u':'..-','v':'...-','w':'.--','x':'-..-','y':'-.--','z':'--..','1':'.----','2':'..---','3':'...--','4':'....-','5':'.....','6':'-....','7':'--...','8':'---..','9':'----.','0':'-----',' ':'/'}
+
+def get_language():
+    return {
+        'name': 'Morse Code',
+        'type': 'special',
+        'map': MAP
+    }

translator/languages/myconid.py

@@ -0,0 +1,8 @@
+MAP = {'a':'agaric','b':'bolete','c':'cap','d':'decay','e':'enoki','f':'fungi','g':'gill','h':'hyphae','i':'indigo','j':'jelly','k':'kombu','l':'lichen','m':'myco\'','n':'nidur','o':'oyster','p':'puff','q':'quorn','r':'rhizo','s':'spore\'','t':'thallus','u':'umbra','v':'velvet','w':'wart','x':'xero','y':'yeast','z':'zoospore'}
+
+def get_language():
+    return {
+        'name': 'Myconid',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/ogrish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'ug','b':'blud','c':'crag','d':'dug','e':'eeg','f':'fug','g':'gron','h':'hug','i':'ig','j':'jug','k':'krug','l':'lug','m':'mush','n':'nug','o':'og','p':'pug','q':'qug','r':'rug','s':'slog','t':'thok','u':'urk','v':'vog','w':'wug','x':'xug','y':'yug','z':'zug'}
+
+def get_language():
+    return {
+        'name': 'Ogrish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/orcish.py

@@ -0,0 +1,8 @@
+MAP = {'a':'agh','b':'bug','c':'karg','d':'dur','e':'egh','f':'fug','g':'grol','h':'hosh','i':'izg','j':'jug','k':'krunk','l':'lug','m':'mog','n':'nog','o':'ogg','p':'pug','q':'qug','r':'ruk','s':'snaga','t':'tusk','u':'uruk','v':'vug','w':'warg','x':'xug','y':'yag','z':'zug'}
+
+def get_language():
+    return {
+        'name': 'Orcish',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/piglatin.py

@@ -0,0 +1,8 @@
+# This language is handled by its 'rule' type in the main cog.
+# It doesn't need a map.
+
+def get_language():
+    return {
+        'name': 'Pig Latin',
+        'type': 'rule'
+    }

translator/languages/ratfolk.py

@@ -0,0 +1,8 @@
+MAP = {'a':'skree','b':'bite','c':'claw','d':'dark-thing','e':'eek','f':'filth','g':'gnaw','h':'hiss','i':'itch','j':'junk','k':'kill','l':'long-tail','m':'muck','n':'nest-thing','o':'rot-stink','p':'plague','q':'quick-quick','r':'rust','s':'skitter','t':'twitch','u':'under-thing','v':'vermin','w':'waste','x':'pox','y':'yes-yes','z':'zap-tail'}
+
+def get_language():
+    return {
+        'name': 'Ratfolk',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/scorpion.py

@@ -0,0 +1,8 @@
+MAP = {'a':'sk\'','b':'t\'k','c':'k\'ss','d':'d\'th','e':'e\'sk','f':'f\'t','g':'g\'th','h':'h\'k','i':'i\'s','j':'j\'t','k':'k\'t','l':'l\'k','m':'m\'k','n':'n\'t','o':'o\'s','p':'p\'k','q':'q\'t','r':'r\'k','s':'s\'k','t':'t\'s','u':'u\'s','v':'v\'t','w':'w\'k','x':'x\'s','y':'y\'k','z':'z\'t'}
+
+def get_language():
+    return {
+        'name': 'Scorpion',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/sinary.py

@@ -0,0 +1,10 @@
+MAP = {'a':'a!','b':'7b','c':'c#','d':'d4','e':'3e','f':'f^','g':'g&','h':'h8','i':'(i','j':'j0','k':'_k','l':'l2','m':'=m','n':'n+','o':'5o','p':'-p','q':'q{','r':'}r','s':'[s','t':'t]','u':'|u','v':':v','w':'"w','x':'x<','y':'>y','z':'?z'}
+
+def get_language():
+    return {
+        'name': 'Sinary',
+        'type': 'generic',
+        'map': MAP,
+        'chunk_size': 2,
+        'separator': ''
+    }

translator/languages/spiritual.py

@@ -0,0 +1,8 @@
+MAP = {'a':'\'aura','b':'\'breth','c':'\'ciel','d':'\'dion','e':'\'ethys','f':'\'fey','g':'\'glyn','h':'\'hymn','i':'\'ia','j':'\'jora','k':'\'kye','l':'\'lume','m':'\'mana','n':'\'nima','o':'\'omni','p':'\'pria','q':'\'qia','r':'\'reth','s':'\'seren','t':'\'thyme','u':'\'umbra','v':'\'vym','w':'\'wisp','x':'\'xia','y':'\'yara','z':'\'zion'}
+
+def get_language():
+    return {
+        'name': 'Spiritual',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/succubus.py

@@ -0,0 +1,8 @@
+MAP = {'a':'ah\'','b':'\'bel','c':'\'chae','d':'\'des','e':'\'esh','f':'\'fey','g':'\'gis','h':'hah\'','i':'\'ish','j':'\'jo','k':'\'ka','l':'\'lis','m':'\'mah','n':'\'nah','o':'oh\'','p':'\'pah','q':'\'qia','r':'\'rah','s':'\'sha','t':'\'thae','u':'uh\'','v':'\'vi','w':'\'wah','x':'\'xi','y':'\'yah','z':'\'zah'}
+
+def get_language():
+    return {
+        'name': 'Succubus',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/sylvan.py

@@ -0,0 +1,8 @@
+MAP = {'a':'ani','b':'bri','c':'cae','d':'dae','e':'eni','f':'fae','g':'gra','h':'hae','i':'ia','j':'jae','k':'kae','l':'lor','m':'mae','n':'nem','o':'olo','p':'pae','q':'qae','r':'rae','s':'sae','t':'tae','u':'uni','v':'vae','w':'wae','x':'xae','y':'yae','z':'zae'}
+
+def get_language():
+    return {
+        'name': 'Sylvan',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/undercommon.py

@@ -0,0 +1,8 @@
+MAP = {'a':'velk','b':'xund','c':'k\'yorl','d':'d\'ruth','e':'e\'trorn','f':'faer','g':'gol','h':'h\'chak','i':'i\'lith','j':'j\'lar','k':'k\'lar','l':'lil','m':'m\'lar','n':'nind','o':'olath','p':'p\'lar','q':'qu\'ellar','r':'ril','s':'sorn','t':'\'lar','u':'uss','v':'v\'lar','w':'wyl','x':'x\'lar','y':'y\'lar','z':'z\'ress'}
+
+def get_language():
+    return {
+        'name': 'Undercommon',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/languages/uwu.py

@@ -0,0 +1,8 @@
+# This language is handled by its 'rule' type in the main cog.
+# It doesn't need a map.
+
+def get_language():
+    return {
+        'name': 'UwU',
+        'type': 'rule'
+    }

translator/languages/valspiren.py

@@ -0,0 +1,10 @@
+MAP = {'a':'ak','b':'ba','c':'ce','d':'di','e':'ek','f':'fo','g':'gu','h':'ha','i':'ik','j':'je','k':'ki','l':'lo','m':'mu','n':'na','o':'ok','p':'pe','q':'qi','r':'ro','s':'su','t':'ta','u':'uk','v':'ve','w':'wi','x':'xo','y':'yk','z':'zu'}
+
+def get_language():
+    return {
+        'name': 'Valspiren',
+        'type': 'generic',
+        'map': MAP,
+        'chunk_size': 2,
+        'separator': ''
+    }

translator/languages/voidtouched.py

@@ -0,0 +1,8 @@
+MAP = {'a':'a\'th','b':'b\'zoth','c':'c\'thun','d':'d\'gol','e':'e\'th','f':'f\'thagn','g':'g\'noth','h':'h\'zoth','i':'i\'th','j':'j\'th','k':'k\'th','l':'l\'th','m':'m\'th','n':'n\'th','o':'o\'th','p':'p\'th','q':'qor\'','r':'r\'lyeh','s':'s\'th','t':'t\'th','u':'u\'th','v':'v\'lath','w':'w\'th','x':'x\'thul','y':'y\'th','z':'zy\'th'}
+
+def get_language():
+    return {
+        'name': 'Voidtouched',
+        'type': 'greedy',
+        'map': MAP
+    }

translator/logic.py

@@ -0,0 +1,196 @@
+# -*- coding: utf-8 -*-
+import re
+import random
+from redbot.core.utils.chat_formatting import box
+
+def reverse_map(m): return {v: k for k, v in m.items()}
+
+class TranslationLogicMixin:
+    """This class holds all the translation logic for the cog."""
+    
+    def _escape_regex(self, s):
+        return re.escape(s)
+
+    def _generic_translator(self, text, lang_map, char_separator):
+        # Regex to find custom emojis
+        emoji_regex = re.compile(r"<a?:\w+:\d+>")
+        
+        # Find all emojis and store them
+        emojis = emoji_regex.findall(text)
+        
+        # Replace emojis with a unique placeholder
+        placeholder = "||EMOJI||"
+        text_with_placeholders = emoji_regex.sub(placeholder, text)
+
+        # Translate the text with placeholders
+        word_separator = ' ' if char_separator == '' else '  '
+        words = text_with_placeholders.split(' ')
+        translated_words = []
+        emoji_counter = 0
+
+        for word in words:
+            if placeholder in word:
+                # If a word contains a placeholder, it might be part of the emoji code that got split.
+                # We simply re-insert the emoji from our list.
+                translated_words.append(emojis[emoji_counter])
+                emoji_counter += 1
+            else:
+                translated_word = char_separator.join([lang_map.get(char.lower(), char) for char in word])
+                translated_words.append(translated_word)
+        
+        return word_separator.join(translated_words)
+
+    def _generic_decoder(self, text, reverse_map, chunk_size):
+        result = ""
+        text_no_space = text.replace(' ','')
+        for i in range(0, len(text_no_space), chunk_size):
+            chunk = text_no_space[i:i+chunk_size]
+            result += reverse_map.get(chunk, '?')
+        return result
+
+    def _greedy_decoder(self, text, reverse_map):
+        syllables = sorted(reverse_map.keys(), key=len, reverse=True)
+        regex = re.compile('|'.join(map(self._escape_regex, syllables)))
+        matches = regex.findall(text.replace(' ', ''))
+        return "".join([reverse_map.get(m, '?') for m in matches])
+        
+    def _leet_decoder(self, text, reverse_map):
+        decoded_text = text
+        sorted_keys = sorted(reverse_map.keys(), key=len, reverse=True)
+        for key in sorted_keys:
+            decoded_text = decoded_text.replace(key, reverse_map[key])
+        return decoded_text
+
+    def _morse_decoder(self, text, reverse_map):
+        words = text.split('  ')
+        decoded_words = []
+        for word in words:
+            chars = word.split(' ')
+            decoded_words.append("".join([reverse_map.get(c, '?') for c in chars]))
+        return " ".join(decoded_words)
+        
+    def _pig_latin_translator(self, text):
+        vowels = "aeiou"
+        translated_words = []
+        for word in text.split(' '):
+            if not word: continue
+            match = re.match(r"^([^a-zA-Z0-9]*)(.*?)([^a-zA-Z0-9]*)$", word)
+            leading_punct, clean_word, trailing_punct = match.groups()
+            
+            if not clean_word:
+                translated_words.append(word)
+                continue
+
+            if clean_word and clean_word[0].lower() in vowels:
+                translated_word = clean_word + "way"
+            else:
+                first_vowel_index = -1
+                for i, char in enumerate(clean_word):
+                    if char.lower() in vowels:
+                        first_vowel_index = i
+                        break
+                if first_vowel_index == -1:
+                    translated_word = clean_word + "ay"
+                else:
+                    translated_word = clean_word[first_vowel_index:] + clean_word[:first_vowel_index] + "ay"
+            translated_words.append(leading_punct + translated_word + trailing_punct)
+        return " ".join(translated_words)
+
+    def _pig_latin_decoder(self, text):
+        decoded_words = []
+        for word in text.split(' '):
+            if not word: continue
+            match = re.match(r"^([^a-zA-Z0-9]*)(.*?)([^a-zA-Z0-9]*)$", word)
+            leading_punct, clean_word, trailing_punct = match.groups()
+
+            if not clean_word:
+                decoded_words.append(word)
+                continue
+            
+            original_word = ""
+            if clean_word.lower().endswith("way"):
+                original_word = clean_word[:-3]
+            elif clean_word.lower().endswith("ay"):
+                base_word = clean_word[:-2]
+                last_consonant_block_index = -1
+                for i in range(len(base_word) - 1, -1, -1):
+                    if base_word[i].lower() not in "aeiou":
+                        last_consonant_block_index = i
+                    else:
+                        break
+                if last_consonant_block_index != -1:
+                    while last_consonant_block_index > 0 and base_word[last_consonant_block_index-1].lower() not in "aeiou":
+                        last_consonant_block_index -= 1
+                    consonants = base_word[last_consonant_block_index:]
+                    stem = base_word[:last_consonant_block_index]
+                    original_word = consonants + stem
+                else:
+                    original_word = base_word
+            else:
+                original_word = clean_word
+            decoded_words.append(leading_punct + original_word + trailing_punct)
+        return " ".join(decoded_words)
+
+    def _uwu_translator(self, text):
+        text = text.lower()
+        text = text.replace('l', 'ww')
+        text = text.replace('r', 'w')
+        text = text.replace('na', 'nya').replace('ne', 'nye').replace('ni', 'nyi').replace('no', 'nyo').replace('nu', 'nyu')
+        text = text.replace('ove', 'uv')
+        words = text.split(' ')
+        uwu_words = []
+        for word in words:
+            if len(word) > 3 and random.random() < 0.3:
+                uwu_words.append(f"{word[0]}-{word}")
+            else:
+                uwu_words.append(word)
+        text = " ".join(uwu_words)
+        if random.random() < 0.5:
+            emoticons = [' uwu', ' owo', ' >w<', ' ^-^', ' ;;']
+            text += random.choice(emoticons)
+        return text
+
+    def _uwu_decoder(self, text):
+        emoticons = [' uwu', ' owo', ' >w<', ' ^-^', ' ;;']
+        for emo in emoticons:
+            if text.endswith(emo):
+                text = text[:-len(emo)]
+        text = re.sub(r'(\w)-(\w+)', r'\2', text)
+        text = text.replace('uv', 'ove')
+        text = text.replace('nyu', 'nu').replace('nyo', 'no').replace('nyi', 'ni').replace('nye', 'ne').replace('nya', 'na')
+        text = text.replace('ww', 'l')
+        text = text.replace('w', 'r')
+        return text
+
+    async def _find_language(self, query: str):
+        """Finds languages by key or name, case-insensitively."""
+        query = query.lower()
+        exact_key_match = [key for key in self.all_languages if key.lower() == query]
+        if exact_key_match:
+            return exact_key_match
+
+        exact_name_match = [key for key, lang in self.all_languages.items() if lang['name'].lower() == query]
+        if exact_name_match:
+            return exact_name_match
+
+        partial_matches = [
+            key for key, lang in self.all_languages.items() 
+            if query in key.lower() or query in lang['name'].lower()
+        ]
+        return partial_matches
+
+    async def _auto_translate_to_common(self, text: str) -> list:
+        """Helper to find all possible translations for a given text."""
+        possible_translations = []
+        for lang_key, lang_obj in self.all_languages.items():
+            if lang_key == 'common':
+                continue
+            try:
+                decoded_text = lang_obj['from_func'](text)
+                re_encoded_text = lang_obj['to_func'](decoded_text)
+                if re_encoded_text == text:
+                    possible_translations.append(f"**As {lang_obj['name']}:**\n{box(decoded_text)}")
+            except Exception:
+                continue
+        return possible_translations
+

translator/translator.py

@@ -0,0 +1,249 @@
+# -*- coding: utf-8 -*-
+import discord
+import pkgutil
+from redbot.core import commands, app_commands, Config
+from redbot.core.utils.chat_formatting import box
+from . import languages as lang_pkg
+from .views import DismissView
+from .logic import TranslationLogicMixin
+from .commands import CommandsMixin
+
+def reverse_map(m): return {v: k for k, v in m.items()}
+
+class Translator(CommandsMixin, TranslationLogicMixin, commands.Cog):
+    """A cog for translating text into various languages."""
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.config = Config.get_conf(self, identifier=8675309, force_registration=True)
+        self.config.register_global(languages={})
+        self.config.register_user(sonas={}, proxy_enabled=False)
+        self.config.register_channel(autotranslate_users={})
+        
+        self.all_languages = {}
+        self.translate_to_common_context_menu = app_commands.ContextMenu(
+            name="Translate to Common",
+            callback=self.translate_to_common_context,
+        )
+
+    async def cog_load(self):
+        """Load all languages from config and build the runtime objects."""
+        self.bot.tree.add_command(self.translate_to_common_context_menu)
+        await self._initialize_languages()
+
+    async def cog_unload(self):
+        """Remove context menu on cog unload."""
+        self.bot.tree.remove_command(self.translate_to_common_context_menu.name, type=self.translate_to_common_context_menu.type)
+
+    def _load_base_languages_from_files(self):
+        """Dynamically loads all base languages from the languages/ subfolder."""
+        base_languages_data = {}
+        for importer, modname, ispkg in pkgutil.iter_modules(lang_pkg.__path__, f"{lang_pkg.__name__}."):
+            if not ispkg:
+                try:
+                    module = __import__(modname, fromlist=["get_language"])
+                    if hasattr(module, "get_language"):
+                        lang_data = module.get_language()
+                        lang_key = modname.split('.')[-1]
+                        base_languages_data[lang_key] = lang_data
+                except Exception as e:
+                    print(f"Error loading language module {modname}: {e}")
+        return base_languages_data
+
+    def _build_runtime_languages(self, language_data):
+        """Builds the final language dict with functions from stored data."""
+        runtime_langs = {}
+        for key, data in language_data.items():
+            lang_type = data.get("type", "greedy") # Default to greedy for custom
+            
+            runtime_langs[key] = {"name": data["name"], "is_custom": data.get("is_custom", False), "type": lang_type}
+
+            if lang_type == "rule":
+                if key == "common":
+                    runtime_langs[key]['to_func'] = lambda text: text
+                    runtime_langs[key]['from_func'] = lambda text: text
+                elif key == "piglatin":
+                    runtime_langs[key]['to_func'] = self._pig_latin_translator
+                    runtime_langs[key]['from_func'] = self._pig_latin_decoder
+                elif key == "uwu":
+                    runtime_langs[key]['to_func'] = self._uwu_translator
+                    runtime_langs[key]['from_func'] = self._uwu_decoder
+            
+            elif lang_type == "generic":
+                lang_map = data.get("map", {})
+                chunk_size = data.get("chunk_size", 2)
+                char_separator = data.get("separator", "")
+                word_separator = ' ' if char_separator == '' else '  '
+                runtime_langs[key]['to_func'] = lambda text, m=lang_map, s=char_separator: self._generic_translator(text, m, s)
+                runtime_langs[key]['from_func'] = lambda text, rm=reverse_map(lang_map), cs=chunk_size, ws=word_separator: " ".join([self._generic_decoder(word, rm, cs) for word in text.split(ws)])
+
+            elif lang_type == "special":
+                 if key == "leet":
+                    lang_map = data.get("map", {})
+                    runtime_langs[key]['to_func'] = lambda text, m=lang_map: self._generic_translator(text, m, "")
+                    runtime_langs[key]['from_func'] = lambda text, rm=reverse_map(lang_map): self._leet_decoder(text, rm)
+                 elif key == "morse":
+                    lang_map = data.get("map", {})
+                    runtime_langs[key]['to_func'] = lambda text, m=lang_map: self._generic_translator(text, m, " ")
+                    runtime_langs[key]['from_func'] = lambda text, rm=reverse_map(lang_map): self._morse_decoder(text, rm)
+            
+            else: # Greedy is the default
+                lang_map = data.get("map", {})
+                char_separator = data.get("separator", " ")
+                word_separator = ' ' if char_separator == '' else '  '
+                runtime_langs[key]['to_func'] = lambda text, m=lang_map, s=char_separator: self._generic_translator(text, m, s)
+                runtime_langs[key]['from_func'] = lambda text, rm=reverse_map(lang_map), ws=word_separator: " ".join([self._greedy_decoder(word, rm) for word in text.split(ws)])
+        return runtime_langs
+
+    async def _initialize_languages(self):
+        """Merge default and custom languages from config."""
+        base_languages_data = self._load_base_languages_from_files()
+        
+        stored_languages_data = await self.config.languages()
+        if not stored_languages_data:
+            await self.config.languages.set(base_languages_data)
+            final_data = base_languages_data
+        else:
+            final_data = base_languages_data.copy()
+            for key, data in stored_languages_data.items():
+                if data.get("is_custom"):
+                    final_data[key] = data
+            await self.config.languages.set(final_data)
+
+        self.all_languages = self._build_runtime_languages(final_data)
+
+    async def translate_to_common_context(self, interaction: discord.Interaction, message: discord.Message):
+        """Translate a message to Common."""
+        await interaction.response.defer(ephemeral=True)
+        
+        possible_translations = await self._auto_translate_to_common(message.content)
+
+        if not possible_translations:
+            await interaction.followup.send("Could not find a valid translation for this message.", ephemeral=True)
+        else:
+            await interaction.followup.send("\n\n".join(possible_translations), ephemeral=True)
+
+    @commands.Cog.listener()
+    async def on_message(self, message: discord.Message):
+        if message.author.bot or not message.guild:
+            return
+        
+        prefix = (await self.bot.get_prefix(message))[0]
+        if message.content.startswith(prefix):
+            return
+
+        if message.reference and message.content.lower() == 'translate':
+            try:
+                replied_message = await message.channel.fetch_message(message.reference.message_id)
+                text_to_translate = replied_message.content
+                possible_translations = await self._auto_translate_to_common(text_to_translate)
+
+                if not possible_translations:
+                    response_msg = "Could not find a valid translation for the replied message."
+                else:
+                    response_msg = "\n\n".join(possible_translations)
+                
+                view = DismissView(author=message.author)
+                sent_message = await message.reply(
+                    response_msg,
+                    view=view,
+                    allowed_mentions=discord.AllowedMentions.none()
+                )
+                view.message = sent_message
+                
+                if message.channel.permissions_for(message.guild.me).manage_messages:
+                    await message.delete()
+                return 
+            except Exception:
+                return 
+        
+        user_settings = await self.config.user(message.author).all()
+        if not user_settings['sonas']:
+            return
+        
+        content = message.content
+        matched_sona = None
+
+        for sona_data in user_settings['sonas'].values():
+            if 'claws' in sona_data:
+                start_claw, end_claw = sona_data['claws']
+            elif 'brackets' in sona_data:
+                start_claw, end_claw = sona_data['brackets']
+            else:
+                continue
+
+            if not content.startswith(start_claw): continue
+            if end_claw and end_claw != "":
+                if not content.endswith(end_claw) or len(content) < len(start_claw) + len(end_claw):
+                    continue
+            matched_sona = sona_data
+            break
+        
+        if matched_sona:
+            if not user_settings['proxy_enabled']:
+                msg = (
+                    f"{message.author.mention}, it looks like you tried to proxy as **{matched_sona['display_name']}**, "
+                    f"but your proxy is turned off. You can re-enable it with the `{prefix}proxy` command."
+                )
+                try:
+                    view = DismissView(author=message.author)
+                    sent_message = await message.channel.send(msg, view=view, allowed_mentions=discord.AllowedMentions(users=True))
+                    view.message = sent_message
+                except discord.Forbidden:
+                    pass
+                return
+
+            if 'claws' in matched_sona:
+                start_claw, end_claw = matched_sona['claws']
+            else:
+                start_claw, end_claw = matched_sona['brackets']
+
+            text_to_translate = content[len(start_claw):-len(end_claw)] if end_claw else content[len(start_claw):]
+            lang_key = matched_sona['language']
+
+        else:
+            autotranslate_users = await self.config.channel(message.channel).autotranslate_users()
+            user_id_str = str(message.author.id)
+            if user_id_str not in autotranslate_users:
+                return
+            
+            sona_key = autotranslate_users[user_id_str]
+            sonas = user_settings.get('sonas', {})
+            if sona_key not in sonas:
+                return
+            
+            matched_sona = sonas[sona_key]
+            text_to_translate = content
+            lang_key = matched_sona['language']
+
+        to_lang_obj = self.all_languages.get(lang_key)
+        if not to_lang_obj: return
+
+        try:
+            translated_text = to_lang_obj['to_func'](text_to_translate)
+        except Exception:
+            return
+
+        webhook = None
+        if message.channel.permissions_for(message.guild.me).manage_webhooks:
+            webhooks = await message.channel.webhooks()
+            webhook = next((wh for wh in webhooks if wh.name == "Translator Cog Webhook"), None)
+            if webhook is None:
+                webhook = await message.channel.create_webhook(name="Translator Cog Webhook")
+
+        if webhook:
+            if message.channel.permissions_for(message.guild.me).manage_messages:
+                try:
+                    await message.delete()
+                except discord.Forbidden:
+                    pass
+            
+            display_name = matched_sona.get("display_name", message.author.display_name)
+            avatar_url = matched_sona.get("avatar_url") or message.author.display_avatar.url
+
+            await webhook.send(
+                content=translated_text,
+                username=display_name,
+                avatar_url=avatar_url
+            )
+

translator/views.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+import discord
+
+class DismissView(discord.ui.View):
+    def __init__(self, author: discord.Member):
+        super().__init__(timeout=1800)  # 30 minute timeout
+        self.author = author
+        self.message: discord.Message = None
+
+    async def interaction_check(self, interaction: discord.Interaction) -> bool:
+        if interaction.user.id != self.author.id:
+            await interaction.response.send_message("You are not authorized to dismiss this message.", ephemeral=True)
+            return False
+        return True
+
+    @discord.ui.button(label="Dismiss", style=discord.ButtonStyle.grey, emoji="??")
+    async def dismiss_button(self, interaction: discord.Interaction, button: discord.ui.Button):
+        await self.message.delete()
+        self.stop()
+
+    async def on_timeout(self):
+        if self.message:
+            try:
+                await self.message.delete()
+            except (discord.NotFound, discord.Forbidden):
+                pass # Message was already deleted or permissions are missing
+        self.stop()
+

welcomer/README.md

@@ -0,0 +1,82 @@
+# Welcomer Cog - ver-1.0.0
+A configurable cog to automatically welcome new users when they join your server.
+
+# Features
+- Fully Configurable: Set a custom welcome message and channel for each server.
+- Enable/Disable: Easily toggle the welcomer on or off without losing your settings.
+- Placeholder Support: Personalize your welcome message with user and server details.
+- Easy Setup: A simple command group for admins to manage all settings.
+- Permissions: All settings commands require `Manage Server` permissions to use.
+
+# Commands
+All configuration is handled through the `[p]welcomeset` command group.
+
+[p]welcomeset channel <#channel>
+Sets the channel where welcome messages will be sent.
+
+Alias: chnl
+
+Example: [p]welcomeset channel #welcome
+
+[p]welcomeset message <message>
+Sets the custom welcome message. See the "Placeholders" section below for available variables.
+
+Alias: msg
+
+Example: [p]welcomeset message Welcome {user.mention} to {server_name}! We're glad you're here.
+
+[p]welcomeset toggle
+Toggles the welcomer system on or off for the server.
+
+Aliases: on, off
+
+Example: [p]welcomeset toggle
+
+[p]welcomeset settings
+Displays the current settings for the welcomer in an embed.
+
+Aliases: show, status
+
+Example: [p]welcomeset settings
+
+[p]welcomeset test
+Sends a preview of the current welcome message to the channel where the command is run.
+
+Example: [p]welcomeset test
+
+[p]welcomeset reset
+Resets all welcomer settings for the server to their default values.
+
+Example: [p]welcomeset reset
+
+Quick Setup Guide
+Load the Cog:
+
+[p]load welcomer
+
+Set the Welcome Channel:
+
+[p]welcomeset channel #your-welcome-channel
+
+Set Your Custom Message:
+
+[p]welcomeset message Welcome, {user.mention}! Enjoy your stay in {server_name}!
+
+Enable the System:
+
+[p]welcomeset toggle
+
+The bot will now welcome new members in the channel you specified. You can use [p]welcomeset settings at any time to check your configuration.
+
+Placeholders for the Welcome Message
+You can use the following placeholders in your custom welcome message. They will be automatically replaced with the correct information when a new user joins.
+
+{user}: The user object itself.
+
+{user.mention}: Pings the new user (e.g., @UnstableKitsune).
+
+{user_name}: The new user's name (e.g., UnstableKitsune).
+
+{server_name}: The name of the server they joined.
+
+For full documentation, please visit the [repository wiki](https://git.kitsunic.org/kitsunicWorks/unstable-cogs/wiki).

welcomer/__init__.py

@@ -0,0 +1 @@
+from .welcomer import setup

welcomer/info.json

@@ -0,0 +1,14 @@
+{
+  "author": [ "unstableCogs" ],
+  "install_msg": "Thank you for installing the Welcomer cog!",
+  "name": "Welcomer",
+  "short": "A simple cog to welcome new users.",
+  "description": "Greets new members in a designated channel with a customizable message. This cog is part of the Unified Bot Suite.",
+  "tags": [
+    "welcome",
+    "utility",
+    "greeting"
+  ],
+  "requirements": [],
+  "end_user_data_statement": "This cog does not persistently store any end user data."
+}

welcomer/welcomer.py

@@ -0,0 +1,121 @@
+import discord
+from redbot.core import commands, Config
+from redbot.core.bot import Red
+from typing import Literal
+
+class Welcomer(commands.Cog):
+    """
+    A configurable cog to automatically welcome new users with multiple modes.
+    """
+
+    def __init__(self, bot: Red):
+        self.bot = bot
+        self.config = Config.get_conf(self, identifier=1234567890, force_registration=True)
+        default_guild = {
+            "welcome_channel": None,
+            "welcome_message": "Welcome to the server, {user.mention}!",
+            "enabled": False,
+            "welcome_mode": "normal"  # 'normal' or 'solstira'
+        }
+        self.config.register_guild(**default_guild)
+
+    @commands.Cog.listener()
+    async def on_member_join(self, member: discord.Member):
+        guild = member.guild
+        if not await self.config.guild(guild).enabled():
+            return
+
+        mode = await self.config.guild(guild).welcome_mode()
+        
+        if mode == "solstira":
+            # Hardcoded Solstira welcome event
+            channel_id = 1409965732669948024
+        else: # Normal mode
+            channel_id = await self.config.guild(guild).welcome_channel()
+
+        if not channel_id:
+            return
+
+        channel = guild.get_channel(channel_id)
+        if not isinstance(channel, discord.TextChannel):
+            return
+
+        if not channel.permissions_for(guild.me).send_messages:
+            return
+
+        if mode == "solstira":
+            content = (
+                f"{member.mention}\n"
+                f"- `guide` <https://discord.com/channels/1409939326382651/140993936542124073>\n"
+                f"- <a:f_purpleflower:1409967049561524859> `roles` <@&1409937150>\n"
+                f"(<https://discord.com/channels/1409939326382651/140996735493797150>)\n"
+                f"- `psa` (<https://discord.com/channels/1409939326382651/140996779492440732>)"
+            )
+            embed = discord.Embed(description="--", color=0x8b9ed7)
+            try:
+                await channel.send(content, embed=embed)
+            except discord.HTTPException:
+                pass
+        else: # Normal mode
+            message_template = await self.config.guild(guild).welcome_message()
+            formatted_message = message_template.format(
+                user=member,
+                user_mention=member.mention,
+                user_name=member.name,
+                server_name=guild.name
+            )
+            try:
+                await channel.send(formatted_message)
+            except discord.HTTPException:
+                pass
+
+    @commands.group(aliases=["wset"]) # type: ignore
+    @commands.guild_only()
+    @commands.admin_or_permissions(manage_guild=True)
+    async def welcomeset(self, ctx: commands.Context):
+        """Commands for configuring the welcome system."""
+        pass
+
+    @welcomeset.command(name="mode")
+    async def set_welcome_mode(self, ctx: commands.Context, mode: Literal["normal", "solstira"]):
+        """Set the welcome mode for this server.
+
+        Modes:
+        - `normal`: A simple, configurable welcome message.
+        - `solstira`: The special, complex welcome event.
+        """
+        if not ctx.guild:
+            return
+        await self.config.guild(ctx.guild).welcome_mode.set(mode.lower())
+        await ctx.send(f"Welcome mode has been set to **{mode.lower()}**.")
+
+    @welcomeset.command(name="channel")
+    async def set_welcome_channel(self, ctx: commands.Context, channel: discord.TextChannel):
+        """(Normal Mode) Set the channel for welcome messages."""
+        if not ctx.guild:
+            return
+        await self.config.guild(ctx.guild).welcome_channel.set(channel.id)
+        await ctx.send(f"Welcome channel set to {channel.mention}")
+
+    @welcomeset.command(name="message")
+    async def set_welcome_message(self, ctx: commands.Context, *, message: str):
+        """(Normal Mode) Set the welcome message. Use placeholders like {user.mention}."""
+        if not ctx.guild:
+            return
+        await self.config.guild(ctx.guild).welcome_message.set(message)
+        await ctx.send("Welcome message updated.")
+
+    @welcomeset.command(name="toggle")
+    async def toggle_welcome(self, ctx: commands.Context):
+        """Toggle the welcome system on or off."""
+        if not ctx.guild:
+            return
+        current_status = await self.config.guild(ctx.guild).enabled()
+        new_status = not current_status
+        await self.config.guild(ctx.guild).enabled.set(new_status)
+        status_text = "enabled" if new_status else "disabled"
+        await ctx.send(f"Welcome system has been {status_text}.")
+
+async def setup(bot: Red):
+    await bot.add_cog(Welcomer(bot))
+