Commands

Normal / Anime Commands


By default normal commands can be used by directly talking to the bot on the platform you're using.
Discord: Some servers might require you to @mention the bot, or use a specific server channel.

Try your luck and find out who your Waifu or Husbando is!

Optional:
  • Add a series name to receive one from said series.
Notes:
  • Searching for a series takes all your text into account; keep that in mind - see examples.
Examples:
Waifu
Husbando
Waifu Sword Art Online
Husbando Shingeki no Kyojin
Waifu Naruto
Husbando Boku no Hero Academia
Waifu Kill la Kill

Find out who you're favourite Idol is!

Optional:
  • Get a male idol by adding 'Husbando' to your message!
  • Add a series name to get a idol from there specifically: 'Love Live!', 'Love Live! Sunshine!!', 'Idolmaster', 'Idolmaster Cinderalla Girls', 'AKB0048', 'Wake up Girls' or 'Aikatsu'
Examples:
Idol
Idol Husbando
Idol Love Live Sunshine
Idol Idolmaster
Idol AKB0048

Get an image of your registered Waifu or Husbando! To learn how to register one, use 'WaifuRegister' or 'HusbandoRegister'. For more help check the Wiki located here: WaifuRegister Help.

Optional:
  • You can add '+' on the end to get a random image that could be a repeat.
  • You can add '-' on the end to reset your 'seen images' so you can get a fresh start.
Examples:
MyWaifu
MyHusbando
MyWaifu+
MyHusbando+
MyWaifu-
This is a Patreon Silver command!

Get an image of your registered OTP! To learn how to register one, use 'OTPRegister' or check the Wiki located here.

Optional:
  • You can add '+' on the end to get a random image that could be a repeat.
  • You can add '-' on the end to reset your 'seen images' so you can get a fresh start.
Examples:
MyOTP
MyOTP+
MyOTP-
This is a Patreon Silver command!

Get an image of your registered Idol! To learn how to register one, use 'IdolRegister' or check the Wiki located here.

Optional:
  • You can add '+' on the end to get a random image that could be a repeat.
  • You can add '-' on the end to reset your 'seen images' so you can get a fresh start.
Examples:
MyIdol
MyIdol+
MyIdol-

Register your Waifu or Husbando and take them to Discord, Twitter and Twitch; show the world who you are in love with!

Notes:
Examples:
WaifuRegister Ryuuko Matoi
WaifuRegister Zero Two (Darling in The Franxx)
WaifuRegister Rem (Re:Zero)
HusbandoRegister Prompto Argentum
HusbandoRegister Astolfo (Fate)
HusbandoRegister Link
This is a Patreon Silver command!

Register your Idol and take them to Discord, Twitter and Twitch; show the world who your favourite idol is!

Notes:
Examples:
IdolRegister Nishikino Maki
IdolRegister Hatsune Miku
IdolRegister Ohara Mari
This is a Patreon Silver command!

Register your OTP (One-True-Pairing) and take them to Discord, Twitter and Twitch; show the world who your OTP are!

Notes:
Examples:
OTPRegister Lillie (Pokemon) (x) Mizuki (Pokemon)
OTPRegister Vegeta (x) Bulma
OTPRegister Nishikino Maki (x) Yazawa Nico

See who your random OTP, Yuri OTP or Yaoi OTP!

Optional:
  • Also supports 'OTP Shipgirl', 'OTP Granblue', 'OTP Idol', 'OTP Touhou' and 'OTP Vocaloid'.
  • Add a show name to receive a OTP from that show!
  • You can also do two shows together: Bleach (x) Naruto
Notes:
  • Note the '(x)' compared to the normal 'Bleach x Naruto' you would normally see around.
  • Searching for a series takes all your message into account; keep that in mind. If the series you used doesn't have more than 2 people for that gender in said series this will not work.
Patreon Extras:
  • Try 'OTP Vidya' to get your vidya (Video Game characters) OTP match!
Examples:
OTP
OTP Yuri
OTP Yaoi
OTP Clannad (x) Kuroko no Basket
Yuri OTP K-On!
Yaoi OTP Bleach
Yaoi OTP Bleach (x) Naruto
This is a Patreon Bronze command!

Find out who is in your 3+ people Harem!

