Legend
<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 green2
Most 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.
General ℹ️
Help
Aliases: commands/h/how/command
Shows help about all or one specific command
Usage:
Help [command:Text]
Info
Responds with bot information
Usage:
Info
Invite
Responds with bot invite link
Usage:
Invite
Tools & Utilities 🔨
Calc
Aliases: c/calculate
Calculator 2+2=5
Usage:
Calc <Expression:Text>
CReminders
Lists reminders in channel, only users with 'manage server' permissions can use this.
Usage:
CReminders
CurrentTime
Aliases: ctime/gettime
Shows current time in different timezones. Available timezones
Usage:
CurrentTime <Offset:Whole number>CurrentTime <Zone:Text>CurrentTime
CustomCommands
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]
CustomEmbed
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>
DelReminder
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]
Evalcc
executes custom command code (up to 1k characters)
Usage:
Evalcc <code:Text>
fixscheduledccs
Corrects the next run time of interval CCs globally, fixes issues arising from missed executions due to downtime. Bot Admin Only
Usage:
fixscheduledccs
ListRoles
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]
Logs
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]
~Nicknames
Aliases: nn
Shows past nicknames of a user. Only shows up to the last 25 nicknames.
Usage:
Nicknames [User:User]
Poll
Create very simple reaction poll. Example: poll "favorite color?" blue red pink
Usage:
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]
Prefix
Shows command prefix of the current server, or the specified server
Usage:
Prefix [Server ID:Whole number]
Reminders
Lists your active reminders
Usage:
Reminders
Remindme
Aliases: remind/reminder
Schedules a reminder, example: 'remindme 1h30min are you alive still?'
Usage:
Remindme <Time:Duration> <Message:Text>
[-channel channel:Channel]
~ResetPastNames
Reset your past usernames/nicknames.
Usage:
ResetPastNames
Role
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]
Settimezone
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]
SimpleEmbed
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]
Stats
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
ToggleTimeConversion
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 all
Usage:
ToggleTimeConversion [flags:Text]
Undelete
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]
~Usernames
Aliases: unames/un
Shows past usernames of a user. Only shows up to the last 25 usernames.
Usage:
Usernames [User:User]
ViewPerms
Shows you or the targets permissions in this channel
Usage:
ViewPerms [target:Mention/ID]
Whois
Aliases: whoami
Shows information about a user
Usage:
Whois [User:Member]
Fun 🎉
Define
Aliases: df
Look up an urban dictionary definition, default paginated view.
Usage:
Define <Topic:Text>
[-raw raw:Switch - Raw output]
Weather
Aliases: w
Shows the weather somewhere
Usage:
Weather <Where:Text>
Topic
Generates a conversation topic to help chat get moving.
Usage:
Topic
CatFact
Aliases: cf/cat/catfacts
Cat Facts
Usage:
CatFact
DadJoke
Generates a dad joke using the API from icanhazdadjoke.
Usage:
DadJoke
DogFact
Aliases: dog/dogfacts
Dog Facts
Usage:
DogFact
Advice
Don't be afraid to ask for advice!
Usage:
Advice [What:Text]
Throw
Throwing things is cool.
Usage:
Throw [Target:User]
Roll
Roll dices, specify nothing for 6 sides, specify a number for max sides, or rpg dice syntax. Example: -roll 2d6
Usage:
Roll <Sides:Whole number>Roll <RPG Dice:Text>Roll
WouldYouRather
Aliases: wyr
Get presented with 2 options.
Usage:
WouldYouRather
[-raw raw:Switch - Raw output]
Xkcd
An xkcd comic, by default returns random comic strip
Usage:
Xkcd [Comic number:Whole number]
[-l Latest comic:Switch]
Howlongtobeat
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]
Inspire
Aliases: insp
Shows 'inspirational' quotes from inspirobot.me...
Usage:
Inspire
[-mindfulness mindfulness:Switch - Generates Mindful Quotes!]
Forex
Aliases: Money
💱 convert value from one currency to another.
Usage:
Forex <Amount:Decimal number> <From:Text> <To:Text>
Roast
Aliases: insult
Sends a random roast
Usage:
Roast [Target:User]
dictionary
Aliases: owldict/owl/dict
Get the definition of an English word using the dictionaryapi.dev
Usage:
dictionary <Query:Text - Word to search for>
TakeRep
Aliases: -/tr/trep/-rep
Takes away rep from someone
Usage:
TakeRep <User:User> [Num:Whole number]
GiveRep
Aliases: +/gr/grep/+rep
Gives rep to someone
Usage:
GiveRep <User:User> [Num:Whole number]
SetRep
Aliases: SetRepID
Sets someones rep, this is an admin command and bypasses cooldowns and other restrictions.
Usage:
SetRep <User:Mention/ID> <Num:Whole number>
DelRep
Deletes someone from the reputation list completely, this cannot be undone.
Usage:
DelRep <User:Mention/ID>
RepLog
Aliases: replogs
Shows the rep log for the specified user.
Usage:
RepLog <User:Mention/ID> [Page:Whole number]
Rep
Shows yours or the specified users current rep and rank
Usage:
Rep [User:User]c
TopRep
Shows rep leaderboard on the server
Usage:
TopRep [Offset:Whole number]
[-user user:Mention/ID - User to search for in the leaderboard]
8Ball
Ask the magic 8ball a question
Usage:
8Ball [Question:Text]
Soundboard
Aliases: sb
Play, or list soundboard sounds
Usage:
Soundboard [Name:Text]
SoundboardReset
Aliases: sbclose/sbreset
Reset Soundboard Player
Usage:
SoundboardReset
cah Create
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]
cah End
Ends a Cards Against Humanity game that is ongoing in this channel.
Usage:
End
cah Kick
Kicks a player from the ongoing Cards Against Humanity game in this channel.
Usage:
Kick <user:Mention/ID>
cah Packs
Lists all available packs.
Usage:
Packs
Trivia
Asks a random question, you have got 30 seconds to answer!
Usage:
Trivia
Debug & Maintenance 🖥
allocstat
Memory statistics. Bot Admin Only
Usage:
allocstat
banserver
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>
ccreqs
Returns the number of concurrent requests currently going on. Bot Admin Only
Usage:
ccreqs
cleardm
clears the DM chat with a user, owner only command.
Usage:
cleardm <Target:User>
createinvite
Maintenance command, creates an invite for the specified server. Bot Admin Only
Usage:
createinvite <server:Whole number>
CurrentShard
Aliases: cshard
Shows the current shard this server is on (or the one specified
Usage:
CurrentShard [serverid:Whole number]
dcallvoice
Disconnects from all the voice channels the bot is in. Bot Admin Only
Usage:
dcallvoice
findserver
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]
generatepremiumcode
Aliases: gpc
Generates premium codes. Bot Owner Only
Usage:
generatepremiumcode <Duration:Duration> <NumCodes:Whole number> <Message:Text>
globalrl
Tests the global ratelimit functionality. Bot Owner Only
Usage:
globalrl
IsGuildUnavailable
Returns wether the specified guild is unavilable or not
Usage:
IsGuildUnavailable <guildid:Whole number>
leaveserver
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>
listflags
Lists feature flags for the current, or optional provided guild. Bot Owner Only
Usage:
listflags
memstats
Full memory statistics. Bot Owner Only
Usage:
memstats
Ping
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
Roledbg
Returns count of autorole assignments currently being processed
Usage:
Roledbg
setstatus
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]
sleep
Maintenance command, used to test command queueing. Bot Admin Only
Usage:
sleep
state botmember/guild/member
Responds with state debug info. Bot Admin Only
Usage:
state botmemberstate guildstate member[-fetch fetch:Switch - fetch the member if not in state]
stateinfo
Responds with state debug info
Usage:
stateinfo
testreddit
Tests the reddit feeds in this server by checking the specified post. Bot Owner Only
Usage:
testreddit <post-id:Text>
TopServers
Responds with the top 15 servers I'm on
Usage:
TopServers [Skip:Whole number - Entries to skip]
[-id serverID:Whole number]
toggledbg
Toggles Debug Logging. Restarting the bot will always reset debug logging. Bot Owner Only
Usage:
toggledbg
topcommands
Shows command usage stats
Usage:
topcommands [hours:Whole number]
topevents
Shows gateway event processing stats for all or one shard
Usage:
topevents [shard:Whole number]
topgames
Shows the top games on this server
Usage:
topgames
[-all all:Switch]
unbanserver
Removes the bot ban from the specified server. Bot Owner Only
Usage:
unbanserver <server:Text>
Viewperms
Shows you or the targets permissions in this channel
Usage:
ViewPerms [target:Mention/ID]
Yagstatus
Aliases: status
Shows yagpdb status, version, uptime, memory stats, and so on
Usage:
Yagstatus
Moderation 👮
All auto-moderation commands automod ...
affect Automoderator v2.
Ban
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]
Unban
Aliases: unbanid
Unbans a user. Reason requirement is same as ban command setting.
Usage:
Unban <User:Mention/ID> [Reason:Text]
Kick
Kicks a member
[-cl cl:Whole number - Messages to delete]
Usage:
Kick <User:Mention/ID> [Reason:Text]
Mute
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>
Unmute
Unmutes a member
Usage:
Unmute <User:User Mention> [Reason:Text]
Timeout
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>
RemoveTimeout
Aliases: untimeout/cleartimeout/deltimeout/rto
Removes a member's timeout
Usage:
RemoveTimeout <User:Mention/ID> [Reason:Text]
Report
Reports a member to the server's staff
Usage:
Report <User:Mention/ID> <Reason:Text>
Clean
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 messages
Usage:
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]]
Reason
Add/Edit a modlog reason
Usage:
Reason <ID:Whole number> <Reason:Text>
Warn
Warns a user, warnings are saved using the bot. Use -warnings to view them.
Usage:
Warn <User:User Mention> <Reason:Text>
Warnings
Aliases: Warns
Lists warning of a user.
Usage:
Warnings <User:Mention/ID>
EditWarning
Edit a warning, id is the first number of each warning from the warnings command
Usage:
EditWarning <Id:Whole number> <NewMessage:Text>
DelWarning
Aliases: dw/delwarn/deletewarning
Deletes a warning, id is the first number of each warning from the warnings command
Usage:
DelWarning <Id:Whole number> [Reason:Text]
ClearWarnings
Aliases: clw
Clears the warnings of a user
Usage:
ClearWarnings <User:Mention/ID> [Reason:Text]
TopWarnings
Aliases: topwarns
Shows ranked list of warnings on the server.
Usage:
TopWarnings [Page:Whole number]
[-id List UserIDs:Switch]
GiveRole
Aliases: grole/arole/addrole
Gives a role to the specified member, with optional expiry
Usage:
GiveRole <User:Mention/ID> <Role:Text> [Duration:Duration]
TakeRole
Aliases: rrole/takearole/trole
Removes the specified role from the target
Usage:
RemoveRole <User:Mention/ID> <Role:Text>
automod Rulesets
Aliases: r/list/l
Lists all rulesets and their status
Usage:
Rulesets
automod Toggle
Aliases: t
Toggles a ruleset on/off
Usage:
Toggle <ruleset name:Text>
automod Logs
Aliases: log
Shows the log of the last triggered automod rules, optionally filtering by user
Usage:
Logs [skip:Whole number]
[-user :Mention/ID]
automod ListViolations
Aliases: Violations/ViolationLogs/VLogs/VLog
Lists Violations of specified user /n old flag posts oldest violations in first page ( from oldest to newest ).
Usage:
ListViolations <User:Mention/ID> [Page Number:Whole number]
[-old Oldest First:Switch]
automod ListViolationsCount
Aliases: ViolationsCount/VCount
Lists Violations summary in entire server or of specified user optionally filtered by max violation age. Specify number of violations to skip while fetching using -skip flag ; max entries fetched 500.
Usage:
ListViolationsCount [User:Mention/ID]
[-ma Max Violation Age:Duration][-skip Amount Skipped:Whole number]
automod DeleteViolation
Aliases: DelViolation/DelV/DV
Deletes a Violation with the specified ID. ID is the first number of each Violation in the ListViolations command.
Usage:
DeleteViolation <ID:Whole number>
automod ClearViolations
Aliases: ClearV/ClrViolations/ClrV
Clears Violations of specified user optionally filtered by Name, Min/Max age and other conditions. By default, more recent violations are preferentially cleared.
Usage:
ClearViolations <User:Mention/ID> [Violation Name:Text]
[-ma Max Violation Age:Duration][-mina Min Violation Age:Duration][-num Max Violations Cleared:Whole number][-old Preferentially Clear Older Violations:Switch][-skip Amount Skipped:Whole number]
Rolemenu 🔘
alias: rmenu
RoleMenu Create
Aliases: c
Set up a role menu. Specify a message with -m to use an existing message instead of having the bot make one
To get the id of a message you have to turn on developer mode in discord's appearances settings then right click the message and copy id.
Usage:
Create <Group:Text>
[-m Message ID:Whole number][-nodm Disable DM:Switch][-rr Remove role on reaction removed:Switch][-skip Number of roles to skip:Whole number]
RoleMenu EditOption
Aliases: edit
Allows you to reassign the emoji of an option, tip: use ResetReactions afterwards.
To get the id of a message you have to turn on developer mode in discord's appearances settings then right click the message and copy id.
Usage:
EditOption <Message ID:Whole number>
RoleMenu Listgroups
Aliases: list/groups
Lists all role groups.
Usage:
Listgroups
RoleMenu Remove
Removes a rolemenu from a message. The message won't be deleted and the bot will not do anything with reactions on that message
To get the id of a message you have to turn on developer mode in discord's appearances settings then right click the message and copy id.
Usage:
Remove <Message ID:Whole number>
RoleMenu ResetReactions
Aliases: reset
Removes all reactions on the specified menu message and re-adds them. Can be used to fix the order after updating it.
To get the id of a message you have to turn on developer mode in discord's appearances settings then right click the message and copy id.
Usage:
ResetReactions <Message ID:Whole number>
RoleMenu Update
Aliases: u
Updates a rolemenu, toggling the provided flags and adding missing options, aswell as updating the order.
To get the id of a message you have to turn on developer mode in discord's appearances settings then right click the message and copy id.
Usage:
Update <Message ID:Whole number>
[-nodm Disable DM:Switch][-rr Remove role on reaction removed:Switch]
Tickets 🎫
alias: ticket
Tickets Open
Aliases: create/new/make
Opens a new ticket
Usage:
Open <subject:Text>
Tickets AddUser
Adds a user to the ticket in this channel
Usage:
AddUser <target:Member>
Tickets RemoveUser
Removes a user from the ticket
Usage:
RemoveUser <target:Member>
Tickets Rename
Renames the ticket
Usage:
Rename <new-name:Text>
Tickets Close
Aliases: end/delete
Closes the ticket
Usage:
Close [reason:Text]
Tickets AdminsOnly
Aliases: adminonly/ao
Toggle admins only mode for this ticket
Usage:
AdminsOnly
Events 🎟
alias: event
Events Create
Aliases: new/make
Creates an event, You will be led through an interactive setup
Usage:
Create
Events Edit
Edits an event
Usage:
Edit <ID:Whole number>
[-title :Text - Change the title of the event][-time :Text - Change the start time of the event][-max :Whole number - Change max participants]
Events List
Aliases: ls
Lists all events in this server
Usage:
List
Events Delete
Aliases: rm/del
Deletes an event, specify the event ID of the event you wanna delete
Usage:
Delete <ID:Whole number>
Events StopSetup
Aliases: cancelsetup
Force cancels the current setup session in this channel
Usage:
StopSetup