A multi-purpose tool for any supported Hoyoverse games. This tool is designed to assist with daily check-ins, stamina checks, expedition checks, automatic code-redemption, and more.
- Google App Script
- Supported Games
- Features
- Prerequisites
- Installation
- Migration
- Usage
- Notifications Setup
- Running with Docker
If you don't have a server to run this script and simply just want to use it for checking in, you can use Google App Script.
- Honkai Impact 3rd (Daily Check-In only)
- Tears of Themis (Daily Check-In only)
- Genshin Impact
- Honkai: Star Rail
- Zenless Zone Zero
-
Honkai Impact 3rd:
- Daily check-in: Runs every midnight local time.
-
Tears of Themis:
- Daily check-in: Runs every midnight local time.
-
Genshin Impact:
- Daily check-in: Runs every midnight local time.
- Dailies: Reminds you to do your dailies, such as commissions if you haven't done them at 09:00 (local time).
- Weeklies: Reminds you to do your weekly bosses/discounted resin if you haven't done them at 09:00 (local time).
- Stamina check: Reminds you to spend your resin if you're at your set threshold or capped.
- Expedition check: Check your expeditions and sends a notification if they're done.
- Realm currency: Sends a notification if your realm currency is capped.
- Code Redeems: Search for codes and redeem them automatically.
- Traveler's Diary: Check your monthly currency income.
-
Honkai: Star Rail:
- Daily check-in: Runs every midnight local time.
- Dailies: Reminds you to do your dailies, such as commissions if you haven't done them at 09:00 (local time).
- Stamina check: Reminds you to spend your stamina if you're at your set threshold or capped.
- Expedition check: Check your expeditions and sends a notification if they're done.
- Code Redeems: Search for codes and redeem them automatically.
- Trailblazer Monthly Calendar: Check your monthly currency income.
-
Zenless Zone Zero:
- Daily check-in: Runs every midnight local time.
- Dailies: Reminds you to do your dailies, such as commissions if you haven't done them at 09:00 (local time).
- Stamina check: Reminds you to spend your stamina if you're at your set threshold or capped.
- Howl Scracth Card: Notifies you if you haven't scratched the card for the day at 09:00 (local time).
- Shop Status: Notifies you if the shop has finished selling videos.
- Code Redeems: Search for codes and redeem them automatically.
-
Clone the repository.
-
Run
npm installto install the dependencies. -
You can configure your config using one of the following methods:
- Using the Setup Script:
- For Windows, run the following npm script from the project root:
npm run setup:windows
- For Linux, use this command:
npm run setup:linux
- These commands will automatically open your default web browser to help you configure your settings through a web-based interface.
- Manual Configuration:
- Copy the
default.config.json5file to create aconfig.json5file:cp default.config.json5 config.json5
- Open
config.json5and update it with your application's configuration settings.
-
Follow the instructions in the
default.config.json5orconfig.json5file.
Note
If you're using this project since the config.js file or config.jsonc and you're updating to the latest version, please run the following command to migrate your configuration to the new format.
npm run migrateor
node convert.jsFor a detailed usage guide, refer to this gist: Cookie Guide.
For setting up Discord or Telegram notifications, refer to the setup folder.
This application can be easily managed and run using Docker. We provide a Makefile for convenience, but you can also use Docker commands directly.
1. Prerequisites
- Docker: Ensure Docker is installed and running. Download it from https://www.docker.com/.
- Docker Compose: Most Docker installations include Docker Compose. If not, install it from https://docs.docker.com/compose/install/.
2. Configuration
You can configure your config using one of the following methods:
-
Using the Setup Script:
- For Windows, run the following npm script from the project root:
npm run setup:windows
- For Linux, use this command:
npm run setup:linux
- These commands will automatically open your default web browser to help you configure your settings through a web-based interface.
- For Windows, run the following npm script from the project root:
-
Manual Configuration:
- Copy the
default.config.json5file to create aconfig.json5file:cp default.config.json5 config.json5
- Open
config.json5and update it with your application's configuration settings.
- Copy the
3. Building and Running with Docker Compose
Using the Makefile (Recommended):
The provided Makefile simplifies common Docker tasks.
-
Build the image:
make build
-
Start the application:
make up
-
Stop the application:
make down
-
View logs:
make logs
-
Rebuild and restart:
make update
For a complete list of available Makefile targets, run:
make help
Using Docker Compose Directly:
If you prefer not to use the Makefile, you can use the following Docker Compose commands:
- Build the image:
docker-compose build
- Start the application:
docker-compose up -d
- Stop the application:
docker-compose down
- View logs:
docker-compose logs -f instance
- Rebuild and restart:
docker-compose down && docker-compose build && docker-compose up -d
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. If there are any bugs, please open an issue.
If you have any suggestions or ideas, feel free to open an issue.
New to contributing?
To get started, fork the repo, make your changes, add, commit, and push your changes to your fork. Then, open a pull request. If you're new to GitHub, this tutorial might help.
You can support the project by giving it a star, sharing it with your friends, contributing to the project, and reporting any bugs you find.
If this repo is useful to you, you can support me by buying me a coffee. Thank you!
