Hu Tao is a Genshin Impact discord bot, mainly focused on utility by supporting fuzzy search on most commands. The bot offers features like showing guides/routes for specialties/enemy drops, calculating rate to get a certain constellation within a certain amount of pulls and searching previous event wishes for certain 4* (or 5*) characters/weapons.

## Commands
The bot command prefix is `ht!`. Help for a specific command can be retrieved via `ht!help <command>`. The bot also supports slash-commands. Syntax for these commands might be slightly different due to limitations of Discord, you can see the usage for those commands by typing `/` in a chat with the bot. For example typing `/char` will show the commands that start with `char` like [this](https://i.imgur.com/vEf0IGD.png).

Every reply to commands will include an ❌ delete button, users can click this button to remove the bot post. This allows users to clean up in case something wasn't relevant to the conversation/reduce spam.

To improve usability, most commands that search stuff are fuzzy search. This means you can make a typo, or shorten the heck out of their names. (As of time of writing, `glad` matches `Gladiator's Finale`, `CW` matches `Crimson Witch of Flames`, `amus` matches `Amos' Bow`)

### Characters
- `ht!character`: Displays [a list of all characters](https://i.imgur.com/TdUS701.png). 
    - This command supports filtering such as element type (like `ht!c -pyro`), weapon type (like `ht!c -polearm`) and/or stars (like `ht!c -5*`). [Example](https://i.imgur.com/OB6Fhz0.png)
- `ht!character <name>`: Displays character information, such as [basic data](https://i.imgur.com/mtKqXOR.png) / [meta data](https://i.imgur.com/pyXZDs9.png) / [ascensions + stats](https://i.imgur.com/COQQwbZ.png) / [talent costs](https://i.imgur.com/9FKcdom.png) / [talents](https://i.imgur.com/nJjAbhQ.png) / [passives](https://i.imgur.com/dFZ70km.png) / [constellations](https://i.imgur.com/GiXH0N8.png) / [art](https://i.imgur.com/DwcdR4R.png).
    - See links for examples, buttons will correspond to directly skipping to that section. These can also be triggered directly via the command like `ht!c Hu Tao -art`.
    - Search is fuzzy, meaning `ht!c HT` *should* match Hu Tao as long as there's no other character being introduced that becomes a closer match.

See `ht!help character` for more information.

- `ht!charstats <name> [level] A[ascension]`: Displays character stats at a certain level/ascension.
    - Without giving level/ascension: `ht!cs Hu Tao` [picture](https://i.imgur.com/KCYR046.png) 
    - With level: `ht!cs Hu Tao 80` [picture](https://i.imgur.com/1USGQSo.png)
    - With ascension: `ht!cs Hu Tao A6` [picture](https://i.imgur.com/Xc5EOnC.png)
    - Search is also fuzzy, just like `ht!character`.
- `ht!charlevel <current level> [current level experience] [target level]`: Display experience (also in terms of experience books and 1★ weapons with minimal XP needed to farm) and mora required to *level* to a target level. [Examples](https://i.imgur.com/Ui57Cad.png).
    - If no current experience is specified, 0 will be assumed.
    - If target level is not specified, both next ascension and max level (currently lv. 90) will be shown.
- `ht!books`: Displays a list of [Talent Book availability per day](https://i.imgur.com/89Ag7N3.png)

### Weapons
- `ht!weapon`: Displays [a list of all weapons](https://i.imgur.com/HbQwOYV.png).
    - This command supports filtering such as weapon type (like `ht!w -polearm`) and/or stars (like `ht!w -5*`). [Example](https://i.imgur.com/1YFGmFf.png)
- `ht!weapon <name>`: Displays weapon information, such as [basic info](https://i.imgur.com/MF5GMtM.png) / [ascension cost and stats](https://i.imgur.com/xYDJPh1.png) / [refinements](https://i.imgur.com/ALTnNWg.png) / [lore](https://i.imgur.com/vLl4YfX.png) / [normal art](https://i.imgur.com/QBsKotI.png) / [2nd ascension art](https://i.imgur.com/iREPS5n.png).
    - See links for examples, just as with `ht!character`, buttons will correspond to directly skipping to that section. These can also be triggered directly via the command like `ht!w Staff of Homa -art`.

See `ht!help weapon` for more information.
- `ht!weaponstats <name> [level] A[ascension]`: Displays [weapon stats at a certain level/ascension](https://i.imgur.com/g8ZBKmD.png).
    - This command is very similar to `ht!charstats`, see that command for more information.
- `ht!weaponlevel <star> <current level> [current level experience] [target level]`: Display experience (also in terms of enhancement ores with minimal XP loss) and mora required to *level* to a target level. [Examples](https://i.imgur.com/kWUMMr5.png).
- `ht!weaponmats`: Displays a list of [Weapon Ascension Materials availability per day](https://i.imgur.com/IWQFfU0.png)

### Artifacts
- `ht!artifact`: Displays [a list of all artifact sets](https://i.imgur.com/zBrbFET.png).
- `ht!artifact <name>`: Displays artifact [set details](https://i.imgur.com/bnqPEA7.png) and [specific items in the set](https://i.imgur.com/8bRmk9K.png)
- `ht!artifact-levels <main stat> [stars]`: Displays [scaling of a main stat](https://i.imgur.com/vWxcaNA.png). Stars defaults to `5`, stat search is also fuzzy.

### News
- `ht!news [lang]`: Displays [most recently posted news articles on the forum](https://i.imgur.com/PFAuOJQ.png)
- `ht!news <id> [lang]`: Displays [a news article](https://i.imgur.com/mEqXMyg.png), these most likely [have multiple pages](https://i.imgur.com/fxO8LZv.png).
- `ht!follow <list|add|remove> [type]`: [Add](https://i.imgur.com/PIXyiT5.png) or remove a certain events from the following list in the current channel (official forum posts and the twitter accounts, please refer to `ht!help follow` for an up to date list of supported languages). Or a [list](https://i.imgur.com/OhvclGx.png) of what the bot is following in your server.
    - Example of [forum news feed](https://i.imgur.com/0VfS4xp.png), [twitter feed](https://i.imgur.com/HnmV65Y.png) and [events](https://i.imgur.com/IYdeSsT.png).
- `ht!events`: Check up on current and upcoming events. Examples: [list](https://i.imgur.com/or1L70I.png), going to the left shows [current ones](https://i.imgur.com/vGljfsK.png) while to the right are [future ones](https://i.imgur.com/ylCSvUA.png). Start/end/reminders for these can be followed with `ht!follow add events`.

### Misc
- `ht!guide [name]`: View some guides/routes. Use it without any name to get a [list of available guides](https://i.imgur.com/IJhMuku.png) or [search for a particular guide](https://i.imgur.com/OCIce0p.png). Also supports [autocomplete](https://i.imgur.com/p41r2ia.png) when using the slash command.
- `ht!gachacalc <pulls> [pity] [guaranteed]`: Calculate chance to get a certain amount of constellations of a banner character in a certain amount of pulls. [Example](https://i.imgur.com/mmsAm8i.png).
    - Initially used rates from wish databases, updated to fit current theory. For more information about the rates used, see [Statistical model for Genshin Impact's droprates](https://www.hoyolab.com/article/497840)
- `ht!banners`: View current/past event wishes
    - `ht!banners banners list [weapon|char]`: Quickly list all [weapon](https://i.imgur.com/3VIBr3S.png), [character](https://i.imgur.com/EhAUqPG.png) or [both](https://i.imgur.com/jTu8Ogr.png) event wishes
    - `ht!banners search <character or weapon name>`: Search for event wishes containing a specific [weapon](https://i.imgur.com/toCVPs8.png)/[character](https://i.imgur.com/7BYSQSG.png)
    - `ht!banners browse [id / page]`: View [more information about a specific or browse through them](https://i.imgur.com/yHvkhsC.png)
- `ht!reminders`: List your current reminders. [Example of list](https://i.imgur.com/ROCPehX.png) - [Example of a reminder](https://i.imgur.com/i0AgETk.png)
- `ht!addreminder <name> in <duration>`: [Adds a reminder](https://i.imgur.com/y6OOADd.png)
    - Sometimes, the duration can be derived from the name. For example, running `ht!ar Parametric` will create a reminder about the Parametric Transformer in 6 days and 22 hours (reset time for that gadget). `ht!ar Ores` will create one in 3 days and `ht!ar Liyue Specialties` creates one for in 2 days.
    - `<duration>` needs to be something like `<amount> <unit>`, joined by pretty much anything spaces/commas/"and"/etc. Units can be abbreviated (`m` works for minutes, `d` for days, etc). Also supports `resin` as a unit of time. For example: `ht!ar Elite Boss in 36 resin`
- `ht!delreminder <id>`: [Deletes a reminder](https://i.imgur.com/1JYj86z.png)
- `ht!time`: Check [current server times](https://i.imgur.com/CKSe9XT.png) as well as time until next daily/weekly reset.
- `ht!resin <current resin> [time until next resin in mm:ss]`: Check how long until your resin refills.
    - Example with just amount: `ht!resin 13` [picture](https://i.imgur.com/JBLeDUa.png)
    - Example with time until next resin: `ht!resin 77 7:15` [picture](https://i.imgur.com/kPRQfEb.png)
- `ht!abyss [cycle: yyyy-mm-1/yyyy-mm-2] [floor]`: Displays current [abyss buff](https://i.imgur.com/9EQSPB3.png) and [floors](https://i.imgur.com/VeXEvSr.png).
    - When a floor is provided, the embed will either just list that floor (for Corridor floors) or skip to it in the embed (for Moon Spire floors).
    - Old floors/buffs can be accessed by providing the cycle, like: `ht!abyss 2020-11-2`

## Required Permissions
Please make sure the bot has these permissions inside the channels you want to use the bot. 
- **Send/Receive Messages**: Needed to actually receive and respond to commands.
- **Attach Files** / **Embed Links**: Used to send embeds, as well as display forum posts.
- **Use External Emoji**: Used in character/weapon menu to indicate mora/items/element/weapon type/...

**TIP**: You can check if these permissions are given with `ht!help`. In case one is missing, it'll be shown in a bold **NOTE** at the end of the message.



HuTao

Hu Tao is a Genshin Impact discord bot, mainly focused on utility and user experience

Voter pour HuTao

Tu veux nous soutenir ?