Mirai Bot Commands

Help Commands

m.help

Shows you a list of available commands and a short description.

Current command plugins:
normal, moderation, anime, osu, music, twitch

No cooldown

m.describe

Tells you about a command. Like this page but less info.

No cooldown

Aliases: desc

Command List

m.8ball

Ask the magic 8ball a question.

Cooldown: 3s

m.about

Get information about Mirai and a list of useful links.

Cooldown: 5s

m.airing

Find out when an anime is airing, or what is airing today. All times are UTC+9 by default.

To check the next episode and time of an anime: m.airing anime_name
To check everything airing: m.airing today or m.airing tomorrow or m.airing friday

You can also be notified every time an episode airs.
Subscribe: m.airing notify anime_name
Unsubscribe: m.airing notify stop anime_name
List subscribed: m.airing notify list
For a channel: m.airing notify channel ...

Cooldown: 5s

Aliases: airs

m.anime

Get information on an anime.

This command will only post adult anime if NSFW is enabled.
Data source: AniList

Cooldown: 5s

Uses embeds

m.avatar

Display a user's avatar in full size, or the server's icon.

To get the server's icon type server for the username.

To link a different size add --size # to the end, where # is a power of 2 from 16 to 1024

Cooldown: 5s

Aliases: a, icon

Not available in DMs

m.ban

Ban a user and DM them the reason.

Cooldown: 2s

Required Permission: Ban Members

Not available in DMs

m.catgirl

Get a catgirl from nekos.moe.

To search, add tags separated with a comma. If no tags are used a random catgirl will be posted. NSFW and sort tags do not count.

You can change the sorting order with the sort:... tag. Available orders are recent, likes, and oldest. Recent is the default.

If used in a NSFW channel then it is allowed to post NSFW images.
Restrict it to only SFW images with the "sfw" tag and only NSFW images with the "nsfw" tag.

Cooldown: 3s

Aliases: neko, nekos, catgirls, nyan, nyaa

m.character

Get info on an anime/manga/novel character.
Data source: AniList

Cooldown: 5s

Aliases: char, anichar

m.choose

Give it a list of options separated by a | and it will pick one. You can also use a comma if you really want to.

Cooldown: 3s

Aliases: c, pick, decide

m.coinflip

Flip a coin.

Cooldown: 3s

Aliases: coin, flip

m.currency

Convert an amount into other currencies.

Amount can include punctuation. For example: 1,000,000.95
To and from must be a valid 3-letter currency code.
You can also convert to multiple different currencies.

Rates are provided by European Central Bank. For more information and a list of supported symbols see their page

Cooldown: 5s

Aliases: convert

m.dice

By default rolls a 1d6. You can specify your own, but the limit for rolls and sides is 100.
If there are less than 10 rolls the results of each roll will be shown.

Cooldown: 3s

Aliases: die

m.facts

Updated!

Get facts about cats, a number, date, year, or math facts on a number.

Number Facts:
m.facts type number where type is one of trivia, math, date, year and number is a number or "random".
You can also have it pick randomly with m.facts random
Cat Facts:
m.facts cat

Cooldown: 2s

Aliases: fact

m.forceban

Ban a user that isn't on the server.

This command works the same way as the ban command, but a user ID is used instead of a mention.

Cooldown: 2s

Not available in DMs

m.fortune

Get a fortune from yerkee.com.

Category can be one of the following:
all, computers, cookie, definitions, miscellaneous, people, platitudes, politics, science, wisdom

Cooldown: 3s

m.giveaway

New!

Create and manage giveaways.

