You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Enso-Bot/cogs/help/help.py

322 lines
12 KiB
Python

import datetime
from discord import Embed
from discord.ext import commands, menus
from discord.ext.commands import command
from settings import enso_embedmod_colours
# Pages of the help embed
def help_menu(self, guild_icon):
# Setting up the embed for the Fun Commands
fun = Embed(title="(っ◔◡◔)っ Fun (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
fun.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
fun_fields = [
(f"**{self.ctx.prefix}comp `<person>`**",
"\nCompliment a person in the server", True),
(f"**{self.ctx.prefix}8ball `<text>`**",
"\nAsk a question and 8ball will give a custom response", True),
(f"**{self.ctx.prefix}homies `<text>`**",
"\nGenerates homies meme with given text", True),
(f"**{self.ctx.prefix}owo `<text>`**",
"\nTranslates given text to 'owo' format", True),
(f"**{self.ctx.prefix}flip**",
"\nDoes a coinflip with big pp Or smol pp", True),
(f"**{self.ctx.prefix}doggo**",
"\nLook at images of Doggos", True)]
# Setting up the embed for the Fun Commands
interactive = Embed(title="(っ◔◡◔)っ Interactive (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
interactive.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
interactive_fields = [
(f"**{self.ctx.prefix}hug `<person>`**",
"\nHug a User Within The Server", True),
(f"**{self.ctx.prefix}cuddle `<person>`**",
"\nCuddle a User Within The Server", True),
(f"**{self.ctx.prefix}pat `<person>`**",
"\nPat a User Within The Server", True),
(f"**{self.ctx.prefix}kiss `<person>`**",
"\nKiss a User Within The Server", True),
(f"**{self.ctx.prefix}lemon `<person>`**",
"\nGive lemon to a User Within The Server", True)]
# Setting up the embed for the Fun Commands
interactive_2 = Embed(title="(っ◔◡◔)っ Interactive 2 (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
interactive_2.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
interactive_fields_2 = [
(f"**{self.ctx.prefix}slap `<person>`**",
"\nSlap a User Within The Server", True),
(f"**{self.ctx.prefix}kill `<person>`**",
"\nKill a User Within The Server", True),
(f"**{self.ctx.prefix}choke `<person>`**",
"\nChoke a User Within The Server", True)]
# Setting up the embed for Relationship commands
relationship = Embed(title="(っ◔◡◔)っ Relationship (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
relationship.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
relationship_fields = [
(f"**{self.ctx.prefix}marry `<person>`**",
"\nMarry a User Within The Server", True),
(f"**{self.ctx.prefix}divorce `<person>`**",
"\nDivorce The Person You Are Married To", False),
(f"**{self.ctx.prefix}minfo `<person>`**",
"\nDisplays information about the user's current marriage" +
f"\nUsing **{self.ctx.prefix}minfo** by itself will retrieve your marriage information", True)]
# Setting up the Embed for the Enso commands
enso = Embed(title="(っ◔◡◔)っ Enso (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
enso.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
enso_fields = [
(f"**{self.ctx.prefix}enso `<person>`**",
"\nShows Specified Image of User" +
f"\n(Using **{self.ctx.prefix}enso** by itself shows random image of users in the server)",
True),
(f"**{self.ctx.prefix}enso `list`**",
"\nReturns all Users", False),
(f"**{self.ctx.prefix}rules**",
"\nFull ruleset for Enso", True),
(f"**{self.ctx.prefix}roles**",
"\nLeveling and xp system in Enso", True),
]
# Setting up the embed for the Waifu/Husbandos
waifu_and_husbando = Embed(title="(っ◔◡◔)っ Waifu/Husbando Commands (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
waifu_and_husbando.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
waifu_and_husbando_fields = [
(f"**{self.ctx.prefix}w `<waifu>`**",
"\nShows Specified Image of Waifu" +
f"\n(Using **{self.ctx.prefix}w** shows random image of Waifu)", True),
(f"**{self.ctx.prefix}h `<husbando>`**",
"\nShows Specified Image of Husbando" +
f"\n(Using **{self.ctx.prefix}h** shows random image of Husbando)", False),
(f"**{self.ctx.prefix}w `list`**",
"\nReturns all Waifus", True),
(f"**{self.ctx.prefix}h `list`**",
"\nReturns all Husbandos", True)]
# Setting up the embed for the Important Commands
important = Embed(title="(っ◔◡◔)っ Important (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
important.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
important_fields = [
(f"**{self.ctx.prefix}userinfo**",
"\nReturns information about the user", True),
(f"**{self.ctx.prefix}serverinfo**",
"\nReturns information about the server", True),
(f"**{self.ctx.prefix}prefix `<new_prefix>`**",
"\nView current prefix/Update current prefix", True),
(f"**{self.ctx.prefix}help**",
"\nSee every command in the bot", True)]
# Setting up the embed for modmail
modmail = Embed(title="(っ◔◡◔)っ ModMail (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
modmail.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
modmail_fields = [(f"**{self.ctx.prefix}mmsetup set `<channelID>`**",
"Sets up the modmail system in the guild,"
"channelID given will be the channel that the user will interact with", False),
(f"**{self.ctx.prefix}mmsetup update `<channelID>`**",
"Updates the channel that the modmail will be sent to", False),
(f"**{self.ctx.prefix}mmsetup delete modmail**",
"Existing modmail system will be deleted", False)]
# Setting up the Embed for the Miscellaneous commands
msc = Embed(title="(っ◔◡◔)っ Misc (っ◔◡◔)っ",
colour=enso_embedmod_colours,
timestamp=datetime.datetime.utcnow())
# Setting thumbnail and author
msc.set_thumbnail(url=guild_icon)
# Setting up the fields in a separate array
msc_fields = [(f"**{self.ctx.prefix}dm `<person>`**",
f"\nFor admins to DM Users" +
"\n**(Perms: Co-Owner)**", True),
(f"**{self.ctx.prefix}remindme `<time>` `<text>`**",
"\nGet Enso~Chan to remind you in DMs", True),
(f"**{self.ctx.prefix}stats**",
"\nView bot statistics (CPU/Mem Usage etc)", True),
(f"**{self.ctx.prefix}ping**", "\nReturns latency in ms", True)]
# Defining dictionary of embeds as keys, list of fields as values
help_dict = {
fun: fun_fields,
interactive: interactive_fields,
interactive_2: interactive_fields_2,
relationship: relationship_fields,
enso: enso_fields,
waifu_and_husbando: waifu_and_husbando_fields,
important: important_fields,
modmail: modmail_fields,
msc: msc_fields
}
# Iterating through the dictionary and adding fields to the embeds
for embed, field in help_dict.items():
for name, value, inline in field:
embed.add_field(name=name, value=value, inline=inline)
# Return all the embeds
return fun, interactive, interactive_2, relationship, enso, waifu_and_husbando, important, modmail, msc
def embeds(self):
# Define guild icon
guild_icon = self.ctx.guild.icon_url
# Set the different pages of the embed
page1, page2, page3, page4, page5, page6, page7, page8, page9 = help_menu(self, guild_icon)
# Store all the categories of the menu to an array called pages
pages = [page1, page2, page3,
page4, page5, page6,
page7, page8, page9]
return pages
# Set up the Cog
class HelpMenu(menus.Menu):
def __init__(self, i, bot):
super().__init__(timeout=125.0, delete_message_after=True)
self.i = i
self.bot = bot
# Message to be sent on the initial command ~help
async def send_initial_message(self, ctx, channel):
# Set the first embed to the first element in the pages[]
initial = embeds(self)[self.i]
# Send embed
return await channel.send(embed=initial)
# Reaction to allow user to go to the previous page in the embed
@menus.button('\N{LEFTWARDS BLACK ARROW}')
async def on_left_arrow(self, payload):
# Simple check to make sure that the reaction is performed by the user
def check(m):
return m.author == payload.member
# Do nothing if the check does not return true
if not check(self.ctx):
return
# Allow the page number to be decreased
else:
# Set self.i to (i - 1) remainder length of the array
self.i = (self.i - 1) % len(embeds(self))
prev_page = embeds(self)[self.i]
# Send the embed and remove the reaction of the user
await self.message.edit(embed=prev_page)
await self.message.remove_reaction("", self.ctx.author)
# Reaction to allow user to go to the next page in the embed
@menus.button('\N{BLACK RIGHTWARDS ARROW}')
async def on_right_arrow(self, payload):
# Simple check to make sure that the reaction is performed by the user
def check(m):
return m.author == payload.member
# Do nothing if the check does not return true
if not check(self.ctx):
return
# Allow the page number to be increased
else:
# Set self.i to (i + 1) remainder length of the array
self.i = (self.i + 1) % len(embeds(self))
next_page = embeds(self)[self.i]
# Send the embed and remove the reaction of the user
await self.message.edit(embed=next_page)
await self.message.remove_reaction("", self.ctx.author)
@menus.button('\N{BLACK SQUARE FOR STOP}\ufe0f')
async def on_stop(self, payload):
# Simple check to make sure that the reaction is performed by the user
def check(m):
return m.author == payload.member
# Do nothing if the check does not return true
if not check(self.ctx):
return
# Allow the embed to be deleted
else:
# Delete the embed and stop the function from running
await self.message.delete()
self.stop()
# Set up the cog
class CustomHelp(commands.Cog):
def __init__(self, bot):
self.bot = bot
self.bot.remove_command("help")
@command(name="help", aliases=["Help"])
async def help(self, ctx):
"""Returns a menu for help commands controlled by reactions"""
# Local Variable i to allow the index of the pages[] to be modified
i = 0
# Send the menu to the display
menu = HelpMenu(i, self)
await menu.start(ctx)
def setup(bot):
bot.add_cog(CustomHelp(bot))