dbot

dbot is a multi-purpose Discord bot built using Python. It includes commands for fun, music playback, user info, and moderation. Designed for ease of use, all commands are prefixed with a dot (.) and require lowercase input.

Goal

This project was created to explore Discord bot development using the discord.py framework, while integrating modules like DiscordUtils for advanced features like pagination and invite tracking.

Features

Fun Commands

• .afk — Set AFK status
• .catto — Sends a random cat image
• .doggo — Sends a random dog image
• .quote — Sends a random quote
• .rafk — Remove AFK status
• .randrange — Returns a random number from a given range
• .short — Returns a shortened URL
• .type — Repeats a sentence N times (e.g., .type 5 Hello.)

All commands must be executed in lowercase.

Music Commands

• .pl — Plays a song (URL or search term)
• .paw — Pauses the current song
• .res — Resumes the paused song
• .np — Displays the currently playing track
• .lp — Toggles looping
• .q — Displays the song queue
• .rm — Removes a specific track from the queue
• .skip — Skips the current song
• .sp — Stops playback and clears the queue
• .vl — Adjusts volume
• .dc — Disconnects from voice channel

All commands must be executed in lowercase.

Info Commands

• .av — Shows the avatar of a user
• .srvinfo — Displays server info
• .usrinfo — Displays user info
• .rl — Lists server roles

All commands must be executed in lowercase.

Moderation Commands

• .kick — Kicks a user
• .ban — Bans a user
• .clear [n] — Deletes the last n messages (default: 5)
• .mute — Mutes a user (requires mute role to exist)
• .unmute — Unmutes a user
• .w — Warns a user
• .ar — Assigns a role to a user (e.g., .ar test @User)
• .rr — Removes a role from a user

All commands must be executed in lowercase.

Libraries Used

• discord.py — Core Discord API wrapper
• DiscordUtils — Invite tracking and embed pagination
• os — For dynamic cog loading

Setup and Installation

1. Ensure Python 3.8+ is installed

2. Install dependencies:

   pip install discord.py DiscordUtils

3. Add your bot token in dbot.py:

   botto.run("your_token_here")

4. Run the bot:

   python dbot.py