onesoft-sudo/sudobot

A Discord Bot for moderation purposes.

A free and open source Discord bot for moderation purposes. Click here to see the screenshots.

❗ Need Contributors

This project needs more contributors. Please look at the Todos to see what you can do to help us. Of course you can add new features and/or fix/improve something that isn't listed in the todos! We'll be really thankful if you contribute.

If you like the bot, then please make sure to star this repository! And also if possible, you could help us by donating. As an open source project development team, we don't earn anything after all these hard work. Even a small donation of $1 can help us a lot.

Features

• Strong auto moderation system with tools like anti-spam and anti-raid (Click here to see the full list)
• Useful moderation tools and utilities
• Secure
• Fun commands
• Active development & support

Getting started

You can request an invitation for SudoBot here, it's completely free, and you can ask us for help anytime. Alternatively, you can create your own Discord API application and then host SudoBot.

Setup for Custom Hosting

Please look at this page of the documentation.

Source Code & Downloads

You can browse the source code at the GitHub repository or Subversion repository. You can also download release tarballs at OSN's download server:

• HTTP: https://downloads.onesoftnet.eu.org
• FTP: ftp://ftp.onesoftnet.eu.org with anonymous read access.

Contributors [A-Z]

Thanks to all the active and indirect contributors!

• Ar Rakin (Maintainer)
• dicoderin
• GuynnR
• Hana (A Discord User)
• Kars
• killerclaws12
• MonzterDev
• ninsaccplayzyt
• Ryanmello07 (Contributed by giving away a hosting server and doing a lot of other things to help us)

Mailing Lists

If you prefer communicating over emails or mailing lists, you can send your message at [email protected], which is a mailing list specifically for discussions, bug reports and questions about SudoBot. For more information about this mailing list, check out the list info page. Mail archives for this mailing list can be found here.

License

SudoBot is licensed under the GNU Affero General Public License v3.0. You can find the full license text in the LICENSE file distributed in this repository.

Exceptions

• The emojis are licensed under the Creative Commons Attribution 4.0 International License.
• The SudoBot Logo is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
• The documentation website of SudoBot is dual-licensed under the GNU Affero General Public License v3.0 and the GNU Free Documentation License v1.3.
  Read the README.md file in the docs directory for more information.
• BlazeBuild, the build tool that SudoBot uses, is licensed under the GNU General Public License v3.0.

Support

• Email: [email protected]
• Mailing List: [email protected]
• Website: https://www.sudobot.online
• Discord Servers: OneSoftNet Server

Extra

• Download Emojis: https://www.onesoftnet.eu.org/downloads/sudo/emojis/
  Note that not all emojis are present there. You'll find the missing one's at emoji.gg.
• Dashboard: https://github.com/onesoft-sudo/sudobot-dashboard
  The dashboard of SudoBot. Note that the dashboard is not complete yet.
• Old site: https://sudobot-dashboard-6c7506h5v-osn.vercel.app/

Copyright © 2022-2024 OSN and all the contributors of SudoBot.

sudobot's Issues

Add a message reporting system

Add a message reporting system, which will get triggered if a user reacts with a specific emoji or uses a context menu command.

Mass ping filter not working

Mass ping filter not working due to wrong condition checking.

Make the moderation command permission error more detailed

Make the moderation command permission error messages more user friendly.

Example:

If a user tries to ban another user having higher roles that the first user, then it should abort the operation and show an error message.

Add pagination to rolelist command

Exclude spam filter channels from repeated text filter

Exclude spam filter channels from repeated text filter using the same config.

Auto mute on rejoin

Auto mute on rejoin if previously muted.

Create an `eval` command

Create an eval command with owner only permissions so that raw code can be executed from discord.

Improve guild wide channel locking system

Improve channel locking system and the database interaction strategies.

Make the features more customizable

• Make spam filter actions customizable
• Make message filter actions customizable
• Make blocked word/token/regex filter actions customizable
• Make anti raid actions customizable

Create a common class/function that handles the moderation embeds

Create a common class/function that handles the embeds sent fron the moderation commands. If creating a class, it should inherit the MessageEmbed base class from discord.js.

Add permission based command protection

Check if user has required perms before running a command, alongside checking the mod role.

Make some roles un-bannable/un-kickable/un-clearable

Create a blacklisted word filter

Create a blacklisted word filter with regex support.

Integrate with PM2

Use the PM2 process manager in the project.

Add husky to the project

Add husky to improve the development flow.

Add a rickroll command

Add a command to send a random rickroll gif.

Cannot fetch users mentioned in commands

Cannot fetch users mentioned in commands having a nickname set. This can be fixed by adding a check for ! character inside the mention string, because mentions of users having a nickname will have ! after <@.

Update Help Command

The help command data is outdated. New command options and structures should be added.

Add the support of locking channels in case of serious spam

Add the support of locking channels in case of serious spam/raid is detected.

Add an embed builder command

• Add an embed builder command
• Add a command that produces an internal data string for representing an embed or embeds
• Add support of embeds inside snippets

timeProcess function not returning years

Allow the welcoming system to add custom message

Allow the welcoming system to add custom messages under the random one, or only the custom message.

Add a PFP search command

Add a PFP search command which will simply generate a google image search URL to the PFP

Implement commands for bulk permission overrides with channels

Add installation instruction

Add installation instructions and guidelines for getting started, inside README.md file.

Invite URL Filter

Create an invite URL filter with channel excluding support.

Add queue list command

Add queue list command to list all currently queued commands

Log uncaught errors via webhooks

Log uncaught errors via webhooks, in a channel on the home discord server.

Upgrade strategy of loading services

Upgrade strategy of loading services into the client class.
Static => Dynamic

No response when warning a user

No response when warning a user if they have DMs disabled.
Same applies to mute/unmute, send, or bean.

Add feature list command

Add a command that contains all the features and their brief. Also, make the help command more user friendly.

Add antijoin systems

Add configurable antijoin system.

Save the given status using /setstatus command

Save the given status into a DB or JSON file using /setstatus command, so that the in the next restart it will be re-loaded.

Add a plant/flower command

Add a plant/flower command to fetch plant/flower photos.

Add user lookup command

Add user lookup command, which will find an user by ID.

Clear command not working

Using the legacy clear command with only user isn't working always.

Add support of built in messages

Add support of built in static command messages. These should be updatable.

Add token filter

Add token filter support, which will filter out any message containing the triggers.

Add a rickroll filter

Add a message filter for disallowing rickroll URLs.

Add welcome messages support

Add welcome messages support. Also they must be configurable or randomizable.

Add muterole create command

Add a command to create a mute role.

Add `clearTimeout()` function

Create mod history automatically

Create mod history automatically even the user uses a different utility for banning/kicking rather than sudobot, using event listeners.

Add the support of muting/warning/kicking after certain spam violations

Now the bot should mute/kick/warn the user after a certain spam violation.

Fix the emoji command

Improve the profile command

• Order the roles
• Show user badges
• Show user status properly

Improve `-clear` command

Add command for removing a scheduled/expired message

Change codebase for discord.js v14 upgrade

Needs a refactor of the whole project.

Add commands for configuration management

Add commands for configuration management, without dashboard.