An easy-to-use extension for Discord.py and Pycord with some utility functions.
- Automatic error handling for slash commands
- Error webhook reports
- Custom logging
- Slash command translation (groups, options, choices)
- Translate messages, embeds, views, modals and more
- Help command - Automatically generate a help command for your bot
- Status changer - Change the bot's status in an interval
- Blacklist - Block users from using your bot
Python 3.9 or higher is required.
pip install ezcord
You can also install the latest version from GitHub. Note that this version may be unstable and requires git to be installed.
pip install git+https://github.com/tibue99/ezcord
If you need the latest version in your requirements.txt
file, you can add this line:
ezcord @ git+https://github.com/tibue99/ezcord
- For more examples, see the example repository or the sample code.
- Note: It's recommended to load the token from a
.env
file instead of hardcoding it. EzCord can automatically load the token if aTOKEN
variable is present in the.env
file.
import ezcord
import discord
bot = ezcord.Bot(
intents=discord.Intents.default()
)
if __name__ == "__main__":
bot.load_cogs("cogs") # Load all cogs in the "cogs" folder
bot.run("TOKEN")
import asyncio
import discord
import ezcord
class Bot(ezcord.Bot):
def __init__(self):
super().__init__(intents=discord.Intents.default())
async def setup_hook(self):
await super().setup_hook()
await self.tree.sync()
async def main():
async with Bot() as bot:
bot.add_help_command()
bot.load_cogs("cogs") # Load all cogs in the "cogs" folder
await bot.start("TOKEN")
if __name__ == "__main__":
asyncio.run(main())
You are welcome to contribute to this repository! Please refer to the full contribution guide.