To start a giveaway use m.giveaway create. This will open the giveaway creator where you can choose its settings.
You can also use this shortcut to quickly create a giveaway: m.giveaway create [#channel] [prize] [duration] [num winners].
Giveaways are limited to one per user per channel. All commands have a channel argument which is optional.

Giveaways can be customized with these options:
Prize: Tells users what the giveaway is for (ex: A free t-shirt).
Channel: The channel a giveaway will be posted in. By default the current channel is used.
Duration: How long the giveaway will be open for (ex: 30m).
Winners: How many winners will be selected when the giveaway ends or is manually ended (min-max: 1-20).
Emote: The emote users will react with to enter the giveaway.
Minimum Account Age: The number of days an account must have existed for to enter the giveaway.
Allowed Roles: Allows restricting entry to certain roles.
Giveaways with a duration will automatically end after that time. You will not be able to use any of the commands below.

Giveaway Commands:
To close a giveaway without a duration use m.giveaway close [#channel] [num winners].
To draw winners for a giveaway use m.giveaway draw/pick [#channel] [number]. Once a user wins they can not win again.
To see the winners of a giveaway again use m.giveaway winners [#channel].
To end a giveaway use m.giveaway end [#channel]. Once a giveaway is ended you can not use any commands on it again.
Note: Giveaways are automatically ended after 28 days

Cooldown: 2s

Aliases: give, lottery, raffle

Uses embeds

Not available in DMs

m.info

To get info on a user input their name or mention them.
To get info on a channel mention it with #channel-name.
To get info on the server input server.

Cooldown: 2s

Uses embeds

Not available in DMs

m.inrole

See what users have a role. If there are more than 30 members in a role, names will not be shown.

Cooldown: 5s

Aliases: members

Not available in DMs

m.kick

Kick a user and send them a reason.

Cooldown: 2s

Required Permission: Kick Members

Not available in DMs

m.manga

Get info on a manga or novel.

This command will only post adult series if NSFW is enabled.
Data source: AniList

Cooldown: 5s

Aliases: novel, ln

Uses embeds

m.map

Show a map of a location.

To specify a zoom level use --zoom level, with level being a number from 1 to 20.
To specify a map type use --type type, with type being one of road, roadmap, sat, satellite, terrain, or hybrid.

Cooldown: 10s

Aliases: maps

m.music bind

Bind a music player to a text channel.
When a music player is bound to a text channel it will only accept commands from that channel. Now playing messages and other notices will also be sent there.
To unbind a music player use unbind

Cooldown: 2s

Aliases: b

Not available in DMs

m.music join

Updated!

Creates a music player for a server. If no voice channel is given, it will join the channel you are connected to.

To bind the music player to a text channel mention it channel after the voice channel. When a music player is bound to a text channel it will only accept commands from that channel, and now playing messages and other notices will be sent there.

Cooldown: 3s

Aliases: j, start

Not available in DMs

m.music nowplaying

Check what track is currently playing.

Cooldown: 2s

Aliases: playing, np

Not available in DMs

m.music pause

Pause the music player.

Cooldown: 2s

Aliases: ps

Not available in DMs

m.music queue

Updated!

Manage you music player's queue.

Add track: m.music queue
List tracks in queue: m.music queue list
Clear queue: m.music queue clear

Tip: Start your urls with "http://" to avoid accidentally triggering actions like clearing your queue.

Cooldown: 3s

Aliases: q, play

Not available in DMs

m.music resume

Resume the music player.

Cooldown: 2s

Aliases: rs

Not available in DMs

m.music skip

Skip the current track.

Cooldown: 3s

Aliases: sk

Not available in DMs

m.music stop

Updated!

Ends the server's music player, also emptying the queue.

Cooldown: 3s

Aliases: sp, leave

Not available in DMs

m.music volume

Set the volume of a music player (Mirai Bot Pro). The volume can be any number from 1 to 80. By default Pro music players are set to 20.

Cooldown: 3s

Aliases: v

Not available in DMs

m.osu profile

Check osu! profiles.

If your username is already configured then it can be omitted.
To set the gamemode add mode:.... Example: mode:mania or mode:ctb (default: standard)

Cooldown: 3s

Aliases: user, stats

Uses embeds

m.osu recent

Get a user's most recent scores. Note that PP will not be displayed.

If your username is already configured then it can be omitted.
To set the gamemode add mode:.... Example: mode:mania or mode:ctb (default: standard)

Cooldown: 5s

m.osu signature

Use lemmmy's osu!next sig generator.

If your username is already configured then it can be omitted.
To change the background color specify a hexadecimal color like so: color:00ff44 (default: ff66aa)
To set the gamemode add mode:.... Example: mode:mania or mode:ctb (default: standard)
Color can be shortened to c:, and mode to m:

Cooldown: 4s

Aliases: sig, image

m.osu top

Get a user's top scores.

If your username is already configured then it can be omitted.
To set the gamemode add mode:.... Example: mode:mania or mode:ctb (default: standard)

Cooldown: 5s

Aliases: best

m.permissions

Check what permissions a user has.

To check server-wide permissions add --server to the end.
If you have the Manage Roles permission then denied permissions will also be listed for the user.

Cooldown: 5s

Aliases: perms

Not available in DMs

m.ping

Check Mirai's latency to Discord.

Cooldown: 3s

Aliases: pong, latency

m.pro

Commands relating to Mirai Bot Pro

m.pro upgrade, m.pro go
Select a key to upgrade the server with.
m.pro downgrade
Unassign the key used for the server.
m.pro claim
Claim a pro key. This is used mainly for giveaways.
m.pro info
Learn what Mirai Bot Pro gives you.
m.pro tldr
Shorter info.
m.pro status, m.pro server status
Check your pro status.
m.pro key
Get information about a certain key.

Cooldown: 1s

m.prune

Deletes messages from a channel. You can use the options below to identify what messages you want deleted.
Remember that the number given is how many messages Mirai will go through, not how many will be deleted.
There is a limit of 500 messages. Pinned messages will not be deleted by default.
To specify multiple conditions separate the conditions with a |.

Options:
-c ... | --contains ... Messages containing the following text (wrap in quotes if containing a dash).
-i | --invites Messages containing an invite.
-u @user | --user @user Messages sent by @user (or by "user") (wrap in quotes if containing a dash).
-b | --bots Messages sent by bots.
-a | --attachments Messages containing an attachment.
-li | --links Messages containing a link.
-le # | --length # Messages longer than the specified length.
-p | --pinned Also delete pinned messages (affects all conditions).
-s | --silent Don't display success message after pruning (affects all conditions).

Cooldown: 5s

Aliases: purge, delete

Required Permission: Manage Messages

Not available in DMs

m.random

Generate a random number

By default it generates a number from 1-10. You can specify a maximum or range.

Cooldown: 2s

Aliases: roll

m.randomcomic

Get a random comic from explosm.net's RCG 2.0.

Cooldown: 10s

Aliases: rcg, comic

m.ratewaifu

An accurate rating of your waifu.

Can be used on users or anime waifus.
Many character's ratings are based on contests.

Cooldown: 3s

Aliases: rate, waifu

m.reddit

Get posts from a subreddit
If you would like to search for a post then add a query to the command.

Options can contain any of the following:
--time=timeframe hour, day, week, month, year, or all. Only works with top and controversial sorting (default: day for random, week for search)
--limit=number The number of posts to retrieve between 1 and 50 (default: 25)
--type=self or --type=link Only get self or link posts
--sort=mode hot, new, top, or controversial (default: top)
--embed Will embed the link in chat

If the channel is a NSFW channel then NSFW posts can be retrieved.

Cooldown: 5s

m.reminder

Set and manage reminders.

To set a reminder: m.reminder 0m 0d 0h 0m 0s | reminder_text
To list your reminders: m.reminder list
To remove a reminder: m.reminder remove text_in_reminder or m.reminder remove reminder if there is no text

You can have a maximum of 8 reminders.

Cooldown: 5s

Aliases: remind, reminders

m.rip

Some stupid command that will be re-written later into something better.

Cooldown: 2s

m.rockpaperscissors

Play rock paper scissors against Mirai.

Cooldown: 1s

Aliases: rps

m.role

Join or leave a managed role, or list all managed roles.

Add role: role add/join name
Remove role: role remove/leave name
List requestable roles: role list
To see all managed roles instead of just joinable ones, use m.role list all

Cooldown: 3s

Not available in DMs

m.softban

Kick a user from the server, but also delete their messages like a ban would.

Cooldown: 2s

Required Permission: Ban Members

Not available in DMs

m.strawpoll

0

Cooldown: 10s

Aliases: poll

m.twitch channel

Get information about a channel, and their stream.

Cooldown: 5s

Aliases: stream

Uses embeds

Not available in DMs

m.twitch follow

Updated!

Get notified in this channel when a twitch channel goes live.
Users must have link previews enabled to see these.

Cooldown: 5s

Aliases: notify

Required Permission: Manage Channel

Not available in DMs

m.twitch following

Updated!

Check what twitch channels this channel gets notifications for.

Cooldown: 5s

Aliases: channels

Not available in DMs

m.twitch unfollow

Updated!

Stop getting notifications about a twitch channel.

Cooldown: 5s

Required Permission: Manage Channel

Not available in DMs

m.urban

Get a definition from Urban Dictionary.
Only works in NSFW channels.

Cooldown: 4s

m.vote

Get the opinion of other users.

To start a vote: m.vote start t:topic | option | option 2 | ...
To end a vote: m.vote end
To check the running vote: m.vote check
To vote on an option: m.vote option

To set a topic add t:The title here | before the options. Default options are Yes and No.
When voting you can use the option's number instead of typing it.
Only the user that created a vote and users with the Manage Channel permission can end a vote.

Cooldown: 3s

Not available in DMs

m.weather

Check the weather anywhere in the world.
If no location is supplied your configured location is used.

If you want to hide the location then add --hidden to the end.
This can be done by default by enabling the "Hide weather location" option on the website.

This command is limited to 15 uses per day.

Cooldown: 20s

Aliases: w