Skip to content
dashwav edited this page Jul 24, 2017 · 13 revisions

Welcome!

What does the bot do?

Whether you're recommending someone watch Boku no Pico, participating in waifu wars or discussing the best bathing scenes of the season, it's useful to be able to link an anime or manga series without having to head across to MAL, search for it and hyperlink it. Discordoragi takes away some of the pain - when you call it using a specific tag, it'll look up your request for you and post details like links to MAL/Hummingbird/Anilist, descriptions and the airtime of the next episode (if the series is still airing).

How do I use it?

You can call the bot by using specific tags on one of the active servers. Anime can be called using {curly braces} and manga can be called using and light novels can be called using reverse square brace ]light novels[ (e.g. {Nisekoi} or or ]Utsuro no Hako to Zero no Maria[). {Single} ]will[ give you a normal set of information while {{double}} <> ]]will[[ give you expanded information. Examples of these requests can be found here

But wait, there's more! There's a special request you can make which gives you a bunch of really cool statistics, including things like the total number of requests made, the top requesters on the subreddit in question and the standard deviation for all request (well, I think the stats are cool at any rate...). To make a stats request, just use any of the braces and the string "!stats" (e.g. {{!stats}} or <!stats>).

Depending on load this takes around 3-10 seconds to reply back to you.

As a summary:

  • {animename} will make a normal request for an anime series
  • {{animename}} will make an expanded request for an anime series
  • will make a normal request for an manga series
  • <> will make an expanded request for an manga series
  • ]lightnovel[ will make a normal request for a light novel series
  • ]]lightnovel[[ will make an expanded request for a light novel series
  • Any set of braces + !stats will give you a post that has a bunch of cool statistics in it (you can also mention a user to get stats for that specific user)
  • Any set of braces + !sstats will give you a post that has a bunch of cool statistics for the specific server
  • Any set of braces + !help will give out info on how to use the bot

Based on the amount of clutter Roboragi will generate, the size of its reply will scale as well:

  • Having more than one expanded request in a post will turn them all into normal requests.

Server Admin Commands

So far there is only one <!command toggleExpanded> which will allow you to either have expanded requests allowed, or disallow them (so that discordoragi doesn't fill up the entire chat with one or two messages) default is allowed.

Synonyms

Roboragi also has an internal set of synonyms for various shows which redirects requests to the correct place (and they're occasionally used for a laugh). These are listed here.

There are also a number of "official" synonyms which are supported by the databases and not manually created (e.g. Oreimo, Danmachi). A list of these can be found here, although it's difficult to list everything.

What are the known issues?

  • Things with multiple adaptations or seasons can be hard to find (only god knows which adaptation of Jojo's Bizarre Adventure you're going to get).
  • Shows that have multiple seasons with strange naming conventions act strangely due to the way the different anime database search engines work. Working'!!, for example, is found fine by Anilist, but not by MAL and Hummingbird.
  • Sometimes the descriptions given to me by MAL's manga results will include crazy HTML tags, which have been known to cause some strange behaviour.
  • Anilist's API may have some trouble with unicode like ½ and v. 99% of the time it's fine.

Where can I report issues/suggest features I'd like to see?

Right here. Please use an appropriate tag. You can also come into the discordoragi discord for troubleshooting or any questions you have. There is a channel for testing the bot out as well to see if you would want it on your server.

MAL/Hummingbird/Anilist are shit, why don't you have X?

The sites I've included all have reasonably easy to use APIs, which make it easy for me to collect and process their data (MAL's XML can jump off a cliff though). If there's enough demand for a specific site (and there's a reasonably quick/easy way to get the data) I'm happy to add it. Make a suggestion over here.

How does it work?

/u/Roboragi is constantly looking through a stream of messages on the server. Once it detects that you've {called it} (or ), it takes what you've put between the brackets and uses it to search various anime databases for your request. Assuming it finds something, it collates that data into a comment, adds the comment to its "already done" pile, tracks the requests it's fulfilled (along with the requester, the subreddit it was in etc.) and creates a comment - all within about 4 seconds.

Where can I use it?

Coming Soon™

Who made it?

The original reddit bot was created by Nihilate, then jwolff52 ported it to discord, I (dashwav) have since picked up more active development on it and have brought it up to modern discord bot standards.

How was it made?

/u/Roboragi is currently written in Python, using discord.py to connect to Discord. It uses PostgreSQL for its database needs and utilises APIs from MAL, Hummingbird and Anilist. It's being hosted on a Raspberry Pi 3 that's sitting above my desk.