HoyoLab Auto

HoyoLab Auto

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.

Table of Contents

• Google App Script
• Supported Games
• Features
• Prerequisites
• Installation
• Usage
• Notifications Setup
• Running with Docker

Google App Script

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.

• Google App Script

Supported Games

• Honkai Impact 3rd (Daily Check-In only)
• Genshin Impact
• Honkai: Star Rail
• Zenless Zone Zero

Features

• Honkai Impact 3rd:

  • 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.

• 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.

• 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.

Prerequisites

• Git
• Node.js

Installation

1. Clone the repository.
2. Run npm install to install the dependencies.
3. Create a config.js or rename default.config.js to config.js.
4. Follow the instructions in the default.config.js or config.js file.

Usage

For a detailed usage guide, refer to this gist: Cookie Guide.

Notifications Setup

For setting up Discord or Telegram notifications, refer to the setup folder.

Running with Docker

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

• Rename default.config.js: Create a copy of default.config.js named config.js and fill in your application's configuration:

  cp default.config.js config.js
  # Edit config.js with your settings 

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

Contributing

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.

Buy Me a Coffee

If this repo is useful to you, you can support me by buying me a coffee. Thank you!