import discord from discord import app_commands from discord.ext import commands from discord.ext.commands import Context class Help(commands.Cog, name="help"): def __init__(self, bot) -> None: self.bot = bot async def category_autocomplete( self, interaction: discord.Interaction, current: str, ) -> list[app_commands.Choice[str]]: categories = ["general", "fun", "moderation", "owner", "sidestore", "idevice", "miscellaneous", "utilities"] suggestions = [] for category in categories: if current.lower() in category.lower(): suggestions.append( app_commands.Choice( name=f"{category.capitalize()} Commands", value=category ) ) return suggestions[:25] @commands.hybrid_command( name="help", description="List all commands the bot has loaded." ) @app_commands.allowed_contexts(guilds=True, dms=True, private_channels=True) @app_commands.allowed_installs(guilds=True, users=True) @app_commands.describe(category="Choose a specific category to view its commands") @app_commands.autocomplete(category=category_autocomplete) async def help(self, context: Context, category: str = None) -> None: category_mapping = { # General Commands "help": "general", "botinfo": "general", "serverinfo": "general", "ping": "general", "feedback": "general", "uptime": "general", # "context_menus": "general", # Fun Commands "randomfact": "fun", "coinflip": "fun", "rps": "fun", "8ball": "fun", "minesweeper": "fun", # Moderation Commands "kick": "moderation", "ban": "moderation", "nick": "moderation", "purge": "moderation", "hackban": "moderation", "warnings": "moderation", "archive": "moderation", # SideStore Commands "sidestore": "sidestore", "refresh": "sidestore", "code": "sidestore", "crash": "sidestore", "pairing": "sidestore", "server": "sidestore", "half": "sidestore", "sparse": "sidestore", "afc": "sidestore", "udid": "sidestore", # idevice Commands "idevice": "idevice", "noapps": "idevice", "errorcodes": "idevice", "developermode": "idevice", "mountddi": "idevice", # Owner Commands "sync": "owner", "cog_management": "owner", "shutdown": "owner", "say": "owner", "invite": "owner", "logs": "owner", # Utilities Commands "translate": "utilities", # Miscellaneous Commands "keanu": "miscellaneous", "labubu": "miscellaneous", "piracy": "miscellaneous", "tryitandsee": "miscellaneous", "rr": "miscellaneous", } category_descriptions = { "general": "General commands", "fun": "Fun commands", "moderation": "Administration commands", "owner": "Owner commands", "sidestore": "SideStore troubleshooting commands", "idevice": "idevice troubleshooting commands", "utilities": "Utility commands", "miscellaneous": "Miscellaneous commands" } if category is None: embed = discord.Embed( title="Help", color=0x7289DA ) embed.set_author(name="Help", icon_url="https://yes.nighty.works/raw/T9mnBO.png") available_categories = set() for cog_name in self.bot.cogs: mapped_category = category_mapping.get(cog_name.lower()) if mapped_category: available_categories.add(mapped_category) category_list = [] for cat in sorted(available_categories): description = category_descriptions.get(cat, f"{cat.capitalize()} commands") category_list.append(f"**/help {cat}** » {description}") if category_list: embed.add_field( name="", value="\n".join(category_list), inline=False ) if context.interaction: await context.interaction.response.send_message(embed=embed, ephemeral=True) else: await context.author.send(embed=embed) return category = category.lower() if category not in category_descriptions: embed = discord.Embed( title="Error", description=f"Category '{category}' not found. Use `/help` to see available categories.", color=0x7289DA ) if context.interaction: await context.interaction.response.send_message(embed=embed, ephemeral=True) else: await context.author.send(embed=embed) return commands_in_category = [] seen_names = set() for cog_name in self.bot.cogs: if category_mapping.get(cog_name.lower()) == category: cog = self.bot.get_cog(cog_name) if cog: commands_list = cog.get_commands() for command in commands_list: name = command.name if name in seen_names: continue description = command.description.partition("\n")[0] if command.description else "No description available" commands_in_category.append((name, description)) seen_names.add(name) for app_command in self.bot.tree.get_commands(): bound_cog = getattr(app_command, "binding", None) if bound_cog is None: continue bound_cog_name = getattr(bound_cog, "qualified_name", "").lower() if category_mapping.get(bound_cog_name) != category: continue if app_command.name in seen_names: continue description = app_command.description.partition("\n")[0] if getattr(app_command, "description", None) else "No description available" commands_in_category.append((app_command.name, description)) seen_names.add(app_command.name) if not commands_in_category: embed = discord.Embed( title="Error", description=f"No commands found in category '{category}'.", color=0x7289DA ) if context.interaction: await context.interaction.response.send_message(embed=embed, ephemeral=True) else: await context.author.send(embed=embed) return embed = discord.Embed( title=f"/help » {category.lower()}", color=0x7289DA ) embed.set_author(name="Help", icon_url="https://yes.nighty.works/raw/T9mnBO.png") data = [] for command_name, description in sorted(commands_in_category): data.append(f"**/{command_name}** » {description}") help_text = "\n".join(data) embed.add_field( name="", value=help_text, inline=False ) if context.interaction: await context.interaction.response.send_message(embed=embed, ephemeral=True) else: await context.author.send(embed=embed) async def setup(bot) -> None: await bot.add_cog(Help(bot))