Bot Commands List

GroundDug only gives the GD_ADMINISTRATOR permission to the Administrators. Check the permissions commands for how to add permissions to another user.

Miscellaneous commands

Command

Usage and notes

GD permission required

botinfo

Returns information about the bot, including guilds, users and shard latency information.

None

help [module]

Provides a list of commands and their usage.

[module] - Which module results are provided back in a list

None

invite

Receive a private message with a link to invite GroundDug.

None

userinfo [user]

Obtain information about a user, such as the server join date, account age and server roles.

[user] - The user to lookup. If none is provided, message author will be used.

user must be discord.Pingable or discord.id

None

badges [user]

Returns the badges given by the bot to a user, signifying the trust level the user has in relation to the bot.

[user] - The user to obtain badges for. If none is provided, badges for author will be returned.

user must be discord.Pingable or discord.id

None

GD Permissions

Permission

Permission meaning

MANAGE_MESSAGES

Allows users to manage guild messages, mainly deleting them

MUTE_MEMBERS

Allows users to mute and gag members, stopping them from talking in voice and text channels,

KICK_MEMBERS

Allows users to kick other users from the guild, removing the user but allowing them to come back.

BAN_MEMBERS

Allows users to ban other users from the guild, removing the user from the guild and not allowing them to come back.

WARN_MEMBERS

Allows users to warn and forgive members for their wrongdoings.

BYPASS_AUTOMOD

Allows users to be ignored by the automod and violate the automod rules. This should only be given to trusted users.

ADMINISTRATOR

Has all GD permissions along with being able to give permissions to other users and logging commands.

Administrator commands

Command

Usage and notes

GD permission required

setprefix <prefix>

Set a custom prefix for your guild locally. The bot default is g!.

<prefix> - The new prefix the bot will respond to

administrator

raid <state>

Enables or disables raid mode.

<state> - Whether raid mode is activated or not.

state must be either true or false

What is raid mode?

Raid mode prevents new users from joining your server while it is activated. This is to allow your moderators to ban any people trying to raid your server at any given time.

What will the user see?

If a user joins while a server is being raided, they will receive a message, letting them know that the server is currently on lockdown.

administrator

blacklistadd <channel>

Add a channel in which the commands will not be ran in

<channel> - The channel which GroundDug will ignore commands from

administrator

blacklistremove <channel>

Remove a channel in which the commands are not be ran in

<channel> - The channel which GroundDug will no longer ignore commands from

administrator

Permission commands

Command

Usage and notes

GD permission required

perms give <user> [permission]

Assigns a users' GroundDug (GD) permission.

<user> - The user to which to add the permission to.

[permission] - The GD permission to be added to the user. If none is provided, a list of permissions able to be added will be shown.

user must be discord.Pingable or discord.id and in the guild.

administrator

perms massadd <role> <permission

Assigns users within a role a GroundDug (GD) permission.

<role> - The role in which the permissions should be applied to

<permission> - The GD permission being added to users within that role.

role must be discord.Pingable or discord.id and in the guild

administrator

perms remove <user> [permission]

Removed a users' GroundDug (GD) permission.

<user> - The user to which to remove the permission to.

[permission] - The GD permission to be removed from the user. If none is provided, a list of permissions able to be removed will be shown.

user must be discord.Pingable or discord.id and in the guild.

administrator

perms massremove <role> <permission>

Remove a GroundDug (GD) permission from users within a role.

<role> - The role in which the permissions should be applied to

<permission> - The GD permission being added to users within that role.

role must be discord.Pingable or discord.id and in the guild

administrator

perms list <user>

Shows the current GroundDug (GD) permissions currently assigned to a user.

<user> - The user to display the current permissions for

user must be discord.Pingable or discord.id and in the guild.

None

Moderator commands

Command

Usage and notes

GD permission required

ban <member> [reason]

Bans a member from the guild.

<member> - The member which will be banned from the guild

[reason] - The reason the member is being banned from the guild

member must be discord.Pingable or discord.id and in the guild.

ban_members

gag <member>

Stops a user from talking in all voice channels.

<member> - The member which will be revoked of Speak permissions on all voice channels

member must be discord.Pingable or discord.id and in the guild.

mute_members

hackban <id> [reason]

