<h4 align="center">
    The bot who steals your fishing rods and eats your shrimp fry.
</h4>
<br><br>

Koishi is a multi functional bot stuffed with all the new Discord features.
She got over 100 fun and utility commands to get the people together.

To get started with Koishi, use the `/help` command, which lists all the available global commands.


<h3 align="center">
    What she does?
</h3>

Koishi excels in various areas. She is undoubtable one of the most feared creatures by character limits.
Although here is a "short" description for all of her commands by category:

### Help

- `/accessibility` - Configure your preference.
- `/about` - Shows information about the bot's runtime.
- `/ask` - How to ask.
- `/hello` - Please don't just say "hello".
- `/help` - Lists the commands of the bot, or shows the selected guide (only 1 yet).
    Some commands may have their own `about` sub-command with a more detailed explanation.

### Administration
    
- `/automation` - Setup automations for your guild.
    - `community-message-moderation` - Allow users in your guild to `x` messages.
        When hitting the threshold the bot deleting them.
    - `farewell` - Send farewell messages for leaving users.
    - `log-emoji` - Log emoji creation, modification and deletions.
    - `log-mention` - Log messages that ping users.
    - `log-sticker` - Log sticker creation, modification and deletions.
    - `log-user` - Log joining and leaving users.
    - `reaction-copy` - Allow messages to be copied to other channels using reactions.
    - `reaction-role`- Assign or remove roles from users when they react on selected messages with selected emojis.
    - `touhou-feed` - Send touhou images to specific channels based on configuration.
    - `welcome` - Send welcome messages fot joining users.
- `/clear` - Delete a batch of messages.
- `/dupe-image-filter` - Filter out duplicate assets from your media channels.
- `/invite-create` - Create an invite.
- `/mod` - Mute, kick or ban others.
- `/self-mod` - Mute, kick or ban yourself.

### Anime

- `/anime` - Describe an anime.
- `/character` - Describe a character.
- `/manga` - Describe a manga.
- `/find-anime`- Find an anime.
- `/find-character` - Find a character.
- `/find-manga` - Find a manga.

### Actions

- `/action`, `/bite`, `/blush`, `/bully`, `/cringe`, `/cry`, `/dance`, `/feed`, `/fluff`, `/glomp`, `/handhold`,
    `happy`, `highfive`, `hug`, `kick`, `kiss`, `kon`, `lap-sleep`, `like`, `lick`, `murder`, `nom`, `pat`, `peg`,
    `pocky-kiss`, `poke`, `slap`, `smile`, `smug`, `stare`, `wave`, `wink`, `yeet` (with / for / at) someone.
- `/action` - Wildcard command to invoke any other action with selecting an exact (touhou only) image.

### Fun

- `/9ball` - Ask our all knowing 9ball to share their wisdom.
- `/ascii` - Ascii art your avatar or the guild's icon.
- `/choose` - Chooses one of your given options.
- `/imaginary-friend` - A collection of commands that an imaginary friend would have.
- `/memme` - A curated list of touhou memes.
- `/oj` - Lookup commands related the 100% Orange Juice video game.
- `/paranoia` - Pa-pa-pa-pa-paranoia.
- `/random` - Chooses a random number in the given range.
- `/rate` - Rates someone between 0 and 10.
- `/rolls` - Rolls dices.
- `/sex` - Tells you "no sex".
- `/trivia` - Koishi role trivia.
- `/urban` - Searches the given term in the urban dictionary. Nsfw channel only just in case.
- `/yuno` - Yuki Yuki Yuki.

### Waifus

- `nsfwbooru` - Pulls an image from a booru allowing nsfw tags. Nsfw channel only.
- `safebooru` - Pulls an image from a booru disallowing all nsfw tags.
- `touhou-calendar` - When your touhous are celebrated.
- `touhou-character` - Shows an image of the selected touhou.
- `vocaloid` - Shows a vocaloid image.
- `waifu-sfw` - Shows an image from the waifu.pics website.
- `waifu-nsfw`- Shows an nsfw image from the waifu.pics website. Nsfw channel only.

### Utility

- `/calc` - Does shrimple math for you.
- `/create-activity` - Create a voice channel activity.
- `/color` - Show color info.
- `escape` - Escapes special format expressions in the message's content, allowing you to copy paste the same message.
- `/guild` - Guild info, icon, etc.
- `/id` - Shows the identifier of the selected entity.
- `/message-me` - Sends a direct message.
- `/ping` - Shows the bot's latency to the servers.
- `/rawr` - Rawrs back.
- `/role-info` - Role info.
- `/roles` - Batch role info.
- `snipe`, `/snipe` - Snipe emojis and stickers to get their detail description or to manage them.
- `style-text`, `/style-text` - Style text using discord's "ansi" highlights.
- `/user` - Show various information about your user. This includes many things generated through or by koishi.

### Economy

- `/adventure` - Depart to adventures to collect items for completing quests.
- `/daily` - Claim your daily hearts and your beloveds' one.
- `/gift` - Gift hearts to your beloved ones.
- `/shop` - Spend your hearts.
- `/top-list` - The horde of heart hoarders. Do not be like them.
- `/user hearts` - Check your streak and heart count.

### Relationships

- `/love` - Check the love affinity between people.
- `/proposal` - Propose to users in various ways using your hearts.
- `/relationships` - Manage your existing relationships.

### Games

- `/21` - A more balanced version of blackjack not favoring the dealer.
    Allows you to gamble your hearts against the bot or against other users.
- `/coin-flip` - Gamble your hearts and flip the coin of fate.
- `/ds` - Help your touhous doing their chores, by solving puzzles.
    And get awarded with hearts after your great achievements.
- `/kanako` - A hiragana / katakana puzzle game.
- `/lucky-spin` - Gamble and spin the wheel of fortune.
- `/minesweeper` - Find all tiles without landmines.
- `/xox`- Play tic-tac-toe against the bot or others.

<h3 align="center">
    FAQ
</h3>

##### Cannot invite Koishi, she is at 100 / 100 guilds

Koishi will likely never be verified making the 100 guild limit stay.
Since there is a popular demand on theming Koishi bot, we may offer other bots as an alternative
(Like Flandre for example).

##### Prefix

Koishi has no old-style chat commands. Only slash (*and other application commands*)!

##### Not in member list, but her commands are present

This can happen if Koishi has no view-channel permission, but you have use-application-commands.

Since Koishi is added without any permissions, make sure to assign a role to her, **else she will stay invisible and
be forgotten by everyone. That will make her sad.**

*Koishi so meta!*

##### Commands do not show up

- Koishi was invited without `applications.commands` scope.
- You have no `use-application-commands` permission.
- The guild has 50+ bots.
- Discord client is derping, give it a restart.

<h1></h1>

<h3 align="center">
    Contribution
</h3>

Koishi is constantly evolving by reading people's collective subconscious.
If you experience any bugs, or have great ideas to improve Koishi, please share them in our
[support guild](https://discord.gg/3cH2r5d). 

If you know coding you may contribute by forking the repo and creating a pull request.
If you do not, you may still open an [issue](https://github.com/HuyaneMatsu/Koishi/issues) with all your crazy ideas!
In case your issue appear to be stale, it was not forgotten,
just went on a list of never ending amazing features to be added. 

<h1 align="center">
    <3
</h1>

Koishi

The bot who steals your fishing rods and eats your shrimp fry.

Votando em Koishi

Quer nos ajudar?