https://github.com/jesewe/discord-bot
The all-in-one bot for moderation, fun, and utility in your Discord server.
https://github.com/jesewe/discord-bot
bot discord discord-bot discord-js js
Last synced: 3 months ago
JSON representation
The all-in-one bot for moderation, fun, and utility in your Discord server.
- Host: GitHub
- URL: https://github.com/jesewe/discord-bot
- Owner: Jesewe
- License: mit
- Created: 2024-10-11T14:29:24.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-24T04:10:31.000Z (4 months ago)
- Last Synced: 2025-04-12T05:53:51.755Z (3 months ago)
- Topics: bot, discord, discord-bot, discord-js, js
- Language: JavaScript
- Homepage: https://github.com/Jesewe/discord-bot
- Size: 657 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🤖 Ultimate Discord Bot 🤖
The all-in-one bot for moderation, fun, and utility in your Discord server.
Features •
Installation •
Dependencies •
Logging
---
## Overview
**Ultimate Discord Bot** is a powerful and flexible bot built using the [Discord.js](https://discord.js.org/) library. It's designed to enhance your Discord server with a wide range of features—from server moderation tools to fun and engaging commands for your community. The bot integrates external APIs for jokes, historical events, trivia, weather, and more, making it a versatile tool for any server.
## Features
### General Commands
- **`roll [min-max]`**: Roll a random number within a given range (default: 1-100).
- **`joke`**: Fetch a random joke from an external API.
- **`who [name]`**: Generate a random adjective for the given name.
- **`prediction`**: Get a random prediction about your future.
- **`8ball`**: Ask a yes/no question and get an answer.
- **`ping`**: Check the bot's response time.
- **`words [text]`**: Count the number of words in the provided text.
- **`customembed Title; Description; [optional hex color]`**: Create a custom embed message.
### Moderation Commands
- **`kick [@user]`**: Kick a user from the server.
- **`ban [@user]`**: Ban a user from the server.
- **`mute [@user]`**: Mute a user in voice channels.
- **`unmute [@user]`**: Unmute a user in voice channels.
### Server Information Commands
- **`userinfo [@user]`**: Get details about a user (username, tag, ID, etc.).
- **`serverinfo`**: Display server information (name, member count, etc.).
- **`random_player`**: Select a random member from the server.
- **`botinfo`**: List all bots currently in the server.
### Fun & Miscellaneous Commands
- **`uptime`**: See how long the bot has been running.
- **`today`**: Discover a historical event that occurred on today's date.
- **`fact`**: Get a random fun fact from an external API.
- **`ascii [text]`**: Convert text into ASCII art.
- **`fortune`**: Receive a fortune prediction for your day.
- **`quote`**: Get an inspirational quote from ZenQuotes.
- **`timer [seconds]`**: Set a timer that notifies you when time is up.
- **`crypto [coin]`**: Check the current USD price of a cryptocurrency (default: bitcoin).
- **`avatar [@user]`**: Display the avatar of a mentioned user or your own.
- **`cat`**: Get a random cat image.
- **`dog`**: Get a random dog image.
- **`meme`**: Fetch a random meme.
- **`weather [location]`**: Get current weather information for a specified location.
- **`trivia`**: Receive a random trivia question with multiple choice options.
- **`reminder [seconds] [message]`**: Set a personal reminder; you'll receive a DM after the specified time.
### Auto Moderation
In addition to the above commands, **Ultimate Discord Bot** includes an **Auto Moderation** feature that runs in the background. This feature automatically monitors all incoming messages for banned words. The list of banned words is loaded from the bot's configuration file (`config.json`) under the `"autoModeration"` section. When a message contains one of these words, the bot will delete the message and notify the user.
For example, your `config.json` might include:
```json
{
"token": "YOUR_BOT_TOKEN",
"prefix": "!",
"logging": {
"enabled": true,
"logFilePath": "./bot.log"
},
"commands": {
"enableClearCommand": true,
"enableJokeCommand": true
},
"autoModeration": {
"bannedWords": ["badword1", "badword2", "nastyword"]
}
}
```
## Prerequisites
Before running the bot, ensure you have the following:
- A [Discord developer account](https://discord.com/developers/applications) and a bot token.
- Node.js (v16.6.0 or higher) installed on your machine.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/Jesewe/discord-bot.git
```
2. Navigate to the project directory:
```bash
cd discord-bot
```
3. Install the required dependencies:
```bash
npm install
```
4. Create a `config.json` file in the project root and add your bot token, prefix, and other configuration as shown above.
5. Start the bot:
```bash
node bot.js
```
## Dependencies
- [Discord.js](https://discord.js.org/): A JavaScript library to interact with the Discord API.
- [Axios](https://axios-http.com/): A promise-based HTTP client for making API calls.
- [Figlet](https://www.npmjs.com/package/figlet): Used to generate ASCII art from text.
## Logging
The bot logs each command execution along with timestamps for easy monitoring. By default, logs are written to both the console and an optional log file if logging is enabled in the `config.json`.
Example log format:
```
[MM/DD/YYYY, HH:MM:SS AM/PM] Command executed: !roll
```
To enable file logging, configure the `logFilePath` in `config.json`:
```json
{
"logging": {
"enabled": true,
"logFilePath": "./bot.log"
}
}
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.