mirror of
https://github.com/neoarz/Syntrel.git
synced 2025-12-25 11:40:12 +01:00
b06b0cdb66
Enhanced the server info embed with more detailed statistics and improved formatting. Updated help command to send responses in the channel when possible, with fallback to DMs if sending fails, and added error handling for users with DMs disabled. Made botinfo embed non-ephemeral and added a custom emoji to the description.
231 lines
9.1 KiB
Python
231 lines
9.1 KiB
Python
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", "melonx", "media", "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": "general",
|
|
"fun": "fun",
|
|
"idevice": "idevice",
|
|
"melonx": "melonx",
|
|
"media": "media",
|
|
"misc": "miscellaneous",
|
|
"miscellaneous": "miscellaneous",
|
|
"moderation": "moderation",
|
|
"sidestore": "sidestore",
|
|
"utils": "utilities",
|
|
"utilities": "utilities",
|
|
|
|
"sync": "owner",
|
|
"logs": "owner",
|
|
"invite": "owner",
|
|
"load": "owner",
|
|
"unload": "owner",
|
|
"reload": "owner",
|
|
"shutdown": "owner",
|
|
"say": "owner",
|
|
}
|
|
|
|
category_descriptions = {
|
|
"general": "General commands",
|
|
"fun": "Fun commands",
|
|
"moderation": "Administration commands",
|
|
"owner": "Owner commands",
|
|
"sidestore": "SideStore troubleshooting commands",
|
|
"idevice": "idevice troubleshooting commands",
|
|
"melonx": "MeloNX troubleshooting commands",
|
|
"media": "Media 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")
|
|
|
|
standalone_commands = []
|
|
botinfo_cmd = self.bot.tree.get_command("botinfo")
|
|
if botinfo_cmd:
|
|
standalone_commands.append("**/botinfo** » Get information about this bot")
|
|
|
|
if standalone_commands:
|
|
embed.add_field(
|
|
name="",
|
|
value="".join(standalone_commands) + "\n",
|
|
inline=False
|
|
)
|
|
|
|
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:
|
|
try:
|
|
await context.send(embed=embed)
|
|
except (discord.Forbidden, discord.HTTPException):
|
|
try:
|
|
await context.author.send(embed=embed)
|
|
except discord.Forbidden:
|
|
pass # User has DMs disabled
|
|
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:
|
|
try:
|
|
await context.send(embed=embed)
|
|
except (discord.Forbidden, discord.HTTPException):
|
|
try:
|
|
await context.author.send(embed=embed)
|
|
except discord.Forbidden:
|
|
pass
|
|
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:
|
|
has_prefix_subcommands = hasattr(command, 'commands') and len(getattr(command, 'commands', [])) > 0
|
|
if has_prefix_subcommands:
|
|
continue
|
|
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
|
|
has_subcommands = hasattr(app_command, 'commands') and len(getattr(app_command, 'commands', [])) > 0
|
|
|
|
if has_subcommands and category not in ["owner"]:
|
|
for subcommand in app_command.commands:
|
|
if subcommand.name in seen_names:
|
|
continue
|
|
sub_desc = subcommand.description.partition("\n")[0] if getattr(subcommand, "description", None) else "No description available"
|
|
commands_in_category.append((f"{app_command.name} {subcommand.name}", sub_desc))
|
|
seen_names.add(f"{app_command.name} {subcommand.name}")
|
|
else:
|
|
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:
|
|
try:
|
|
await context.send(embed=embed)
|
|
except (discord.Forbidden, discord.HTTPException):
|
|
try:
|
|
await context.author.send(embed=embed)
|
|
except discord.Forbidden:
|
|
pass
|
|
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:
|
|
try:
|
|
await context.send(embed=embed)
|
|
except (discord.Forbidden, discord.HTTPException):
|
|
try:
|
|
await context.author.send(embed=embed)
|
|
except discord.Forbidden:
|
|
pass
|
|
|
|
|
|
async def setup(bot) -> None:
|
|
await bot.add_cog(Help(bot))
|