Skip to content

jjbrnp/ryuk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿพ Ryuk โ€” Your Fierce Discord Moderator Bot

Hello, this is Ryuk.

Named after my resilient cat Ryuk โ€” rescued from the streets and full of strength โ€” this bot embodies that same spirit: powerful, reliable, and built to protect.

Ryuk is a Discord moderation bot written in Python, designed to bring structure, safety, and functionality to your server. Whether you're managing a small community or a bustling hub, Ryuk gives you the tools to keep things running smoothly.


โš™๏ธ Features

  • ๐Ÿ”จ Message purging with smart limits and auto-cleanup
  • ๐Ÿ›ก๏ธ Permission-based command access
  • โฑ๏ธ Timed message deletion for cleaner channels
  • ๐Ÿงฉ Modular cog-based architecture for easy expansion
  • ๐Ÿ Built with discord.py and Python 3.11+

๐Ÿš€ Getting Started

  1. Clone the repo:

    git clone https://github.com/tuusuario/ryuk-bot.git
    cd ryuk-bot
  2. Create a .env file and add your bot token:

    DISCORD_TOKEN=your_token_here
    guild_id=your_server_id (if planning to use the welcome message)
    
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run the bot:

    python main.py

Why "Ryuk"?

Because like the cat he's named after, this bot is a survivor โ€” built to handle chaos with calm, and always ready to clean up the mess.

About

Discord utility bot programmed in Python

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages