{"id":22307260,"url":"https://github.com/jesewe/discord-bot","last_synced_at":"2025-04-12T05:54:01.608Z","repository":{"id":266123525,"uuid":"871232849","full_name":"Jesewe/discord-bot","owner":"Jesewe","description":"The all-in-one bot for moderation, fun, and utility in your Discord server.","archived":false,"fork":false,"pushed_at":"2025-03-24T04:10:31.000Z","size":673,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T05:53:51.755Z","etag":null,"topics":["bot","discord","discord-bot","discord-js","js"],"latest_commit_sha":null,"homepage":"https://github.com/Jesewe/discord-bot","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jesewe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-11T14:29:24.000Z","updated_at":"2025-03-24T04:10:27.000Z","dependencies_parsed_at":"2025-03-03T09:23:00.884Z","dependency_job_id":"d2c85240-7966-49fe-8b33-cc46bf3104d5","html_url":"https://github.com/Jesewe/discord-bot","commit_stats":null,"previous_names":["jesewe/discord-bot"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fdiscord-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fdiscord-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fdiscord-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jesewe%2Fdiscord-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jesewe","download_url":"https://codeload.github.com/Jesewe/discord-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248525156,"owners_count":21118616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","discord","discord-bot","discord-js","js"],"created_at":"2024-12-03T20:09:16.042Z","updated_at":"2025-04-12T05:54:01.576Z","avatar_url":"https://github.com/Jesewe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n   \u003cimg src=\"src/img/icon.png\" alt=\"Discord Bot\" width=\"200\" height=\"200\"\u003e\r\n   \u003ch1\u003e🤖 Ultimate Discord Bot 🤖\u003c/h1\u003e\r\n   \u003cp\u003eThe all-in-one bot for moderation, fun, and utility in your Discord server.\u003c/p\u003e\r\n   \u003ca href=\"#features\"\u003e\u003cstrong\u003eFeatures\u003c/strong\u003e\u003c/a\u003e •\r\n   \u003ca href=\"#installation\"\u003e\u003cstrong\u003eInstallation\u003c/strong\u003e\u003c/a\u003e •\r\n   \u003ca href=\"#dependencies\"\u003e\u003cstrong\u003eDependencies\u003c/strong\u003e\u003c/a\u003e •\r\n   \u003ca href=\"#logging\"\u003e\u003cstrong\u003eLogging\u003c/strong\u003e\u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n## Overview\r\n\r\n**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.\r\n\r\n## Features\r\n\r\n### General Commands\r\n\r\n- **`roll [min-max]`**: Roll a random number within a given range (default: 1-100).\r\n- **`joke`**: Fetch a random joke from an external API.\r\n- **`who [name]`**: Generate a random adjective for the given name.\r\n- **`prediction`**: Get a random prediction about your future.\r\n- **`8ball`**: Ask a yes/no question and get an answer.\r\n- **`ping`**: Check the bot's response time.\r\n- **`words [text]`**: Count the number of words in the provided text.\r\n- **`customembed Title; Description; [optional hex color]`**: Create a custom embed message.\r\n\r\n### Moderation Commands\r\n\r\n- **`kick [@user]`**: Kick a user from the server.\r\n- **`ban [@user]`**: Ban a user from the server.\r\n- **`mute [@user]`**: Mute a user in voice channels.\r\n- **`unmute [@user]`**: Unmute a user in voice channels.\r\n\r\n### Server Information Commands\r\n\r\n- **`userinfo [@user]`**: Get details about a user (username, tag, ID, etc.).\r\n- **`serverinfo`**: Display server information (name, member count, etc.).\r\n- **`random_player`**: Select a random member from the server.\r\n- **`botinfo`**: List all bots currently in the server.\r\n\r\n### Fun \u0026 Miscellaneous Commands\r\n\r\n- **`uptime`**: See how long the bot has been running.\r\n- **`today`**: Discover a historical event that occurred on today's date.\r\n- **`fact`**: Get a random fun fact from an external API.\r\n- **`ascii [text]`**: Convert text into ASCII art.\r\n- **`fortune`**: Receive a fortune prediction for your day.\r\n- **`quote`**: Get an inspirational quote from ZenQuotes.\r\n- **`timer [seconds]`**: Set a timer that notifies you when time is up.\r\n- **`crypto [coin]`**: Check the current USD price of a cryptocurrency (default: bitcoin).\r\n- **`avatar [@user]`**: Display the avatar of a mentioned user or your own.\r\n- **`cat`**: Get a random cat image.\r\n- **`dog`**: Get a random dog image.\r\n- **`meme`**: Fetch a random meme.\r\n- **`weather [location]`**: Get current weather information for a specified location.\r\n- **`trivia`**: Receive a random trivia question with multiple choice options.\r\n- **`reminder [seconds] [message]`**: Set a personal reminder; you'll receive a DM after the specified time.\r\n\r\n### Auto Moderation\r\n\r\nIn 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.\r\n\r\nFor example, your `config.json` might include:\r\n\r\n```json\r\n{\r\n  \"token\": \"YOUR_BOT_TOKEN\",\r\n  \"prefix\": \"!\",\r\n  \"logging\": {\r\n    \"enabled\": true,\r\n    \"logFilePath\": \"./bot.log\"\r\n  },\r\n  \"commands\": {\r\n    \"enableClearCommand\": true,\r\n    \"enableJokeCommand\": true\r\n  },\r\n  \"autoModeration\": {\r\n    \"bannedWords\": [\"badword1\", \"badword2\", \"nastyword\"]\r\n  }\r\n}\r\n```\r\n\r\n## Prerequisites\r\n\r\nBefore running the bot, ensure you have the following:\r\n\r\n- A [Discord developer account](https://discord.com/developers/applications) and a bot token.\r\n- Node.js (v16.6.0 or higher) installed on your machine.\r\n\r\n## Installation\r\n\r\n1. Clone the repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/Jesewe/discord-bot.git\r\n   ```\r\n\r\n2. Navigate to the project directory:\r\n\r\n   ```bash\r\n   cd discord-bot\r\n   ```\r\n\r\n3. Install the required dependencies:\r\n\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n4. Create a `config.json` file in the project root and add your bot token, prefix, and other configuration as shown above.\r\n\r\n5. Start the bot:\r\n\r\n   ```bash\r\n   node bot.js\r\n   ```\r\n\r\n## Dependencies\r\n\r\n- [Discord.js](https://discord.js.org/): A JavaScript library to interact with the Discord API.\r\n- [Axios](https://axios-http.com/): A promise-based HTTP client for making API calls.\r\n- [Figlet](https://www.npmjs.com/package/figlet): Used to generate ASCII art from text.\r\n\r\n## Logging\r\n\r\nThe 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`.\r\n\r\nExample log format:\r\n\r\n```\r\n[MM/DD/YYYY, HH:MM:SS AM/PM] Command executed: !roll\r\n```\r\n\r\nTo enable file logging, configure the `logFilePath` in `config.json`:\r\n\r\n```json\r\n{\r\n  \"logging\": {\r\n    \"enabled\": true,\r\n    \"logFilePath\": \"./bot.log\"\r\n  }\r\n}\r\n```\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesewe%2Fdiscord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjesewe%2Fdiscord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesewe%2Fdiscord-bot/lists"}