Optional:
  • Also supports 'Harem Yuri', 'Harem Yaoi', 'Harem Vidya', 'Harem Shipgirl', 'Harem Granblue', 'Harem Idol', 'Harem Touhou' and 'Harem Vocaloid'.
  • Add one or more show names to receive a Harem from them shows!
  • You can also do many shows together: Bleach (x) Naruto (x) Date A Live (x) Goblin Slayer
Notes:
  • Note the '(x)' compared to the normal 'Bleach x Naruto x Date a Live x Goblin Slayer' you would normally see around.
  • Searching for a series takes all your message into account; keep that in mind. If the series you used doesn't have more than 2 people for that gender in said series this will not work.
Examples:
Harem
Harem Yuri
Harem Yaoi
Harem Clannad (x) Kuroko no Basket
Yuri Harem K-On!
Yaoi Harem Bleach (x) Naruto
Harem Vidya

Summon your very own Fate (series) servant!

Examples:
Fate/Servant

Spawn your own random Granblue Fantasy character!

Examples:
Granblue

Who is your Imouto (Little Sister)?

Examples:
Imouto

Find out who your school Senpai (Upperclass Friend) and Kouhai (Underclass Friend) is!

Optional:
  • Try adding 'Husbando' to your message!
Examples:
Senpai
Senpai Husbando
Kouhai
Kouhai Husbando

See who your new Monstergirl-friend is!

Examples:
Monstergirl

Get your own Onee-chan (big sister) or Onii-chan (big brother)!

Examples:
Onee-chan
Onii-chan

Find out who your Sensei (Teacher) is!

Optional:
  • Try adding 'Husbando' to your message!
Examples:
Sensei
Sensei Husbando
This is a Patreon Bronze command!

Get a Video Game related waifu using Vidya!

Examples:
Vidya
This is a Patreon Bronze command!

Found out who your Dandere (very shy, but slowly come out of their shell) is!

Examples:
Dandere
This is a Patreon Bronze command!

Get a waifu who also happens to be a catgirl!

Examples:
Catgirl

Try your luck at Gacha with these series: Granblue Fantasy, Fate/Grand Order, Love Live! SIF, Fire Emblem: Heroes, Arknights and Genshin Impact

Optional:
  • Granblue Fantasy - Premium 10 Draw
  • Fate/Grand Order - Story 10 Roll
  • Fire Emblem: Heroes - 5 Orbs
  • Love Live! SIF - Honor Scouting 11 Pull
  • Arknights - Headhunting 10 Roll
  • Genshin Impact - Wanderlust Invocation 10 Wish
  • Genshin Impact - All Other Active Banners 10 Wish
Notes:
  • By default it will be random at which series you roll with. To get the series you want add the series name to your message (see example).
  • Genshin Impact supports all currently active banners, include the banner's name at the end of your message. We will also pick up on parts of the banners name or first letter of each word in the banner's name. By default Genshin Impact will roll the 'Wanderlust Invocation' 10 Wish banner.
Examples:
Gacha
Gacha Granblue
Gacha Fate
Gacha Fire
Gacha Love
Gacha Love Live
Gacha Fire Emblem
Gacha Gran
Gacha Love Live Aqours
Gacha Fate/Go
Gacha Love ยต
Gacha Genshin Impact
Gacha Impact
Gacha Genshin Ballad in Goblets
Gacha Genshin BiG
Gacha Genshin Impact Epitome

Get a random Shipgirl from Kantai Collection!, Azur Lane or Aoki Hagane no Arpeggio!

Optional:
  • Add 'Azur Lane' or 'Aoki Hagane no Arpeggio' to get a Shipgirl from that respective series.
Examples:
Shipgirl
Shipgirl Azur Lane
Shipgirl Aoki Hagane

Dodge bullets fighting a random Touhou!

Examples:
Touhou

Check out who your favourite Vocaloid is!

Examples:
Vocaloid

Check who is dirving your tank with a Tankgirl from Girls und Panzer!

Examples:
Tankgirl

Team up with a Strikegirl from Strike Witches!

Examples:
Strikegirl

See what demon Abyssal is targeting you from Kantai Collection!

Examples:
Abyssal

Christmas themed command; only active on 5th December till 30th December.
Unwrap your present and see who was hiding wrapped up!

