Comment on page
All Commands
<required arg> [optional arg]Text arguments containing multiple words needs be to put in quotes ("arg here") or backticks (`arg here`) if it's not the last argument and there's more than 1 text argument.
For example with the poll command if you want the question to have multiple words:
-poll "what's your favourite colour" red blue green2Most Debug & Maintenance commands, or commands without any meaningful description are meant for bot owner or serverAdmin only!
If commands are denoted with an accent, tilde
~, they are not yet deployed in actual YAGPDB bot or have been disabled in main bot, but are still in master code branch.Aliases: commands/h/how/command
Shows help about all or one specific command
Usage:
Help [command:Text]
Responds with bot information
Usage:
Info
Responds with bot invite link
Usage:
Invite
Aliases: c/calculate
Calculator 2+2=5
Usage:
Calc <Expression:Text>
Lists reminders in channel, only users with 'manage server' permissions can use this.
Usage:
CReminders
Aliases: ctime/gettime
Usage:
CurrentTime <Offset:Whole number>
CurrentTime <Zone:Text>
CurrentTime
Aliases: cc
Shows a custom command specified by id or trigger, or lists them all
Usage:
CustomCommands <ID:Whole number>
CustomCommands <Trigger:Text>
CustomCommands
[-file Sends responses in a file:Switch]
[-color Use syntax highlighting (GO):Switch]
[-raw raw:Switch - Force raw output]
Aliases: ce
Creates an embed from what you give it in json form: https://docs.yagpdb.xyz/others/custom-embeds Example:
-ce {"title": "hello", "description": "wew"}Usage:
CustomEmbed <Json:Text>
Aliases: rmreminder
Deletes a reminder. You can delete reminders from other users provided you are running this command in the same guild the reminder was created in and have the Manage Channel permission in the channel the reminder was created in.
Usage:
DelReminder <ID:Whole number>
[-a All:Switch]
executes custom command code (up to 1k characters)
Usage:
Evalcc <code:Text>
Corrects the next run time of interval CCs globally, fixes issues arising from missed executions due to downtime. Bot Admin Only
Usage:
fixscheduledccs
List roles, their id's, color hex code, and 'mention everyone' perms (useful if you wanna double check to make sure you didn't give anyone mention everyone perms that shouldn't have it)
Usage:
ListRoles
[-nomanaged Don't list managed/bot roles:Switch]
Aliases: log
Creates a log of the last messages in the current channel. This includes deleted messages within an hour (or 12 hours for premium servers)
Usage:
Logs [Count:Whole number]
Aliases: nn
Shows past nicknames of a user. Only shows up to the last 25 nicknames.
Usage:
Nicknames [User:User]
Shows the latency from the bot to the discord servers. Note that high latencies can be the fault of ratelimits and the bot itself, it's not a absolute metric.
Usage:
Ping
Create very simple reaction poll. Example:
poll "favorite color?" blue red pinkUsage:
Poll <Topic:Text - Description of the poll> <Option1:Text> <Option2:Text> [Option3:Text] [Option4:Text] [Option5:Text] [Option6:Text] [Option7:Text] [Option8:Text] [Option9:Text] [Option10:Text]
Shows command prefix of the current server, or the specified server
Usage:
Prefix [Server ID:Whole number]
Lists your active reminders
Usage:
Reminders
Aliases: remind/reminder
Schedules a reminder, example: 'remindme 1h30min are you alive still?'
Usage:
Remindme <Time:Duration> <Message:Text>
[-channel channel:Channel]
Reset your past usernames/nicknames.
Usage:
ResetPastNames
Toggle a role on yourself or list all available roles, they have to be set up in the control panel first, under 'rolecommands'
Usage:
Role [Role:Text]
Aliases: setz/tzset
Sets your timezone, used for various purposes such as auto conversion. Give it your country.
Usage:
Settimezone [Timezone:Text]
[-u Display current:Switch]
[-d Delete TZ record:Switch]
Aliases: se
A more simpler version of CustomEmbed, controlled completely using switches.
You can edit existing messages by supplying the
-message flag.Usage:
SimpleEmbed
[-channel :Channel - Optional channel to send in]
[-message message:Whole number - Optional message ID to edit]
[-content :Text - Text content for the message]
[-title :Text]
[-desc :Text - Text in the 'description' field]
[-color :Text - Either hex code or name]
[-url :Text - Url of this embed]
[-thumbnail :Text - Url to a thumbnail]
[-image :Text - Url to an image]
[-author :Text - The text in the 'author' field]
[-authoricon :Text - Url to a icon for the 'author' field]
[-authorurl :Text - Url of the 'author' field]
[-footer :Text - Text content for the footer]
[-footericon :Text - Url to a icon for the 'footer' field]
Shows server stats (if public stats are enabled). This command is only available if collecting statistics is enabled bot not user side. Disabled for YAGPDB.
Usage:
Stats
Aliases: toggletconv/ttc
Toggles automatic time conversion for people with registered timezones (setz) in this channel, its on by default, toggle all channels by giving it
allUsage:
ToggleTimeConversion [flags:Text]
Aliases: ud
Views the first 10 recent deleted messages. By default, only the current user's deleted messages will show. You can use the
-a flag to view all users delete messages, or -u to view a specified user's deleted messages. Both -a and -u require Manage Messages permission. Note: -u overrides -a meaning even though -a might've been specified along with -u only messages from the user provided using -u will be shown.Usage:
Undelete
[-a a:Switch - from all users]
[-u u:Mention/ID - from a specific user]
[-channel channel:Channel - Optional target channel]
Aliases: unames/un
Shows past usernames of a user. Only shows up to the last 25 usernames.
Usage:
Usernames [User:User]
Shows you or the targets permissions in this channel
Usage:
ViewPerms [target:Mention/ID]
Aliases: whoami
Shows information about a user
Usage:
Whois [User:Member]
Aliases: df
Look up an urban dictionary definition, default paginated view.
Usage:
Define <Topic:Text>
[-raw raw:Switch - Raw output]
Aliases: w
Shows the weather somewhere
Usage:
Weather <Where:Text>
Generates a conversation topic to help chat get moving.
Usage:
Topic
Aliases: cf/cat/catfacts
Cat Facts
Usage:
CatFact
Generates a dad joke using the API from icanhazdadjoke.
Usage:
DadJoke
Aliases: dog/dogfacts
Dog Facts
Usage:
DogFact
Don't be afraid to ask for advice!
Usage:
Advice [What:Text]
Throwing things is cool.
Usage:
Throw [Target:User]
Roll dices, specify nothing for 6 sides, specify a number for max sides, or rpg dice syntax. Example:
-roll 2d6Usage:
Roll <Sides:Whole number>
Roll <RPG Dice:Text>
Roll
Aliases: wyr
Get presented with 2 options.
Usage:
WouldYouRather
[-raw raw:Switch - Raw output]
An xkcd comic, by default returns random comic strip
Usage:
Xkcd [Comic number:Whole number]
[-l Latest comic:Switch]
Aliases: hltb
Game information based on query from howlongtobeat.com. Results are sorted by popularity, it's their default. Without -p returns the first result. Switch -p gives paginated output using Levenshtein distance sorting max 20 results.
Usage:
HowLongToBeat <Game-Title:Text>
[-c c:Switch - Compact output]
[-p p:Switch - Paginated output]
Aliases: insp
Shows 'inspirational' quotes from inspirobot.me...
Usage:
Inspire
[-mindfulness mindfulness:Switch - Generates Mindful Quotes!]
Aliases: Money
💱 convert value from one currency to another.
Usage:
Forex <Amount:Decimal number> <From:Text> <To:Text>
Aliases: insult
Sends a random roast
Usage:
Roast [Target:User]
Responds with the top 15 servers I'm on
Usage:
TopServers [Skip:Whole number - Entries to skip]
[-id serverID:Whole number]
Aliases: owldict/owl/dict
Get the definition of an English word using the dictionaryapi.dev
Usage:
dictionary <Query:Text - Word to search for>
Aliases: -/tr/trep/-rep
Takes away rep from someone
Usage:
TakeRep <User:User> [Num:Whole number]
Aliases: +/gr/grep/+rep
Gives rep to someone
Usage:
GiveRep <User:User> [Num:Whole number]
Aliases: SetRepID
Sets someones rep, this is an admin command and bypasses cooldowns and other restrictions.
Usage:
SetRep <User:Mention/ID> <Num:Whole number>
Deletes someone from the reputation list completely, this cannot be undone.
Usage:
DelRep <User:Mention/ID>
Aliases: replogs
Shows the rep log for the specified user.
Usage:
RepLog <User:Mention/ID> [Page:Whole number]
Shows yours or the specified users current rep and rank
Usage:
Rep [User:User]c
Shows rep leaderboard on the server
Usage:
TopRep [Offset:Whole number]
[-user user:Mention/ID - User to search for in the leaderboard]
Ask the magic 8ball a question
Usage:
8Ball [Question:Text]
Aliases: sb
Play, or list soundboard sounds
Usage:
Soundboard [Name:Text]
Aliases: sbclose/sbreset
Reset Soundboard Player
Usage:
SoundboardReset
Aliases: c
Creates a Cards Against Humanity game in this channel, add packs after commands, or * for all packs. (-v for vote mode without a card czar).
Usage:
Create [packs:Text - Packs seperated by space, or * for all of them.]
[-v Vote mode - players vote instead of having a card czar.:Switch]
Ends a Cards Against Humanity game that is ongoing in this channel.
Usage:
End
Kicks a player from the ongoing Cards Against Humanity game in this channel.
Usage:
Kick <user:Mention/ID>
Lists all available packs.
Usage:
Packs
Memory statistics. Bot Admin Only
Usage:
allocstat
Bans the specified server from using the bot. YAGPDB will leave the server, and leave whenever invited back. Bot Owner Only
Usage:
banserver <server:Whole number>
Returns the number of concurrent requests currently going on. Bot Admin Only
Usage:
ccreqs
Maintenance command, creates an invite for the specified server. Bot Admin Only
Usage:
createinvite <server:Whole number>
Aliases: cshard
Shows the current shard this server is on (or the one specified
Usage:
CurrentShard [serverid:Whole number]
Disconnects from all the voice channels the bot is in. Bot Admin Only
Usage:
dcallvoice
Aliases: findservers
Looks for a server by server name or the servers a user owns. Bot Admin Only
Usage:
findserver
[-name name:Text]
[-user user:Mention/ID]
Aliases: gpc
Generates premium codes. Bot Owner Only
Usage:
generatepremiumcode <Duration:Duration> <NumCodes:Whole number> <Message:Text>
Tests the global ratelimit functionality. Bot Owner Only
Usage:
globalrl
Returns wether the specified guild is unavilable or not
Usage:
IsGuildUnavailable <guildid:Whole number>
Causes YAGPDB to leave the specified server. The bot may still be invited back with full functionality restored. Bot Owner Only
Usage:
leaveserver <server:Whole number>
Lists feature flags for the current, or optional provided guild. Bot Owner Only
Usage:
listflags
Full memory statistics. Bot Owner Only
Usage:
memstats
Returns count of autorole assignments currently being processed
Usage:
Roledbg
Sets the bot's presence type, status text, online status, and optional streaming URL. Bot Admin Only
Usage:
setstatus [status:Text]
[-url url:Text - The URL to the stream. Must be on twitch.tv or youtube.com. Activity type will always be streaming if this is set.]
[-type type:Text - Set activity type. Allowed values are 'playing', 'streaming', 'listening', 'watching', 'custom', 'competing'. Defaults to custom status]
[-status status:Text - Set online status. Allowed values are 'online', 'idle', 'dnd', 'offline'. Defaults to online]
Maintenance command, used to test command queueing. Bot Admin Only
Usage:
sleep
Responds with state debug info. Bot Admin Only
Usage:
state botmember
state guild
state member
[-fetch fetch:Switch - fetch the member if not in state]
Responds with state debug info
Usage:
stateinfo
Tests the reddit feeds in this server by checking the specified post. Bot Owner Only
Usage:
testreddit <post-id:Text>
Toggles Debug Logging. Restarting the bot will always reset debug logging. Bot Owner Only
Usage:
toggledbg
Shows command usage stats
Usage:
topcommands [hours:Whole number]
Shows gateway event processing stats for all or one shard
Usage:
topevents [shard:Whole number]
Shows the top games on this server
Usage:
topgames
[-all all:Switch]
Removes the bot ban from the specified server. Bot Owner Only
Usage:
unbanserver <server:Text>
Shows you or the targets permissions in this channel
Usage:
ViewPerms [target:Mention/ID]
Aliases: status
Shows yagpdb status, version, uptime, memory stats, and so on
Usage:
Yagstatus
All auto-moderation commands
automod ... affect Automoderator v2.Aliases: banid
Bans a member, specify a duration with -d and specify number of days of messages to delete with -ddays (0 to 7)
Usage:
Ban <User:Mention/ID> <Duration:Duration> <Reason:Text>
Ban <User:Mention/ID> <Reason:Text> <Duration:Duration>
Ban <User:Mention/ID> <Duration:Duration>
Ban <User:Mention/ID> <Reason:Text>
Ban <User:Mention/ID>
[-ddays Days:Whole number]
Aliases: unbanid
Unbans a user. Reason requirement is same as ban command setting.
Usage:
Unban <User:Mention/ID> [Reason:Text]
Kicks a member
[-cl cl:Whole number - Messages to delete]
Usage:
Kick <User:Mention/ID> [Reason:Text]
Mutes a member
Usage:
Mute <User:User Mention> <Duration:Duration> <Reason:Text>
Mute <User:User Mention> <Reason:Text> <Duration:Duration>
Mute <User:User Mention> <Duration:Duration>
Mute <User:User Mention> <Reason:Text>
Mute <User:User Mention>
Unmutes a member
Usage:
Unmute <User:User Mention> [Reason:Text]
Aliases: to
Timeout a member
Usage:
Timeout <User:Mention/ID> <Duration:Duration> <Reason:Text>
Timeout <User:Mention/ID> <Reason:Text> <Duration:Duration>
Timeout <User:Mention/ID> <Duration:Duration>
Timeout <User:Mention/ID> <Reason:Text>
Timeout <User:Mention/ID>
Aliases: untimeout/cleartimeout/deltimeout/rto
Removes a member's timeout
Usage:
RemoveTimeout <User:Mention/ID> [Reason:Text]
Reports a member to the server's staff
Usage:
Report <User:Mention/ID> <Reason:Text>
Aliases: clear/cl
Will not delete messages older than 2 weeks.
Delete the last number of messages from chat, optionally filtering by user, max age and regex or ignoring pinned messages.
Warning: Using
clean <userId> <amount> does not work. This is because the user ID is interpreted as the amount. As it is over the limit of 100, it is treated as invalid. You can use clean <amount> <userId> instead or mention the user. Specify a regex with "-r regex_here" and max age with "-ma 1h10m" You can invert the regex match (i.e. only clear messages that do not match the given regex) by supplying the -im flag.
Note: Will only look in the last 1k messagesUsage:
Clean <Num:Whole number>
Clean <Num:Whole number> <User:User Mention>
Clean <User:User Mention> <Num:Whole number>
[-r r:Text - Regex]
[-im im:Switch - Invert regex match]
[-ma ma:Duration - Max age]
[-minage minage:Duration - Min age]
[-i i:Switch - Regex case insensitive]
[-nopin nopin:Switch - Ignore pinned messages]
[-a a:Switch - Only remove messages with attachments]
[-to to:Whole number - Stop at this msg ID]
[-from from:Whole number - Start at this msg ID]]
Add/Edit a modlog reason
Usage:
Reason <ID:Whole number> <Reason:Text>
Warns a user, warnings are saved using the bot. Use -warnings to view them.
Usage:
Warn <User:User Mention> <Reason:Text>
Aliases: Warns
Lists warning of a user.
Usage:
Warnings <User:Mention/ID>
Edit a warning, id is the first number of each warning from the warnings command
Usage:
EditWarning <Id:Whole number> <NewMessage:Text>