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

Elevate your Hoyoverse experience.
https://github.com/seriaati/hoyo-buddy

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

Last synced: 16 days ago
JSON representation

Elevate your Hoyoverse experience.

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. | ✅ | ✅ | ✅ | ❌ | ❌ |
| /search | Search anything game-related, including unreleased content. | ✅ | ✅ | ✅ | ❌ | ❌ |
| /gacha-log | Import, view, and analyze your gacha records. | ✅ | ✅ | ✅ | ❌ | ❌ |
| /farm reminder | Set reminders for farming materials for a character/weapon. | ✅ | ❌ | ❌ | ❌ | ❌ |
| /exploration | View area exploration statistics. | ✅ | ❌ | ❌ | ❌ | ❌ |
| /events | View on-going in-game events and banners. | ✅ | ✅ | ✅ | ❌ | ❌ |
| /lb view | View leaderboards. | ✅ | ✅ | ✅ | ❌ | ❌ |
| /farm view | View farmable domain materials in different weekdays. | ✅ | ❌ | ❌ | ❌ | ❌ |
| /lb akasha | View character damage leaderboard. | ✅ | ❌ | ❌ | ❌ | ❌ |

## 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 in the market 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.