Patreon Extras:
  • Patreon Silver or above can use this themed command at anytime.
Examples:
Unwrap

Halloween themed command; only active on 3rd of October till 3rd of November.
Which Witchgirl is haunting you this Spooktober?

Patreon Extras:
  • Patreon Silver or above can use this themed command at anytime.
Examples:
Witchgirl
This is a Patreon Bronze command!

Watch your back, turn around and see who your Yandere (Stalker) is!

Examples:
Yandere
This is a Patreon Bronze command!

Found out who your Himedere (Princess-dere) is!

Examples:
Himedere
This is a Patreon Bronze command!

See who is being emotionlessly blunt and cold towards you with Kuudere!

Examples:
Kuudere
This is a Patreon Bronze command!

See who is being very cold towards you with Tsundere!

Examples:
Tsundere
This is a Patreon Bronze command!

Your Okaa-san (mother) is waiting for you!

Examples:
Okaa-san
Okaa
This is a Patreon Bronze command!

Summon a full Fate/Go 3-piece team to take into battle!

Examples:
Fate/Team
This is a Patreon Bronze command!

Search a imageboard site on the fly!

Notes:
  • Replace space with a underscore ( _ )
  • Separate tags with a space!
  • This searches based on tags so you will have to be careful with the tags you use. For example 'Kancolle' would be the full series name 'Kantai_Collection'
Examples:
Pictag Long_Hair
Pictag Kantai_Collection Long_Hair
Pictag Yuudachi_(Kantai_Collection)

A quick way to find out when a anime's next episode is airing!

Notes:
  • Be careful with how you're spelling the show!
Examples:
!Airing Shokugeki no Souma
!Airing Boku no Hero
!Airing Nanatsu

Find out the artist, charaters and series the image is based off!

Notes:
  • Has a cooldown of 2 minutes per use.
  • This command will take awhile to respond.
Examples:
<Your Image Embed> Source
[In reply of a Tweet] @AcePictureBot source
<Your Image Uploaded to Discord> Source

Discord Commands


Prefix: !apb <command> [options]
By default you can use these commands on Discord anywhere the bot has permissions to read messages.

To view your current settings you can simple use !apb settings

Settings Prefix is: !apb settings

Active / Respond

!apb settings active

This will turn off the bot in your server but keep it in. You can still use !apb commands and re-activate the bot at anytime.


Media (Images and Videos)

!apb settings media

This will toggle the bot posting media links (images and videos) included in results.


Comamnd Prefix

!apb settings prefix your_prefix_here

