# Ani-Bot
A Discord bot for searching anime, user scores/progress, and managing watch-parties. Ani-Bot queries data from AniList's GraphQL API, and is written entirely in JavaScript, using the newest features available in the Discord.js library.

Check the bottom of this description to learn more about the commands and setup.

### Watch-parties
The main feature of Ani-Bot is the creation of watch-parties. The first step is *suggesting* an anime for your group of friends to watch together (`/wp suggest <anime title>`). Any member of the server may choose to partake, either by reacting to a prompt, or by using `/wp join`. The watchparty command can then be used to check the progress of all members on the anime.
#### Threads
Discord.js v13 adds support for the new threads feature. A user can now set the assigned episodes for the watchparty using `/ep next <# of episodes>`, and a discussion thread will be automatically generated for those episodes - and don't worry, the thread starter message that peeks at the thread's messages is auto-erased to avoid spoilers! The previous discussion thread (if there is one) is automatically archived after setting new episodes.

# Getting Started!

Ani-Bot currently uses application ("slash") commands. This makes it so each and every command - and subcommand - has its own description and usage information, all shown right when you type '/'.

<img src="https://i.imgur.com/zTt6gyb.gif" alt="slash-commands gif" width="300" height="200" />

Most of Ani-Bot's commands are very straightforward and require little to no setup.

## Watch-Party setup:

Watch-parties, the bot's way of managing anime group viewings, do require some easy setup. Ani-Bot is however loaded with many easy to understand misusage responses, guiding each user to proper setup without even reading this file!

<img src="https://i.imgur.com/3Yj9OJf.gif" alt="wp suggest gif" width="400" height="200" />

The first step is to alias yourself to an AniList user - the bot won't know your AniList information until you link yourself! This alias makes commands like `/url`, `/progress`, and `/rating` all work with much more ease; instead of needing to remember one's AniList username each time you wish to check their url, anime progress or ratings, you can just mention their Discord name! In addition, of course, aliases enable use of the watch-parties. 

Once you and your friends have been aliased to AniList users, you can go ahead and suggest an anime with `/wp suggest`. This will return an embed and a 'Join' button (active for 60 minutes following the message). Click the button, and you'll be added to the party! If you miss the button window, a similar action can be done through `/wp join`, which returns a dropdown list of all currently suggested anime. 

Once an anime has been suggested, and you and your friends are ready to start watching, use `/wp set` to access a dropdown list of suggested anime, and just click one to set it. You're all done! Using `/wp view` will now return the progress of you and other members of that watch-party.

### /ep and Discussion Threads

To get even more out of your watch-parties, you can assign episodes to watch for the day/week. Using `/ep next` will allow you to choose the amount of episodes to assign, and will instantly generate a discussion thread. The next time you use the command, the old discussion thread will be archived and a new one will be generated!

Ani-Bot

An AniList bot that can search for anime, check friends ratings/progress, and even manage watch-parties by querying AniList's API.

التصويت لـAni-Bot

هل ترغب في دعمنا؟