<h1 align="center">
  <img src="https://i.imgur.com/TAWr46v.png" style="width : 150px; height : auto;" />
</h1>

<h1 align="center">Aerial Ace</h1>

<h4 align="center">Aerial Ace is a helper bot for <a href="https://github.com/poketwo/poketwo">Poketwo</a> and <a href="https://play.pokemonshowdown.com/">Showdown</a> which provide various functionalities on top of being a Pokédex.</h4>

<h2 align="center">
  <a href="https://img.shields.io/badge/Status-online-green?style=for-the-badge">
    <img src="https://img.shields.io/badge/Status-online-green?style=for-the-badge" alt="Status" />
  </a>
  <a href="https://img.shields.io/badge/Python-3.10-blue?style=for-the-badge">
    <img src="https://img.shields.io/badge/Python-3.10-blue?style=for-the-badge" alt="Status" />
  </a>
</h2>

<p align="center">
  Aerial Ace is a helper bot for <a href="https://github.com/poketwo/poketwo">Poketwo</a> and <a href="https://play.pokemonshowdown.com/">Showdown</a> which provide various functionalities on top of being a Pokédex.<br><br>
  <b>Prefix</b> : `-aa`<br>
  <b>Website : <a href="https://aerial-ace.github.io/">Aerial Ace</a></b>
</p>
<hr>
<h2 align="center">
  <a href="https://ko-fi.com/T6T3GI6XH">
    <img src="https://ko-fi.com/img/githubbutton_sm.svg" />
  </a>  
  <a href="https://patreon.com/aerial_ace">
    <img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Daerial_ace%26type%3Dpatrons&style=for-the-badge" alt="Support me on Patreon" />
  </a>
</h2>

<hr />

## Features

* View Dex entry of any Pokémon.
* View random Pokémon and read about them.
* Add tags to your name and ping them for anything from favourite collections to shiny hunts.
* View the best stats of Pokémon for battling.
* Gif commands to express yourself via pokemon gifs.
* View the best moveset of any Pokémon for battling.
* View the best nature of any Pokémon for battling.
* View the Pokémon's type weaknesses.
* View pokemon tierlists.
* Register Battles and view leaderboards.
* Rare catch detection System
* Advanced Starboard System that works with/without togglemention.
* Extensive Set of starboard customization commands for project supporters.
* Automatic Catch Streak Detection.
* Generate Random but Balanced teams for random battling.
* Advanced **Smogon Analyser** helpful for Pokemon Showdown Players.

## Resources
***Basic Bot Example*** : [Click Here](https://gist.github.com/EvieePy/d78c061a4798ae81be9825468fe146be)<br>
***Basic Error Handler Example*** : [Click Here](https://gist.github.com/EvieePy/7822af90858ef65012ea500bcecf1612)<br>
***Basic Music Bot Example*** : [Click Here](https://gist.github.com/EvieePy/ab667b74e9758433b3eb806c53a19f34)

## Commands
* `-aa roll <upper limit>` rolls a dice.
* `-aa dex <pokemon name>` displays the Pokédex entry of the provided Pokémon.
* `-aa kill @user` and `-aa hit @user` cz, why not :3
* `-aa rand_poke` displays a random Pokémon from the dex.
* `-aa tag <tag>` tags you to the provided tag.
* `-aa tag_ping <tag>` pings the users currently tagged to the provided tag.
* `-aa tag_show <tag>` shows the users currently tagged to the provided tag.
* `-aa stats <pokemon name>` displays the best stats for the provided Pokémon.
* `-aa moveset <pokemon name>` displays the best moveset of the provided Pokémon.
* `-aa nature <pokemon name>` displays the best nature of the provided Pokémon.
* `-aa hug/kill/hit/cry/tease/dance` sends a pokemon gif related to the command.
* `-aa weakness <pokemon name>` displays the type weaknesses of the provided Pokémon.
* `-aa tierlist <tier type>` displays the tierlist of that type. Available types are `common`, `mega`, `rare`, `water`.
* `-aa log_battle @winner @loser` logs the battle in the leaderboard.
* `-aa battle_score` displays the current battle score the user.
* `-aa battle_lb` displays the battle leaderboard of the server.
* `-aa starboard channel #channel` sets the 'channel' as the starboard channel.
* `-aa starboard rare_text/shiny_text <text>` sets the rare/shiny text for the starboard embed [ Premium Server ]
* `-aa starboard rare_image/shiny_image <link>` sets the rare/shiny image for the starboard embed [ Premium Server ]
* `-aa random_team <tier>` returns a random but balanced team of that tier. Available tier are `common`, `mega`, `rare`.
* `-aa random_matchup <tier>` returns a random but balanced match of two player with roll of that tier. Available tier are `common`, `mega`, `rare`.
* `-aa smogon 8 OU durant` displays the smogon statistics of durant in Gen8OU.

## Commands in action
<div class="row">
  <div class="column">
    <img src="https://user-images.githubusercontent.com/66104268/151558075-81dbcec2-750d-456c-9c8e-46d59012f2e7.png" style="width:44%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151559135-d297b3e4-6e6a-44b9-abaf-5808d887398f.png" style="width:36%; height:auto;"><br>
    <img src="https://user-images.githubusercontent.com/66104268/151561615-923787f7-8717-4ec0-93b2-3dc8a88d03ef.png" style="width:35%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151557782-85298785-5aa4-4e81-bb05-6b84dd53f5fb.png" style="width:45%; height:auto;"><br>
    <img src="https://user-images.githubusercontent.com/66104268/151558501-3e8090ed-76fb-44c0-b03a-e009c0fafb31.png" style="width:33%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151561234-8fe5e3bd-21ca-4bc7-a38b-fe416549cd53.png" style="width:47%; height:auto;"><br>
    <img src="https://user-images.githubusercontent.com/66104268/151564263-0ca946e9-8904-424d-97dd-cd284955860e.png" style="width:38%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151563996-900fd7b2-c612-4021-b123-8ae14883227b.png" style="width:42%; height:auto;"><br>
    <img src="https://user-images.githubusercontent.com/66104268/151565865-58887a3f-8278-48e6-a805-dd0b0886a207.png" style="width:55%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151566097-17e84297-d151-475f-8d32-21d4245302cf.png" style="width:25%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151570575-ee53e174-6a40-4925-8cce-5e005a3960ec.png" style="width:38%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/151570373-3635c15b-c0d8-4bbf-bcf1-7dbe391f5202.png" style="width:42%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/160364627-fdd8c3a6-d8fc-47d3-a0d2-897ef4e5fb04.png" style="width:43%; height:auto;">
    <img src="https://user-images.githubusercontent.com/66104268/160364277-a1d2bb9d-5a47-44aa-a54a-ee0f1f034ea5.png" style="width:36%; height:auto;">
  </div>
</div>


<hr />
<h2 align="center">
  <a href="https://discord.com/api/oauth2/authorize?client_id=908384747393286174&permissions=277025647680&scope=bot%20applications.commands">Invite</a> | <a href="https://top.gg/bot/908384747393286174/vote">Vote</a> | <a href="https://discord.gg/CUvsyarbUC">Support Server</a>
</h2>


Aerial Ace

Aerial Ace is a poketwo helper bot and pokedex. Log battles, view leaderboard, register shinies and more.

التصويت لـAerial Ace

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