If enabled, users will have to use your defined prefix to trigger commands (doesn't include !apb commands). To remove your custom prefix use !apb settings prefix without any arguments.

Examples: !apb settings prefix !

Will force users to have to use !waifu.


Mention (Prefix)

!apb settings mention

If enabled, users will have to @Mention (@AcePictureBot) the bot for commands to trigger (doesn't include !apb commands).


NSFW Media

!apb settings nsfw

Allow NSFW media to be posted (will only follow this rule if the current channel it is posting in has the NSFW settings on.)


Patreon

!apb settings patreon

Disable the "This is a Patreon command" message.


Blacklist Channels

!apb settings blacklist #ChannelName #ChannelNameTwo

Blacklist channel(s) for the bot to ignore listening to commands. You can set as many as you want. To un-blacklist a channel use the command again including the #ChannelName.

A more pratical use is creating a 'waifu' channel and using !apb settings whitelist #waifu


Whitelist Channels

!apb settings whitelist #ChannelName #ChannelNameTwo

Whitelist channel(s).

The bot will only listen to whitelist channels if you have one or more set. To un-whitelist a channel use the command again including the #ChannelName.

Examples:
!apb settings

Show a full list of available achievements you can earn!

Notes:
  • Rate Limit: 1 use, per 120 seconds, per user.
  • Use the interactive emoji reaction system to change pages.
Examples:
!apb achievements

A usable everywhere version of the normal '!airing' command, with support for a full list of shows airing in the next 24 hours.

Optional:
  • Don't include [options] for a list of shows airing in the next 24 hours.
Notes:
  • Rate Limit: 1 use, per 60 seconds, per user.
  • Use the interactive emoji reaction system to change pages.
Examples:
!apb airing
!apb airing Boku no Hero
!apb airing today
!apb airing Date a Live

AYAYA!

Notes:
  • Rate Limit: 1 use, per 360 seconds, per user.
Examples:
!apb ayaya

Use AcePictureBot on Discord to its fullest with our range of interactive Discord games.

Permissions to post messages and embed links are required.

See the full list of Discord games !apb games

Game List:


Anime Music Guessing Game

Permissions for the bot to join and listen to a voice channel are required.

Listen along with friends and try to guess the Anime from one of the 500+ different songs!

Make sure you're in a voice channel before starting!

To play: !apb games music

Customizable Settings:

  • rounds
    • Set the max number of rounds to play.
    • Default: 3
    • Minimum: 1
    • Maximum: (Normal) 3, (Patreons) 6
    • Examples:
      • rounds=4
      • rounds=6
      • rounds=1
  • years
    • Select the year (or year range) of Anime.
    • Default: 2015-[Current Year]
    • Minimum: 2005
    • Maximum: [Current Year]
    • Examples:
      • years=2005-2006
      • years=2010
      • years=2012-2016
  • difficulty
    • Change the difficulty of what you must guess.
    • Default: 1
    • 1: Easy - Guess the Anime name.
    • 2: Medium - Guess the Anime name and if OP or ED.
    • 3: Hard - Guess the Anime name, if OP or ED and OP/ED Number.
    • 4: Very Hard - Guess the Song name.
    • Examples:
      • difficulty=1
      • diff=3
      • difficulty_rating=2
  • types
    • Set only Openings or Endings to be played.
    • Default: None (Both)
    • Options:
      • OP
        • Openings only.
      • ED
        • Endings only.
    • Examples:
      • types=opening
      • types=endings
      • type_only=op
      • types=ed
  • search
    • Search for specific Anime to listen/challange to.
    • Only Patreons can search, become one now!
    • List as many Anime as you want by separating with ', ' (see examples)
    • Default: None
    • Examples:
      • search=Love Live!
      • search=Bakuman, Gintama
      • series=Naruto
      • search=Shingeki no Kyojin, Yahari Ore no Seishun
      • series_only=Kiseijuu, Log Horizon

More Examples:

  • !apb games music rounds=4 years=2015-2018 diff=2
  • !apb games music rounds=1 years=2010 types=OP
  • !apb games music years=2010-2015 search=Love Live!, Shingeki no Kyojin
  • !apb games music rounds=6 types=ED diff=4
  • !apb games music rounds=2 years=2011-2013 types=OP search=Bakuman

Anime Character Guessing Game

Try and guess the Anime series the image of the chracter is from!

To play: !apb games picture

Customizable Settings:

  • rounds
    • Set the max number of rounds to play.
    • Default: 3
    • Minimum: 1
    • Maximum: (Normal) 3, (Patreons) 6
    • Examples:
      • rounds=4
      • rounds=6
      • rounds=1
  • difficulty
    • Change the difficulty of what you must guess.
    • Default: 1
    • 1: Easy - Guess the Anime name.
    • 2: Medium - Guess the Character name.
    • 3: Hard - Guess the Anime name and Character name.
    • Examples:
      • difficulty=1
      • diff=3
      • difficulty_rating=2
  • lists
    • Set only Waifus or Husbandos.
    • Default: Waifu
    • Options:
      • Waifu
      • Husbando
    • Examples:
      • lists=husbando
      • types=both
  • search
    • Search for specific Anime to listen/challange to.
    • Only Patreons can search, become one now!
    • List as many Anime as you want by separating with ', ' (see examples)
    • Default: None
    • Examples:
      • search=Love Live!
      • search=Bakuman, Gintama
      • series=Naruto
      • search=Shingeki no Kyojin, Yahari Ore no Seishun
      • series_only=Kiseijuu, Log Horizon

More Examples:

  • !apb games picture rounds=4
  • !apb games picture rounds=1 lists=husbando
  • !apb games picture search=Love Live!, Shingeki no Kyojin
Notes:
  • Rate Limit: 1 use, per 360 seconds, per user.
Examples:
!apb games
!apb games music

See the top users in the server, or try using '!apb leaderboard global' to see where the top in the world!

Optional:
  • Add 'global' on the end to see the global leaderboard.
  • Try adding 'season' to see where you stand in the current season.
Notes:
  • Rate Limit: 2 use, per 120 seconds, per server.
Examples:
!apb leaderboard
!apb top
!apb top global
!apb leaderboard season

Using AniList you can get a snippet of information from the anime or manga you want to search. This will also include the next episode airing soon (if possible).

Notes:
  • Rate Limit: 1 use, per 10 seconds, per user.
Examples:
!apb anime One Punch Man 2
!apb manga JoJo
!apb anime Slime
!apb manga Attack on Titan

View your own customizable profile image!

Optional:
  • View a plain text version using '!apb profile plain'.
  • See other people's profile card by @mention them!
Notes:
  • Rate Limit: 2 use, per 120 seconds, per user.
Examples:
!apb profile
!apb profile plain

Subscribe to Ace Picture Bots and watch as they post themed media as seen on Twitter!

Servers are limited to only 4 subscriptions at once.

Patreon Gold users can use their Patreon Server gift to allow unlimited subscriptions.


You must have 'Manage Roles' permissions to subscribe and unsubscribe.

To see what bots are currently subscribed in the server, use: !apb settings or !apb subscribe

For a list of current bots you can subscribe to, use: !apb subscribe

Subscribe to a bot by simply using: !apb subscribe [Bot Name]

Unsubscribe using: !apb unsubscribe [Bot Name]

You can save time by using just !apb sub and !apb unsub.

Optional: Set a channel at the end of the message to subscribe the bot there.

Examples:

  • !apb subscribe AceYuriBot
  • !apb sub AcePictureBot
  • !apb sub AceCatgirlBot #pictures
  • !apb unsubscribe AcePictureBot
  • !apb unsub AceYuriBot

Current List of Ace Bots:

  • AcePictureBot: [SFW] [45 mins] Anime themed media.
  • AceYuriBot: [SFW] [30 mins] Anime Yuri themed media.
  • AceYaoiBot: [SFW] [30 mins] Anime Yaoi themed media.
  • AceCatgirlBot: [SFW] [45 mins] Anime Kemonomimi themed media.
  • AceAsianBot: [SFW] [60 mins] Asian model themed media.
  • AceAnimatedBot: [SFW] [60 mins] Animated Anime themed media.
  • AceWallpaperBot: [SFW] [60 mins] Anime wallpaper themed media. Every image has a width of 1280 or larger.
  • AceEcchiBot: [NSFW] [60 mins] Anime themed filted media.

NSFW bots will only post in channels set to NSFW.

Make sure to check back as more bots to come over time!

Notes:
  • Rate Limit: 2 use, per 60 seconds, per user.
Examples:
!apb subscribe
!apb subscribe AcePictureBot
!apb sub AceYuriBot
!apb unsub AceYuriBot
!apb sub AceYaoiBot #channel-name

Show you a basic help message along with a DM'd message for even more infomation.

Examples:
!apb help

Easy command to help you give your IDs to staff. These are retrieved: User ID, Server ID, Channel ID and connected account IDs (Privately DM'd).

Examples:
!apb debug

Show some infomation about the bot including links.

Examples:
!apb info

Gives you a link to use to invite the bot to your own server.

Examples:
!apb invite
!apb join

Twitch Commands


Prefix: !apb <command> [options]
By default you can use these commands in your Twitch channel as the Streamer or as a Mod (some can be done by anyone).

To view your current settings you can simple use !apb settings

Channel moderators can edit this settings too.

Active / Respond

!apb active

This will turn off the bot in your channel but keep it in. You can still use !apb commands and re-activate the bot at anytime.


Media (Images and Videos)

!apb media

This will toggle the bot posting media links (images and videos) included in results.


Mention (Prefix)

!apb mention

If enabled, users will have to @Mention (@AcePictureBot) the bot for commands to trigger (doesn't include !apb commands).

Examples:
!apb settings

Show you a basic help message along with a DM'd message for even more infomation.

Examples:
!apb help

The bot will join your Twitch chat.

Examples:
!apb join

The bot will leave your Twitch chat.

Notes:
  • Must be owner of the channel.
Examples:
!apb leave