Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/seriaati/hoyo-buddy

A feature-rich, easy to use, beautifully designed Discord bot made for Hoyoverse gamers
https://github.com/seriaati/hoyo-buddy

discord-bot discord-py genshin-impact honkai-star-rail hoyolab-api hoyolab-auto-checkin hoyoverse miyoushe

Last synced: 22 days ago
JSON representation

A feature-rich, easy to use, beautifully designed Discord bot made for Hoyoverse gamers

Host: GitHub
URL: https://github.com/seriaati/hoyo-buddy
Owner: seriaati
License: gpl-3.0
Created: 2023-10-13T09:45:52.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-10-29T13:06:50.000Z (2 months ago)
Last Synced: 2024-10-29T13:35:42.579Z (2 months ago)
Topics: discord-bot, discord-py, genshin-impact, honkai-star-rail, hoyolab-api, hoyolab-auto-checkin, hoyoverse, miyoushe
Language: Python
Homepage: https://hb.seria.moe
Size: 65.6 MB
Stars: 49
Watchers: 3
Forks: 1
Open Issues: 5
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # Hoyo Buddy

![Hoyo Buddy](https://iili.io/J1JqMSR.png)  

![GitHub issues](https://img.shields.io/github/issues/seriaati/hoyo-buddy)

![GitHub pull requests](https://img.shields.io/github/issues-pr/seriaati/hoyo-buddy)

![GitHub Repo stars](https://img.shields.io/github/stars/seriaati/hoyo-buddy?style=flat)

![GitHub forks](https://img.shields.io/github/forks/seriaati/hoyo-buddy?style=flat)

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/seriaati/hoyo-buddy)

![Lines of code](https://tokei.rs/b1/github/seriaati/hoyo-buddy?style=flat)

![Commit activity](https://img.shields.io/github/commit-activity/w/seriaati/hoyo-buddy/main)

![GitHub](https://img.shields.io/github/license/seriaati/hoyo-buddy)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Hoyo Buddy is a feature rich, easy to use, and beautifully designed Discord bot made for Hoyoverse gamers. It is developed under the [user app](https://support.discord.com/hc/en-us/articles/21334461140375-Using-Apps-on-Discord) standard, so you can use it without inviting it into any Discord servers, and can use it anywhere you want.  

  

- [Try it Out](https://link.seria.moe/hb-start)

- [Official Website](https://hb.seria.moe/)

- [Is Hoyo Buddy Safe?](https://github.com/seriaati/hoyo-buddy/wiki/Account-Security)

- [Why Hoyo Buddy?](https://github.com/seriaati/hoyo-buddy/wiki/Why-Hoyo-Buddy%3F)

- [Frequently Asked Questions]()

- [Discord Server](https://link.seria.moe/hb-dc)

## Quick Introduction

| | |

|:-------------------------:|:-------------------------:|

|![Create beautiful character cards](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-2.png?raw=true)  |  ![Make your life easier](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-3.png?raw=true)|

|![Information at your fingertips](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-4.png?raw=true)  |  ![Beauty blends with functionality](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-5.png?raw=true)|

## Features

Hoyo Buddy integrates features from all Hoyoverse games, supporting both HoYoLAB and Miyoushe.

| Command | Description | Genshin Impact | Honkai: Star Rail | Zenless Zone Zero | Honkai Impact 3rd | Tears of Themis |

|---|---|---|---|---|---|---|

| /profile | Generate character build cards and team cards. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /notes | View real-time notes and set reminders. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /redeem | Automatic and manual gift code redemption. | ✅ | ✅ | ✅ | ❌ | ✅ |

| /check-in | Automatic HoYoLAB/Miyoushe daily reward check-in. | ✅ | ✅ | ✅ | ✅ | ✅ |

| /characters | View and filter all owned characters.  | ✅ | ✅ | ✅ | ✅ | ❌ |

| /challenge | View statistics/overview of end-game content. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /stats | View account statistics.  | ✅ | ✅ | ✅ | ✅ | ❌ |

| /search | Search anything game-related, including unreleased content. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /gacha-log | Import, view, and analyze your gacha records. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /events | View on-going in-game events and banners. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /exploration | View area exploration statistics. | ✅ | ❌ | ❌ | ❌ | ❌ |

| /lb view | View leaderboards. | ✅ | ✅ | ✅ | ❌ | ❌ |

| /lb akasha | View character damage leaderboard. | ✅ | ❌ | ❌ | ❌ | ❌ |

| /farm reminder | Set reminders for farming materials for a character/weapon. | ✅ | ❌ | ❌ | ❌ | ❌ |

| /farm view | View farmable domain materials in different weekdays. | ✅ | ❌ | ❌ | ❌ | ❌ |

## Goal

The community has been missing a Discord bot that provides support for all Hoyoverse games, and Hoyo Buddy is here to change that. We try to create **ONE** bot that can do **EVERYTHING** for all Hoyoverse games, with beautfiul designs and intuitive interfaces, all for free. Hoyo Buddy is currently the only Discord bot that provides multi-game, multi-account, and multi-language support. For more details, read this [article](https://github.com/seriaati/hoyo-buddy/wiki/Why-Hoyo-Buddy%3F).

## Contributing

I'm a passionate developer that loves to create open source and high quality software :)  

Wanna join us? We're looking for Python programmers, translators, and designers; join our [Discord server](https://link.seria.moe/hb-dc) to contact us.  

You can read the [Contribution Guidelines](https://github.com/seriaati/hoyo-buddy/blob/main/CONTRIBUTING.md) for more info.

## Powered By

Other projects made by me that are used in Hoyo Buddy

- [ambr.py](https://github.com/seriaati/ambr): API wrapper for [Project Amber](https://gi.yatta.moe), used to obtain Genshin Impact game data.

- [yatta.py](https://github.com/seriaati/yatta): API wrapper for [Project Yatta](https://sr.yatta.moe), used to obtain HSR game data.

- [hakushin.py](https://github.com/seriaati/hakushin-py): API wrapper for [hakush.in](https://hakush.in), used to obtain Genshin Impact, HSR, and ZZZ game data.

- [akasha.py](https://github.com/seriaati/akasha-py): API wrapper for [Akasha System](https://akasha.cv), used in the character damage leaderboard feature.

- [enka.py](https://github.com/seriaati/enka-py): API wrapper for [Enka Network](https://enka.network), used to obtain Genshin Impact and Honkai Star Rail player showcase data.

- [enka-card-api](https://github.com/seriaati/enka-card-api): API to generate 3rd party template cards.

- [genshin.py](https://github.com/thesadru/genshin.py) (contributor): API wrapper for HoYoLAB and Miyoushe.

- [hoyo-codes](https://github.com/seriaati/hoyo-codes): API to get gift codes for all Hoyoverse games, used in the automatic code redemption feature.

- [daily-checkin-api](https://github.com/seriaati/daily_checkin_api) (private): API to perform daily check-in, used in the automatic daily check-in feature.

- [hoyo-buddy-assets](https://github.com/seriaati/hoyo-buddy-assets) (private): Hoyo Buddy assets, used in image generation features.

- [ZenlessAssetScrape](https://github.com/seriaati/ZenlessAssetScrape): Zenless Zone Zero assets/data scraped from various database websites, used in ZZZ build card feature.

## Acknowledgements

This project can't be made without all of the [dependencies](https://github.com/seriaati/hoyo-buddy/blob/main/pyproject.toml) made by the awesome open source community.