Bans a user by their ID from the guild without them needing to be in the guild.

<id> - The ID of the user which will be banned from the guild

[reason] - The reason the member is being banned from the guild

id must be discord.id

ban_members

mute <member>

Stops a user from typing in all text channels.

<member> - The member which will be revoked of Send Messages permissions in all text channels

member must be discord.Pingable or discord.id and in the guild.

mute_members

purge [amount] [check]

Deletes multiple messages at once from the text channel the command was ran in.

[amount] - Specifies the amount of messages to be deleted from the text channel, 100 by default.

[check]- What messages should be deleted

check can be either:

  • member - Removing all messages posted by accounts which aren't classified as bots.

  • bot - Removing all messages posted by accounts which are bots.

  • all - Removing messages from any account

If check is not provided, the all check will be used.

manage_messages

softban <member> [reason]

Bans a member and immediately unbans them from the guild, removing their messages.

<member> - The member which will be banned from the guild

[reason] - The reason the member is being banned from the guild

member must be discord.Pingable or discord.id and in the guild.

ban_members

ungag <member>

Allows a user from talking again in all voice channels.

<member> - The member which will be givenSpeak permissions on all voice channels

member must be discord.Pingable or discord.id and in the guild.

mute_members

unmute <member>

Allows a user to typing in all text channels again.

<member> - The member which will be given Send Messages permissions in all text channels

member must be discord.Pingable or discord.id and in the guild.

mute_members

kick <member> [reason]

Kicks a member from the guild.

<member> - The member which will be banned from the guild

[reason] - The reason the member is being banned from the guild

member must be discord.Pingable or discord.id and in the guild.

kick_members

strike <user> [reason]

Gives a user a warning for a specific reason. Warnings are given case numbers, and can be tracked later through different commands.

<user> - The user which will receive the warning

[reason]- The reason the user is receiving the warning.

user must be discord.Pingable or discord.id and in the guild.

warn_members

forgive <user> <case #>

Remove a specific strike from a users' history. This will permanently remove the case from GroundDug logs.

<user> - The user the warning is being removed from.

<case #> - The case that is being removed from a users history.

user must be discord.Pingable or discord.id and in the guild.

warn_members

history [user]

View the warning history for a specific user.

[user] - The user of which to view the history of. If none is provided, the history will return for the invoker of the command.

user must be discord.Pingable or discord.id and in the guild.

None

Auto-Moderator

Auto-Moderator is GroundDugs' brand new feature which allows basic moderation to be executed by the bot, rather than by pesky little humans.

Command

Usage and notes

GD permission required

automod setup

Guides you though the auto-mod setup process, as well as being able to change a setting and review your current auto-moderator settings.

administrator

Boundary

Boundary protects your server even further by having users verify they are human through reCAPTCHA, a system developed by Google to prevent spam on the internet.

Command

Usage and notes

GD permission required

boundary enable

Enable Boundary and have users start verifying they are human as they join the server.

administrator

boundary disable

Disable Boundary

administrator

boundary setrole [role]

Set the role given to users once they have successfully verified.

[role] - The role given to users once they verify. If none was provided, the current given role will be shown.

role must be discord.Pingable or discord.id

administrator

Logging commands

Command

Usage and notes

GD permission required

logs disable [module]

Disables logging of a specific module within the guild.

[module]- The module to disable logging for. If none is provided, a list of modules available to disable will be shown.

administrator

logs enable [module]

Enables logging of a specific module within the guild.

[module] - The module to enable logging for. If none is provided, a list of modules available to enable will be shown

administrator

logs setchannel <channel>

Set the channel to which all command logs will be sent to on the guild

<channel> - The channel which logs will be sent to.

channel must be discord.Pingable or discord.id

administrator

Vote commands

Command

Usage and notes

GD permission required

vote

View your current votes and voting methods. On voting, you will gain votes which can then later be used to claim Premium.

None

vote status

View the status of the guild in terms of Premium.

None

vote redeem

Redeem your votes for GroundDug Premium.

administrator

vote link <user>

Link your votes to someone else, meaning they receive your votes.

<user> - The user that will receive your votes.

user must be discord.Pingable or discord.id

None

vote unlink

Unlink your votes from another user.

None