# lmeszinc/starrailcopilot

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/lmeszinc-starrailcopilot).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

4,156 stars · 236 forks · Python · GPL-3.0

## Links

- GitHub: https://github.com/LmeSzinc/StarRailCopilot
- awesome-repositories: https://awesome-repositories.com/repository/lmeszinc-starrailcopilot.md

## Topics

`honkai-star-rail`

## Description

StarRailCopilot is an automation bot and resource farmer for Honkai: Star Rail. It functions as a system for performing repetitive gameplay tasks, such as executing dungeon cycles and gathering character growth materials based on specific target requirements.

The project utilizes a vision engine that employs template matching and color analysis to track character position and orientation on the game minimap. It includes an emulator manager to launch and monitor game instances across both local and cloud-based environments.

The automation capabilities cover the collection of daily rewards, material gathering, and the execution of simulation cycles to acquire gear. These routines are supported by a state detection system that identifies game interface elements and character headings through image recognition.

## Tags

### Game Development

- [Battles and Daily Routine Automators](https://awesome-repositories.com/f/game-development/game-idling-automators/sequential-gameplay-automators/battles-and-daily-routine-automators.md) — Automates in-game battles, farming, and daily routines for Honkai: Star Rail without user intervention.
- [Gameplay Automation Bots](https://awesome-repositories.com/f/game-development/gameplay-automation-bots.md) — Provides an automated bot for performing repetitive gameplay tasks and resource farming in Honkai Star Rail.
- [Dungeon Farming Automation](https://awesome-repositories.com/f/game-development/equipment-automation/dungeon-farming-automation.md) — Automates cycles through specific game dungeons to collect growth materials and optimize gear. ([source](https://github.com/lmeszinc/starrailcopilot#readme))
- [Image Recognition Bots](https://awesome-repositories.com/f/game-development/game-automation-bots/image-recognition-bots.md) — Uses template matching and screen capture to identify game UI elements and character locations.
- [Mobile Game Automation Tools](https://awesome-repositories.com/f/game-development/mobile-game-automation-tools.md) — Automates repetitive tasks and resource farming in mobile games using visual recognition.
- [Resource Farming Logic](https://awesome-repositories.com/f/game-development/resource-farming-logic.md) — Calculates required material quantities and iterates through dungeon cycles until specific targets are met.
- [Resource Gathering Automation](https://awesome-repositories.com/f/game-development/resource-gathering-automation.md) — Automatically locates and collects specific character growth materials within the game environment. ([source](https://github.com/LmeSzinc/StarRailCopilot/wiki/Planner_cn))
- [Simulated Universe Farmers](https://awesome-repositories.com/f/game-development/automatic-crop-farming/simulated-universe-farmers.md) — Automates the Simulated Universe game mode to farm high-tier gear and inner-circle rewards. ([source](https://github.com/lmeszinc/starrailcopilot#readme))
- [Automated Reward Collections](https://awesome-repositories.com/f/game-development/reward-distribution-engines/automated-reward-collections.md) — Automatically completes daily missions and claims available gifts to ensure rewards are collected. ([source](https://github.com/lmeszinc/starrailcopilot#readme))

### Artificial Intelligence & ML

- [Visual State Recognition Engines](https://awesome-repositories.com/f/artificial-intelligence-ml/ocr-engines/visual-state-recognition-engines.md) — Ships a vision system using template matching and color analysis to track character position and orientation.
- [Edge Detection](https://awesome-repositories.com/f/artificial-intelligence-ml/computer-vision-systems/computer-vision/image-processing/edge-detection.md) — Utilizes edge detection algorithms to identify character coordinates and boundaries on the game minimap.
- [Entity Position Tracking](https://awesome-repositories.com/f/artificial-intelligence-ml/entity-position-tracking.md) — Identifies specific locations on the minimap using edge-detected template matching and gradient scaling. ([source](https://github.com/LmeSzinc/StarRailCopilot/wiki/MinimapTracking))
- [Visual Game State Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/visual-game-state-analysis.md) — Derives the current state of the game world by analyzing visual screen data and minimaps.

### Part of an Awesome List

- [Emulator Management Dashboards](https://awesome-repositories.com/f/awesome-lists/devtools/android-emulation-and-debugging/emulator-management-dashboards.md) — Provides a dashboard for launching and monitoring game instances across local and cloud-based emulator environments.

### DevOps & Infrastructure

- [Game Resource Farming](https://awesome-repositories.com/f/devops-infrastructure/execution-node-managers/farm-dispatchers/game-resource-farming.md) — Executes automated routines to gather in-game materials and high-tier gear via specialized routes.

### System Administration & Monitoring

- [Emulator Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/emulator-instance-port-mappings/emulator-dashboards.md) — Provides a centralized dashboard to control external android emulator processes and monitor system resources.
- [Game Instance Management](https://awesome-repositories.com/f/system-administration-monitoring/game-instance-management.md) — Manages the launch and maintenance of multiple game instances via emulators.

### Development Tools & Productivity

- [Remote Task Offloaders](https://awesome-repositories.com/f/development-tools-productivity/task-execution/blocking-task-offloaders/remote-task-offloaders.md) — Offloads computationally intensive game automation tasks to remote server instances to save local resources.

### Graphics & Multimedia

- [Camera Orientation Analysis](https://awesome-repositories.com/f/graphics-multimedia/camera-orientation-analysis.md) — Identifies the camera's facing direction by analyzing the minimap through color space conversion. ([source](https://github.com/LmeSzinc/StarRailCopilot/wiki/MinimapTracking))
- [Remote Automation Execution](https://awesome-repositories.com/f/graphics-multimedia/cloud-game-streaming/remote-automation-execution.md) — Executes automation routines through a remote game instance to reduce local hardware resource consumption. ([source](https://github.com/LmeSzinc/StarRailCopilot/wiki/Cloud_cn))
- [Color-Space Range Filtering](https://awesome-repositories.com/f/graphics-multimedia/color-space-range-filtering.md) — Implements color-space range filtering to isolate minimap elements and determine camera orientation.
- [Visual Heading Determination](https://awesome-repositories.com/f/graphics-multimedia/visual-heading-determination.md) — Calculates the character's current facing direction by matching the minimap arrow against rotated templates. ([source](https://github.com/LmeSzinc/StarRailCopilot/wiki/MinimapTracking))
