-
Notifications
You must be signed in to change notification settings - Fork 27
Discord
This page lists ArchiBot features that are exclusive to Discord platform. Features that are generic and available on all platforms will not be listed here.
ArchiBot is a private Discord bot dedicated to selected online communities that we've decided to support. It's not possible to invite ArchiBot to your server through normal means and we do not intend to change it. If you're interested in utilizing ArchiBot on your server, it's offered as part of $5 tier on my GitHub and Patreon. If you're my supporter or patron, you can request ArchiBot on your Discord server by reaching me at JustArchi[at]JustArchi[dot]net.
ArchiBot makes use of the following (global) permissions. All of them are optional, although without the most basic ones like reading/writing messages, the bot will be useless on its own.
- Ban Members (
4), optional, used for automatic moderation andnukecommand. - View Audit Log (
128), optional, for moderation events. - Manage Messages (
8192,0x2000), optional, used for automatic messages publishing. - Manage Roles (
268435456), optional, used forrolecommand.
- Read Messages (
1024), optional, for listening to chat commands and automatic messages publishing. - Send Messages (
2048), optional, for answering to chat commands and automatic messages publishing. - Embed Links (
16384), optional, if you want to allow the bot to embed links (when appropriate).
If there is a channel on your server named staff or mods, then ArchiBot will automatically repost all kick, ban and unban events to that channel for informational purposes.
For full compatibility, this functionality requires "View Audit Log" (128) permission. Without such ArchiBot can't post kick events, neither provide reasons from the audit log.
If ArchiBot is granted with "Ban Members" (4) permission, then it'll use its original message-scanning system for determining unwanted messages (especially phishing links) and automatically ban members for posting such. Together with moderation events explained above, you can get notified when this happens on staff channel.
ArchiBot automatically publishes all announcements, which allows other servers to receive them immediately once they're posted. This feature works for all kind of announcements, especially those posted by webhooks.
This functionality requires "Read Messages" (1024), "Send Messages" (2048) and "Manage Messages" (8192) permission on all announcement channels where you expect ArchiBot to automatically publish all post messages.
Please be advised that the channel must be of type "announcements" to enable tracking and messages publishing. Also keep in mind that Discord has internal rate-limiting that allows no more than 10 announcements per hour for given channel, so ArchiBot might fail to publish automatically in case of excessive amount of messages.
ArchiBot considers given user as a Moderator when he has at least one assigned role with "Manage messages" (8192) permission. ArchiBot considers given user as an Administrator when he has at least one assigned role with "Administrator" (8) permission, or if he's the owner of the server.
Administrator has the Moderator permission by definition.
Those commands work exactly the same as their generic variants, except ArchiBot will take into account NSFW setting of the channel and will ignore those commands sent to channels that are not declared as such. Private chat is considered NSFW by default.
This command is used for issuing massive automatic bans for all users with names matching <pattern> substring on the server, case-insensitive. Every user having given <pattern> in the name will be the target of the command. Can be used as a tool against wave of bots following the similar name to automatically ban all of them. <pattern> can contain special characters, as well as whitespaces.
Caution should be used when issuing this command, as wrong <pattern> may cause unwanted results such as a purge of innocent users from the server.
Requires Moderator permission.
This command is used for adding/removing user that executed the command to/from <targetRole> group. Users without a Moderator permission can ask only for those roles that end with a + character, which indicates that given role is considered public. Moderators can execute this command with any role on the server. In addition to that, ArchiBot will refuse to grant user a role that includes more permissions than he currently has, unless the user executing the command is Administrator.
For convenience, + sign of public roles can be omitted when declaring <targetRole>.