The Snap Hutao project has received wide supports from the open-source community and users since its inception on GitHub on April 18, 2022. As the project has evolved, we have created a series of supporting services as middleware for Snap Hutao.

Now, the development team is making some of these practical services available to the open-source community in the form of open interfaces, for use by developers who share our vision. We will be writing usage documentation for these interfaces, maintaining the services, and providing answers to frequently asked questions. Whether you are an experienced developer or a beginner, we hope that these interfaces will assist you in creating applications.

Hutao API & Hutao Cloud Open-source Developer's License

Hutao API is an interface service that exposes the Hutao Abyssal Database. Open-source software authors can use the Hutao API to retrieve data from the Hutao database or upload data.

Developers who gain access to the Hutao API also receive full privileges to the Hutao Cloud feature within the Snap Hutao as a benefit.

Developers can apply for access by submitting their information through the Hutao API Open Platform at https://homa.snapgenshin.com/

Enka API with China Acceleration

Enka Network is an excellent Genshin Impact tool that provides detailed data on characters in the user's current character showcase. However, due to restricted access to certain network services in China, the stability of Enka Network's functionality in the region is compromised.

To ensure a smooth user experience for Snap Hutao users in China, the development team has utilized Enka Network's data for the development of the My Characters feature and established a proxy server.

If you are a developer of open-source Genshin Impact tools and require this functionality, you can fill out the form to apply for the usage of our maintained proxy service.

UIGF Interchangeable Game Data Format

Snap Hutao aims to enable the free flow of user data among various open-source tools with different features. To facilitate this, Snap Hutao has established the initial version of the Uniformed Interchangeable GachaLog Format Standard (UIGF).

Since then, this standard has gained more recognition among developers, leading to the promotion of additional standards. Many developers have now gathered under the UIGF organization. Our goal is to maintain this organization, allowing developers to connect with more users, receive feedback, make technical advancements, and create outstanding open-source Genshin Impact tools.

Snap Hutao will enter home dashboard by default when it's opened. The top part is your personal gaming data; the bottom part is recent game notice and event countdown in days and hours.

Personal gaming data dashboard includes:

• Game launcher
  • You can select your account and start the game from dashboard
• Wish history
  • Game UID and progress bar styled pity count will be display in the dashboard
  • If you have multiple wish history archives, you can use arrow button on left and right side of chart to switch archive
• Achievement statistics
  • Achievement statistics charts includes gained achievements count, percentage, and the latest gained achievements
  • If you have multiple achievement archives, you can use arrow button on left and right side of chart to switch archive
• Real-time Notes
  • Real-time notes data will be displayed on home dashboard
  • If you have multiple activated real-time notes account, you can use arrow button on left and right side of chart to switch account

Add Role

• Click on Add Role button
• In the pop-up menu, find the UID you want to add, and click on the add button to its right
• Now, the game UID character's Real-time Notes should be displayed in the page
  • The Real-time Notes is set to refresh timely
    • You can click on the Notification Settings on the top right to manage it
    • If you want to see the data at this moment, you can click Refresh button to refresh data immediately
  • If you receive any warning similar to Verification failed, it may be caused by too many account added, and you can try to fix it youself by refreshing account cookie

Global Notification Settings

• In the Notification Settings on the top right, you can change the global settings of Real-time Notes, including:
  • Refresh rate
  • Do not disturb setting
  • Prioritized notification
    • This prevent Snap Hutao's notification being closed automatically

Independent Settings for Accounts

• Snap Hutao allows different settings on each Real-time Notes account
• Hover the cursor over the form of Real-time Notes account that needs to set
• Click on the setting button on it, and you can modify these settings:
  • Original Resin threshold value
  • Realm Currency threshold value
  • Parametric Transformer notification
  • Daily Commission notification
  • Expeditions notification
  • Display in the main page (feature coming soon)
• Click on Save and you can save the settings

Delete Daily-Notes Account

• Hover the cursor over the form of Real-time Notes account that needs to delete
• Clock on the remove button on it, and you can remove the corresponding account

• Clear Real-time Notes Scheduled Task
  • Before version 1.4.15, if not execute this step, scheduled task used to refresh real-time notes may not be deleted,and you may face this issue
    • Method 1
  • Method 2：
    • Execute the following PowerShell script
  • Method 3：
    • Open Windows Scheduled Task Manager
    • Find SnapHutaoDailyNoteRefreshTask task and delete it
  • Method 4：
    • Upgrade to1.5.1 version and open Real-time Notes
    • Close software and remove it
• Remove the Software
  • Open Start Menu
  • Find or search Snap Hutao
  • Right click on it, and select Unstall
• Remove data folder (If you want remove it completely)
  • Open and delete %userprofile%/Documents/Hutao

This document records known issues that need to be fixed.

Game Throw Data Exception Error when Enabling Multi-Client Feature

The issue occurs at early May 2023, and caused by MiHoYo's anti-cheat module update. Disable the multi-client and restart the game to fix it.

This issue is planned to be fixed in the following versions.

Snap Hutao No Response or Cash when Using Real-time Notes

A current local database issue will cause Snap Hutao to no response or even crash. This issue is planned to be fixed in the next version, you may also track this issue in GitHub

Game Quick Launch Failure

In the current version, a known issue will cause JumpList game quick start launcher fail to open the window. This issue will be fixed in the next patch.

Frequent 1034 Verification Error from Real-time Notes

This issue is caused by change of anti-bot program in Miyoushe, and will cause Real-time Notes data refresh failure. User can fix this issue temporarily by manual verification.

This issue will be fixed in the future.

Android

Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie

• GetToken 项目的发布会包含两个 apk 文件，两者最终效果相同。根据你的设备情况选择适合你的版本即可
  • app-release.apk 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能
  • 名称以lspatched结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序
    • 你需要卸载官方版米游社以安装该版本的米游社
• 启用插件或安装修改版米游社后打开米游社，在底栏点击"我的"，然后登录您的通行证
• 在右上角点击形如 🔑 形状的按钮
• 点击勾选 Stoken 选项
• 点击复制登录信息
• 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
• 在胡桃工具箱中的账号登录位置，点击手动输入
• 将之前获取到的 cookie 输入，此时即可完成登录

iOS

iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie

• 从 App Store 下载 Stream
• 对域名 api-takumi.mihoyo.com 进行抓包分析
• 找到并复制带有 Stoken 的数据
  • 形如stuid=****;stoken=v2****;mid=****;
• 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
• 在胡桃工具箱中的账号登录位置，点击手动输入
• 将之前获取到的 cookie 输入，此时即可完成登录

This document covers solutions of foreseeable client error

RuntimeEnvironmentException

• Exception: RuntimeEnvironmentException
  • Hint: Unable to set registry key without enabling long path
• Issue source: Windows long path limit is set to be limited at 256 characters by default
• Solution: Download EnableLongPaths.zip, unzip it and run .reg file as administrator

Return Code: -10001

• This error comes directly from MiHoYo BBS, hints include
  • Return Code: -10001
  • Return Code: -100
• Issue source
  1. Cookie expired
  2. Network error
  3. System time is not accurate
• Solution
  1. In the account panel, execute Refresh Cookies
  2. Remove your account and add it again
  3. Sync your system time

Return Code: 1034 Verification Failed

• If Snap Hutao returns 1034 status code and hints verification failed (usually during the operation of Realtime Notes), it means the operation is blocked by MiHoYo BBS anti-bot system
• Solution:
  • Enter Realtime Notes
  • Click on Verify Current User and Role button
  • Follow the instruction in MiHoYo BBS to verify
  • After finishing the verification process, click Complete to close the verification window
  • Now, the account should back to normal; If not, process the step above again

HttpRequestException Metadata Download Failed

403 (Forbidden) / 404 (Not Found)

Solution: Update your Snap Hutao to latest version

502 (Bad Gateway)

Associated Issue: https://github.com/DGP-Studio/Snap.Hutao/issues/100

This HTTP Exception occurs when Snap Hutao failed to fetch remote resource (usually static image and configuration)

If you are using proxy software, you may need to turn it off or using TUN mode proxy; otherwise you need to use Windows 8 AppContainer Loopback Utility to remove Windows APP Container Loopback limits.

Gacha System and Principal

胡桃的祈愿系统相较 Snap Genshin 进行了整体架构上的重新设计。

本文将解释原神的祈愿记录机制和胡桃工具箱中祈愿导出功能的技术原理。

祈愿的获取

获取祈愿记录需要请求米哈游的 API

关于此 API, 有下列几个注意点

• 通过米哈游服务器的 API，只能查询到过去 6 个月内的祈愿记录
  • 这也是原神客户端中祈愿记录的来源
• API 存在请求速率限制，过快的请求会导致后续的请求失败，无法正常获取数据

为了请求此 API，我们需要四个关键参数

• 目前有下列几种方法可以获取这些参数
  • 遍历 Unity 的日志文件，查找用户打开的祈愿记录 URL
  • 代理本机流量，筛选祈愿记录 URL
  • 查找 CefBrowser 的浏览器缓存，找到祈愿记录 URL
  • 对于包含了 Stoken 的 Cookie，调用 genAuthKey API,获取参数
  • 高级用户手动输入相关 URL

在请求 API 后可以获取到零散的祈愿记录，在对其进行拼接后即可获得一份完整的祈愿记录列表

祈愿的存储

获得完整的祈愿记录列表后即可将其简单的序列化入本地数据库内，在需要时可从数据库中反序列化出来呈现给用户。

后续的对服务器的请求只需要对比数据库中的数据请求新增的部分即可。

这样，用户即可长期地保存帐号的完整祈愿记录

UIGF 格式

统一可交换祈愿记录标准

Uniformed Interchangeable GachaLog Format standard

UIGF 是由我们联合其他祈愿记录应用倡导、推出并持久维护的一个统一的祈愿记录数据交换标准

标准化的数据格式将允许用户将祈愿记录在不同的转移数据，以使用到不同原神工具中各自的特色功能

祈愿的导入

在使用 UIGF 数据格式的前提下，可以导入曾在其他应用中储存的数据

胡桃在处理导入时，会对比本地储存中存在的最早的索引（ID）并仅导入较老的数据

（因为始终可以从米哈游的服务器获取较新的数据，这种原始数据有更高的精确度）

祈愿的导出

尚未实现，正在设计 已实装

How to create desktop shortcut

• Use Win+R to start run, in the window input shell:AppsFolder
• In the new pop-up window, find Snap Hutao
• Right lick on it, and click Create shortcut
• Confirm the operation and you will get the desktop shortcut

How to create desktop shortcut with Administrator privilege

Fundamental principle: Use the following PowerShell scrip can run Snap Hutao with Administrator privilege

• Save Snap Hutao logo to your device
  • You can find it here
  • It is expected to see a blank image in the browser
• In your desktop, select New -> Shortcut
• In the field of Type the location of the item, input:

• Name the shortcut as Snap Hutao
• Confirm the creation, and you will get this shortcut with PowerShell logo
• Right-click on this shortcut, select Properties
  • Change value of Run to Minimized
  • Select Change Icon, and select the icon you just downloaded
• Now, you get a shortcut of Snap Hutao with Administrator privilege
  • You can also pin it to task bar or start menu

How to run Snap Hutao when Windows starts

This is a workaround solution

• Create a bat file, content refers to this Issue, it allows bat to run Snap Hutao with Administrator privilege
• Create a Scheduled Task, run the bat when Windows startup, or drag it to Windows start folder

Use Snap Hutao to quick start the game

• Config the game launcher in the settings

• Pin Snap Hutao on taskbar

• Right click on Snap Hutao and you will see the quick launcher

  

• Select Lauch Game, you will be asked which account to start the game

Use Snap Hutao with Network Proxy

Refer to HttpRequestException Error (502) document

Mojibake in Snap Hutao

• If you are using Windows 10 and see some button are not display properly
  • You can download Segoe Fluent Icons font
  • You need to install it for all users
• You can find this font from Microsoft

MiHoYo BBS Account often Lose Login Status

Snap Hutao use saved MiHoYo BBS cookies to maintain login status. If you log out your account in your browser or other device, cookie will become invalid, and Snap Hutao will also be forced to log out, account will be automatically removed.

This problem may also be caused by network error, you should check this first; If it's not caused by network issue, you can use Refresh Cookie in the account panel; You can also remove your account manually and add it back again.

Since October 2022, MiYouShe (Chinese BBS) rapidly increased bot detection and may set users' account as under-risk status, this may cause Snap Hutao failed to check validation of the cookie

Game Account Lose Login Status in the Launcher

• There are two factors associated with game account login status: network and device ID
• This issue usually caused by:
  • Change of public IP address
  • Failed saving operation, no real login status been saved (Snap Hutao cannot detect if the status is real valid)
    • Make sure to enter the game after sign in
    • Make sure the game process is gone after closing the game
    • Detect the account again to save your login status

Snap Hutao Throws Failed to add Scheduled Task Error

If you are using Administrator privilege to start real-time notes feature, Snap Hutao's scheduled task will be created as Administrator role. When next time edit real-time notes settings without Administrator privilege, the program will have a lack of privilege to edit the settings and throw out this error.

Run Snap Hutao as Administrator to edit your settings to solve this issue.

Stuck at Installing Required Framework when Using MSIX Package to Install

• When user's OS missing required dependency framework, Windows will download and install it automatically. However, if the user disabled Windows Update or have a bad network, the system is unable to process this installation.
  • Make sure Windows Update is enabled; Snap Hutao's update also relies on it
  • You can also download and install the dependency manually

Unable to Run Snap Hutao as Administrator

This issue only occurs in Windows 10 older than 22H2 version

• When user's OS version older than Windows Build 19045 (aka Windows 10 22H2), Snap Hutao is unable to start when running as Administrator
  • This issue comes from Windows kernel, and it's hard to locate, so we suggest you to update your OS to the latest version

1.6.4

• New
  • Export wish history data with UIGF v2.3 data format
• Fix
  • FPS unlocker Issue #733
• Optimize
  • When running program without administrator privilege, features require administrator privilege will have text hints
  • Support of HoYoLAB
  • Localization updates

1.6.3

• New
  • Home dashboard, including Hutao Cloud account, game launcher, wish history, achievement stat and real-time notes
  • Enable notification box will now automatically hide in-app notification
  • CN server option without TapTap account
• Fix
  • Issue that user cannot get Hutao Cloud bonus after uploading Abyss record
  • Issue that cannot sign in to HoYoLab with Facebook
  • HoYoLab check-in issue
  • Issue when facing empty value during wish history fetch progress
• Optimize
  • Project refactoring, brings a 20% performance improvement
  • Add localization support for WIKI features
  • Add support for all international channels (which affect payment gateway)
    • Supporting HoYoverse official, Google Pay, Epic
  • When Unlock framerate limit is enabled, limit value can be modified during the game, and will take effect immediately

1.6.2

• New Feature
  • Wish history cloud backup based on Hutao account system
    • Currently, sponsors on AFDIAN and beta users will receive corresponding cloud membership time; All registered users will receive 5 days membership time after uploading Abyss record.
    • This feature will be optimized constantly in the following 1.6 versions
• Fix
  • Issue that BiliBili server account cannot receive data for Real-time Notes
  • Issue on HoYoLab login
• Optimize
  • Static assets download logic

1.6.0

• Add
  • Hutao account system with registration and login available now
  • Support of HoYoLab account login, and add its support to the following features:
    • Web login and Stoken Cookie login
    • Abyss record
    • Daily check-in reward
    • My character
    • Real-time notes
• Optimization
  • Performance of frame rate unlock
  • Multi-client
  • Now users must unlock advanced features in the settings page before actually using them
  • Settings page layout
  • Tiles image on Windows 10

1.5.4

• Add
  • Game Launcher
    • Game resource package download
    • Allow multiple Genshin Impact process to run
    • Allow users to select the specified monitor to start the game
  • New icons have been used
• Fix
  • Issue caused unlimited file writing during server switch
• Optimization
  • Optimize default language selection
  • Allow device ID be copied with button
  • Setting page UI optimization

1.5.1

• Optimization
  • Replace JumpList menus with JumpTask,
  • Add option to allow user set language over system default setting
  • Add translation contribution entry
  • Add options to reset the image resource
• Add
  • Monster WIKI
  • Korean translation
  • Internationalized Metadata

1.4.15

• New
  • Static image reset method
  • Cookie refresh
• Fix
  • Fix #2 31-4302 caused by server switch
  • Fix the failure of clearing scheduled task in some specific situations
• Optimization
  • Optimize Dev Plan UI #486
  • Optimize English and Traditional Chinese translations
  • Add hints when Windows long path limits are triggered
  • Optimize wake-up for scheduled tasks

1.4.14

• Fix issue that new dev plan cannot be added
• Support English UI
• Other minor bug fix

1.4.11

• First version on Microsoft Store

• Star our project on GitHub ⭐
  • Snap.Hutao
  • Snap.Hutao.Docs
• Rate our App on Microsoft Store
• Promote our project in your network

通用安装方式

• 在系统设置中打开开发者设置界面，勾选 开发人员模式 和 允许 PowerShell 脚本 （自行百度）
• 解压已下载的压缩包，找到Install.ps1文件，右键选择使用PowerShell运行，按照提示允许 PowerShell 执行操作即可
• 安装完毕，胡桃将出现在您的开始菜单中

小白级安装方式

• 解压已下载的安装包
• 运行 Snap.Hutao.Installer.exe
  • 该程序将执行上述通用安装方式的命令
• 安装完毕，胡桃将出现在您的开始菜单中

升级胡桃工具箱

• 解压你下载的最新版本压缩包
• 重复 安装胡桃工具箱 的步骤
• 若您安装失败或出现异常情况，可参考如下步骤
  • 先卸载已经安装的胡桃工具箱
  • 重复 安装胡桃工具箱 的步骤

As open-source software, community power is an important part of the ecology of Snap Hutao, and you can join our user community by following ways.

If you believe Snap Hutao is a good project and helps you, you can support us by the following ways

• Star our project on GitHub ⭐
  • Snap.Hutao
  • Snap.Hutao.Docs
• Rate our App on Microsoft Store
• Promote our project in your network

GitHub Discussion

Snap.Hutao Discussion

QQ Group (CN)

• Snap Group #1
• Snap Group #5
• Snap Group #2
• Snap Group #3
• Snap Group #4
• Snap Developer Open Discussion Group
  • General tech talk, not Snap Hutao Project development group
  • The Dev group requires some basic tech knowledge
  • You can join via https://dev-group.hut.ao if you are interested to join

Discord

Invite link：https://discord.gg/Yb8bykUKp

Localization Process

Snap Hutao Project features were originally based on the China server, but we are also trying to expand the coverage globally through the support of the MiHoYo global gaming server & software localization.Currently, our localization process includes:

• Snap Hutao
  • Localization framework
  • Client translation
    • Process:
    • English
    • Traditional Chinese
    • Korean
    • Japanese
    • Russian
  • Internation/China server conversion
  • International server account switch
  • International server wish history export
  • International server character stat
  • HoYoLab login
    • International server Abyss recrod
    • Daily Notes
    • Multilingual in-game announcements
• Snao Hutao Docs
  • Localization framework
  • Web translation
  • Process:
    • English
      • Home page
      • User documentation

Engage our Localization

• Snap Hutao
  • We created an issue thread named [Hoyolab] on GitHub: Globalization support Issue
    • We will update our process in this thread
    • You can declare your localization engagement in the thread, and we will provide the necessary support
      • We also welcome PR directly
  • You can provide your translation at translate.hut.ao
• Snap Hutao Docs
  • The developer team is maintaining Chinese documents and working on English documents
  • You can clone the docs repository, translate docs with your favorite tools, and make a Pull Request to contribute your work to the main repository
  • If you are adding a new language, you can copy the entire en folder and rename it with ISO 639-1 language code
    • For example jp as Japanese
    • Do not translate based on Chinese docs (zh) as there are some content only specific useful for Chinese users; they are not useful for international users.

My characters is a character statistics feature that allows Snap Hutao to read character's statistics on the account, including level, constellation, weapon, talent and artifact set; we also provide artifacts rating and CRTI rating for each character.

Sync Character Data

Sync from Enka API

• In the game, put characters that you need detailed data into the showcase
  • The character showcase allows up to 8 characters at the same time
• You need to wait for data sync to complete after editing the showcase configuration
  • You may need up to 5 minutes after enable the showcase or re-config the showcase
• Enter My Characters page in the Snap Hutao, Click Sync Character Data button on the top-right
• Select Sync from Enka API

Sync from MiHoYo BBS - My Characters

• Enter My Characters page in the Snap Hutao, Click Sync Character Data button on the top-right
• Select Sync from MiHoYo BBS My Characters

Sync from MiHoYo BBS - Development Plan

• Enter My Characters page in the Snap Hutao, Click Sync Character Data button on the top-right
• Select Sync from MiHoYo BBS Developement Plan

Add Selected Character to Development Plan

• Enter My Characters page in the Snap Hutao, click on character you need to add to development plan
• Click on Development Plan and enter target level
  • Synchronized data of the character will be pre-filled into current level, and you can change the target level

• After adding successfully, you can find added development plan in the Dev Plan page in Snap Hutao

• For tutorial of Dev Plan feature, please refer to Dev Plan document

Export as Image

• In My Characters page, you can select a character and then click Export as Image button to create image with your character's data, this will help you to share your character's data
• The exported image is stored in your clipboard, and you can paste it wherever you need
• A sample exported image is shown below

Character WIKI is a Snap Hutao build-in WIKI feature used to query each character's information.

Included Data

• Character list
  • Use the icon above the list, you can change the view between list and grid
  • Click on character's icon or title, and you will be directed to its WIKI page
• Character information
  • Character information
    • Introduction of the character
    • Numerical attributes value at each level
    • Attributes
• Talent
  • Introduction
  • Numerical talent value at each level
• Constellation
• statistical information on Team, weapon usage, artifact set usage provided by Hutao Database
• Other information
  • Character tachie
  • Special food
  • Costume
  • Character stories

Add to Dev Plan

• At character WIKI page, you can select character and click on Dev Plan on the top right to add it to your Dev Plan
  • The new plan will set the base level as 1
  • If you want to make new Dev Plan based on character you already have, you can try My Character feature

添加养成目标进入材料清单

基于 WIKI 资料添加

• 在胡桃工具箱的左侧栏目中，点击角色资料或武器资料功能
• 在"胡桃工具箱"的整体界面右上部分，点击养成计算按钮
• 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的起始等级以及目标等级
  • 基于 WIKI 资料添加的养成目标，默认初始值为 1 级

基于玩家数据添加

• 在"胡桃工具箱"的左侧栏目中，点击我的角色功能
• 在选中角色后，点击右上角的养成计算按钮
• 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的"起始等级"以及"目标等级"
  • 基于玩家数据添加的养成目标，默认初始等级为玩家当前的角色等级
  • 请参考My Characters文档以获取更多信息

背包物品

• 在"胡桃工具箱"的左侧栏目中，点击"养成计划"功能
• 点击"背包物品"功能栏
• 在"胡桃工具箱"的整体界面右上部分，点击"新建计划"按钮
• 在弹出的"创建新的养成计划"的窗口中，填写需要创建的养成计划名称
  • 此处可勾选"绑定当前选中的账号角色"
  • "新建计划"按钮左侧的下拉选项框，可自行切换不同的养成计划
• 点击下方的任意物品图标或数字区域，即可手动编辑该种材料的数目
  • 背包物品的具体材料信息，对应于其修改时，所切换至的养成计划
• 在"胡桃工具箱"的整体界面右上部分，可点击"删除计划"按钮，将当前的养成计划删除
  • 在删除当前养成计划后，处于切换至该养成计划时，输入的背包物品信息将一同删除

功能说明

此功能尚在完善阶段，若您有建设性的建议，或发现了显著的问题，请按此页面直接向我们反馈，感谢您的贡献！

• Snap Hutao offers advanced game launcher feature allows user to launch the game with self-defined settings
• Click on the Game Launcher on the sidebar to get into game launcher's page
  • If you are using it at the first time, you will be redirected to Snap Hutao settings page and asked to set your game path
    • When choosing the game path, noticed that you should choose game program instead of launcher program
      • Such as $\Genshin Impact\Genshin Impact Game\YuanShen.exe and $\Genshin Impact\Genshin Impact Game\Genshin Impact.exe
      • Official launcher program is usually $\Genshin Impact\launcher.exe
• You can make launcher configuration options in the game launcher's page, and then click Launcher button on the top-right to launch the game
  • Launcher options is explained in the document below

Server Switch

• Enter Game Launcher page

• In the General - Server field, select the server you want

  • Current available serves options include:

  Option	Server
  CN	Mainland China server
  BiliBili	Chinese server with BiliBili account system
  Global Default	HoYoVerse servers
  Global Epic	HoYoVerse servers with Epic Store payment gateway
  Global Google	HoYoVerse servers with Google Pay payment gateway

• click Launcher button on the top-right to launch the game, Snap Hutao will download server required files and then launch the game

Game Account Switch

1. Enter Game Launcher page
2. Click Detect Account field in the General category, Snap Hutao will detect current Genshin Impact's account login status
3. In this pop-up window, enter an archive name for this account and click Confirm
4. Go back to the game, sign out and sign in to your another account. Repeat step 2 and 3 to add all your account to Snap Hutao
   • Each saved account are selectable
   • On the right side, there are three buttons, they are:
     • Bind current user account, bind current activated MiHoYo BBS account with this game account, an UID will be display on this archive
     • Rename, rename current account archive name
     • Delete, delete current account archive

Appearance

• Enter Game Launcher page
• In the Appearance category, there are 6 available options:
  • Exclusive Fullscreen, the game process will run in exclusive fullscreen mode
  • Fullscreen, the game display mode is set to fullscreen
  • Borderless, the game display mode is set to borderless
  • Width, game window width, such as 1920
  • Height, game window height, such as 1080
  • Display, users with multiple displays can use this option to set which display to run the game

Advanced Features

Unlock Frame Rate Limit

• Run Snap Hutao as administrator

• Enter Game Launcher page

• At the bottom of the page, you can find Unlock Frame Rate Limit option

  • Trigger the switch to enable or disable this feature
  • In the Set Frame Rate Limit field, you can adjust the limit freely

• Fact that may cause failure in unlocking frame rate limit:

  • Snap Hutao process is not kept in the background
  • V-Sync is not set to off in the game
  • Max Framerate limit is not changed in your graphic card settings
  • Power Saving mode is not disabled in power settings
  • Your graphic card is not powerful enough

Multi-Client

1. Run Snap Hutao as administrator
2. Enter Game Launcher page
3. At the bottom of the page, enable Multi-Client option
4. Click Launch button on the top-right of the window
5. Wait for 12 seconds before entering the game (open the gate)
6. Repeat step 4 and 5 to launch next client instance

Snap Hutao offers two major statistic features associated with Spiral Abyss challenge

• Abyss Stats on the sidebar is a feature designed to help players who are not familiar with Genshin Impact's battle system to build teams, pass the Abyss and obtain rewards by collecting and displaying challenge stats data from the Spiral Abyss from a large number of players.
• Abyss Record on the sidebar is a statistical feature that helps individuals review their gaming experience and personal data collection by saving their challenge data from each period of the Spiral Abyss.
  • Many players contribute to the Hutao Database's Abyss Stats dataset by uploading their personal Abyss Records

View Abyss Stats

• Enter Abyss Records page by clicking Abyss Stats on the sidebar menu
• Click Character Usage tab to view character usage rate statistics
  • Character Usage Rate = Character Appearance in this Floor ^[1] / Number of Player who Own this Character
• Click Character Appearance tab to view character appearance rate statistics
  • Character Appearance Rate = Character Appearance in this Floor [2] / Total Number of Abyss Record of this Floor
• Click Teams tab to view teams appearance time statistics
  • Team appearance is the appearance time rank of different characters team combination
• Click Character Constellation tab to view character constellation statistics [3]
  • Character Constellation [4] = Number of Player who Own this Character / Total Number of Player

Upload Abyss Data

Use Snap Hutao Client

• Enter Abyss Records page by clicking Abyss Records on the sidebar menu
• Click Refresh Data button to make suer Snap Hutao is storing your latest Spiral Abyss record
• Click Upload Data to upload your Spiral Abyss records
  • This may take a few seconds, you will see the following success message after your data is submitted

Use Browser

• Open our JavaScript file, copy the entire content
• Create new bookmark in your browser
  • Fill with a suitable name
  • in the URL field, fill with script you just copied
• Visit MiYouShe, wait the page to be fully loaded, and then click the bookmark
• Wait for a moment, and you will see data upload request window
• After confirm it, the browser will upload your abyss record, do not turn off your browser
• You will receive a notification when your data is submitted

About Snap Hutao

This part has the following information:

• The icon of Snap Hutao：You can find the original image of the icon at the home page
  • The artist is 画画的芦苇 (BiliBili)
    Drawing Process
  • DGP-Studio is authorized by owner to use it for Snap Hutao Project
• Snap Hutao client version
• Device ID

Snap Hutao Account

Snap Hutao account system is designed by DGP-Studio to provide fundamental component for cloud service such as wish history backup. Currently, you are already able to register and login to your Snap Hutao account in the settings page.

Appearance

• Language

  • Snap Hutao will following system language setting by default
  • You can force to change to another language in the settings page

• Backdrop Material

  • In this option, you can change the backdrop material of the software to
    • Acrylic
    • Mica (Windows 11 only)
    • MicaAlt (Windows 11 only)
  • The setting will take effect immediately

@slidestart auto

Windows 10 Acrylic

Windows 11 Acrylic

Windows 11 Mica

Windows 11 MicaAlt

@slideend

Wish History

• In this field, you can choose to hide wish event that you do not have any record in the period in the wish export feature

Game

• Game Path

  • In this field, you can modify or set your game path for Snap Hutao
  • When setting the game path, you should select game program instead of launcher program
    • Such as $\Genshin Impact\Genshin Impact Game\YuanShen.exe

• Delete Game Embedded Browser Web Cache

  • When you are using web cache refresh method in the wish history feature and receiving authkey expiration error, you can try this operation to fix the error
  • Click on this field to execute the operation

Storage

• Open Data Folder

  • Click this field to open data folder that contains user data, log, and metadata

• Change Data Directory

  • This field allows you to change the data directory to path you want

• Open Cache Folder

  • Click this field will open cache folder that saves image assets used by Snap Hutao

• Reset Image Resource

  • This option allows user to reset image cache when there are too many image failed to load. The program will re-download images resource at next start-up

MiHoYo BBS/HoYoLab Daily Check-in

• How to use
  • First, login to your MiHoYo BBS/HoYoLab account and select it
  • Click on the field
  • Then Snap Hutao will pop up the check-in page and you can check-in manually
• Interface when this feature is working:

Dangerous Features

• Enable Advanced Features
  • With Snap Hutao running as administrator, you can enable this field to enable advanced features in the game launcher

    For reference：

    Snap Hutao Terms of Service

    Genshin Impact Terms of Service (CN server/Chinese)

    Genshin Impact Terms of Service (Oversea servers/English)

• Delete All Users
  • Execute this operation will delete all user data in Snap Hutao
  • Click on the field to operate, you will be asked to confirm
  • In most scenario, you don't need to use this field

• At the left bottom corner, you can find the account menu above the Settings button. In the pop-up account menu, you can find the entry to login in to your MiYouShe and HoYoLab account:

• Click on Web Login

  • In the pop-up build-in browser, login with your account
  • Click I'm logged in button on the top right, after you have logged into your account
  • Then your account will be added to Snap Hutao, the browser will close automatically

• Alternatively, you can enter your MiHoYo BBS cookie list by click on Input Manually button

  • If you do so, the cookies must contains Stoken field
  • You can refer to 使用第三方工具获取有 Stoken 的 cookie document for methods to capture cookie with Stoken

• After added your MiHoYo BBS account, you need to switch to account you want in the account menu, to activate it

• You can always switch your MiHoYo BBS account in the account menu, and you are also allowed to copy account's cookie or remove account there

Weapon WIKI is a Snap Hutao build-in WIKI feature used to look up each weapon's information

Included Data

• Weapon list
  • Use the icon above the list, you can change the view between list and grid
  • Click on weapon's icon or title, and you will be directed to its WIKI page
• Weapon data
  • Weapon basic information
    • Images of weapon before and after ascension
    • Weapon's main image
    • Weapon's introduction
    • Weapon's numerical value at value you switch to
  • Weapon refinement data
    • Weapon's numerical value at each refinement level
  • Weapon's most used by characters data provided by Hutao Database

Personal Information

The nature of Snap Hutao project states it does not collect any personal information data.

Regular Data Usage

Snap Hutao respects the privacy of users, and we're currently using data as described below:

• Once using Snap Hutao，the database file in the data directory

  • Store
    • MiHoYo BBS and HoYoLab cookie
    • Snap Hutao program settings
    • All other user data

• When using Snap Hutao, we collect anonymously logs data for development and statistical purposes when program stops unexpectedly or throw an error, including - User device ID - Error or crash log - Active user statistical data

• When using Hutao Database (Abyss Record/Abyss Stats) feature and select Upload Data

  • Upload data to Hutao API, including
    • User's in-game UID
    • User's Abyss record
    • User's character information including artifact and weapon data

• After using Real-time Notes features

  • Create a Windows scheduled task to fetch data timely

• After using server switch feature in Game Laucher, in Snap Hutao's data directory

  • Store game files for server switch usage

• After using Hutao Account features, Hutao Account system server will

  • Store
    • User registered email address
    • Encrypted password

General Provisions

• This "User Agreement and Legal Disclaimer" (hereinafter referred to as "Terms" or "User Agreement") applies to all software works developed by the DGP-Studio development team (hereinafter referred to as "the team" or "we"), the official website of each development project, and affiliated self-hosted media accounts.
  • Please read all the contents of this User Agreement carefully. If you have any objections to any terms of this User Agreement after reading it, please immediately stop using any projects developed by the team.
  • If you are under 18 years old, please read and fully understand this agreement with the accompaniment of a legal guardian, and obtain the consent of the legal guardian before using any projects developed by the team.
  • If you have installed, used, or referenced any projects developed by the team during development, it means that you have actively read (read it completely) and fully agree to the terms listed in this User Agreement, that is, you have fully understood this Agreement and promised to accept the constraints of the agreement, legal statements, privacy policies, rules, norms, statements, notices, and other content related to any projects developed by the team.
  • This "User Agreement" is a user agreement and legal disclaimer entered into by the user (hereinafter referred to as "you") and any projects developed by the team. This agreement has legal effect on both the user and the team.

Nature of the Project, Services, and Definition of Responsibilities and Obligations

1. As all projects developed by the team are "open-source" and "non-business" in nature, the team can make full decisions at any time, including but not limited to changing the "User Agreement" and modifying any content within any projects developed by the team. If there are any changes to the "Terms" or the content of the works, we will post notices on the relevant project display website. The revised "Terms" will take effect automatically after they are published on the official website.

2. The development of this software is aimed at "learning development knowledge" and "accumulating development experience." All functions provided by all projects are "open-source" and "non-business" in nature. If you are dissatisfied with the security of any projects developed by the team, please uninstall/delete/stop using them immediately. If you continue to use them normally, it means that you approve of the security of any projects developed by the team.

3. Any "unexpected losses (including but not limited to: software, hardware, property, virtual items, etc.)", "contractual damage", "defamation", "copyright or intellectual property infringement," and the resulting losses and liabilities caused by the use of any content in any projects developed by the team are all "losses and liabilities" caused by the user's own use behavior of open-source software on the Internet. Based on the MIT license declared in all works at their open-source location (i.e., GitHub) and the content stipulated in this declaration, it should be deemed that the aforementioned "losses and liabilities" have no responsibility relationship with all the relevant developers of the projects.

4. During the user's use of any projects developed by the team, the team does not make any guarantees that do not occur under the following circumstances:

   • The user cannot use or update normally due to network conditions, communication lines, and other technical reasons;
   • Negative results caused by using "plug-ins in this software developed by a third party," "modified versions of this software compiled by a third party," and "software compiled by reusing project code created by this development team."

5. Users acknowledge that any project developed by our team requires active user trigger for any information upload, except for necessary upload reports or related information in passive receipt of software or other related projects.

   • Users acknowledge that any project developed by our team fully respects and protects the "personal privacy rights" of all users. The project code is also fully open, and users do not have subjective reasons to accuse the development team or team members of "violation of privacy rights".
   • Any personal information of users will not be shared or transferred to third parties by any project developed by our team, unless with the user's prior authorization or the shared and transferred personal information has been de-identified and the third party cannot re-identify the natural person subject of such information.
   • Any project developed by our team contains links to other sites. When you visit third-party links, please read the user agreement and statement of the third-party site carefully. Our team is not responsible for the content, privacy terms, and usage agreements of third-party sites.
   • When using any project developed by our team, we cannot guarantee that the information you submit will be saved successfully. You need to properly store and keep the information you submit. Some projects developed by our team provide storage for "authorized data," but there are various force majeure factors in the storage process. Our team cannot promise to keep users' stored information indefinitely. Please back up your important information yourself.

Rights and Obligations

6. Our team allows any individual or organization to conduct secondary development, functional modification, and reuse of our code for other projects without our team's authorization, for any project developed by our team. However, we reserve the right to pursue legal action against any infringement of our team's computer software copyright.

   • Our team shall not be responsible for any consequences resulting from the public release of the contents of any project developed by our team (including but not limited to video production, articles with content of this software, uploading to download sites not designated by our development team, etc.) by any individual or organization using the project developed by our team.
   • Our team shall not be responsible for any consequences resulting from the use of "third-party subsidiary programs or additional code that can be used for any project developed by our team", "modified versions of any project developed by our team that have been compiled by third parties", or "software compiled using the project code created by our development team".
   • Based on the legal definitions of "computer software" and "documents" in Article 2 and Article 3 of the "Regulations on the Protection of Computer Software," DGP Studio reserves all computer software copyright for all of our development projects. This includes but is not limited to all information necessary to construct the project and all document data related to the project (i.e. program design specifications, flowcharts, user manuals, etc.), with the actual content subject to the "Computer Software Copyright Registration Certificate" for each project.

7. Any project developed by our team is only intended for lawful and compliant learning and research use and shall not be used for illegal activities.

   • Our team is only a development team (not a legal entity composed of natural persons), and shall not be held responsible for any joint liability for any use of the software or any project developed by our team that results in any legal consequences.
   • If a user has already started using any project developed by our team, it means that they have agreed to the "Usage Agreement" and that our team has already fulfilled the notification requirements in Section 10 of this Usage Agreement.

8. Copyright of the developed projects.

   • Our software development team holds the ownership of all trademarks in the software itself (excluding display content other than functional modules), all historical versions of the aforementioned works, and the surrounding websites. We also hold any related rights and interests regarding copyright.
   • All statistical data of any project developed by our team comes from users who submit data voluntarily. After the data is screened, it is displayed. Therefore, our team is not responsible for the accuracy of the data, and the data is not related to us.
   • During the use of any project developed by our team, there may be data that has original copyright. For these data, our team does not own their ownership. In order to avoid infringement, the user has the obligation to fully read and comply with the content of Section 10 of this Usage Agreement. The resources used in this software (including but not limited to fonts, images, and text) are from public information on the Internet. If infringement occurs, you can contact us at our GitHub to remove it.

Other Terms

9. Determination of "Non-Business Nature" of Projects Developed by the Team.

   • Any project developed by the team has no business nature.
   • If individual or certain members of the development team, during their participation in the development of any project developed by the team, have entered into relationships with third-party users, including but not limited to gifts, exchanges, sales, etc., the resulting relationships are unrelated to the development team. This occurrence is not based on the fact that the team developed a related project, but rather on independent events that occurred at the location where the user entered into the aforementioned relationship on the Internet or in reality. The nature of this behavior should be determined based on the user terms of use at the Internet interaction location where the aforementioned relationship occurred, or in combination with specific behaviors that occurred in reality.

10. Any project (including websites) developed by the team is developed for the purpose of "learning development knowledge" and "accumulating development experience," and is only for learning and communication purposes. It is strictly prohibited to use it for commercial purposes. After downloading or viewing the learning materials, please delete all related information within 24 hours. If you ignore this requirement, the software development team is not responsible for "possible copyright disputes, infringement of intellectual property rights, and civil disputes."

11. The establishment, effectiveness, performance, interpretation, and dispute resolution of this agreement shall be governed by the laws of the mainland of the People's Republic of China. If any provision of this agreement conflicts with the laws of the People's Republic of China and is invalid, these provisions will be reinterpreted as closely as possible to the original intent of this agreement. The other provisions of this agreement shall remain in full force and effect.

12. The place of signing this agreement is Liaohe Oilfield Mining Area, Panjin City, Liaoning Province, China. If a dispute arises in the performance of this agreement, the parties shall resolve it through consultation. If no agreement can be reached through consultation, the Liaohe People's Court shall have jurisdiction, and the appellant shall bear the costs of each stage immediately.

13. The titles (including subtitles) in this agreement are for convenience and reading only and do not affect the meaning or interpretation of any provisions of this agreement.

14. Both you and the development team are independent entities, and under no circumstances does this agreement constitute any express or implied guarantee or condition of the development team towards users. There is also no agency, partnership, joint venture, or employment relationship between the two parties.

15. In this "User Agreement and Legal Statement," the term "our party" or "the development team" (as distinguished from "you" or "the user") refers to the entire team of DGP-Studio Development Team, including each individual member.

Snap Hutao offers local achievement management feature, users can view and manage status of achievement

• At first time use, you will follow the instruction to create an archive and name it
• After that, you are still able to make new archives by click on Create New Archive for other game accounts

Achievement Import

• Snap Hutao is using Uniformed Interchangeable Achievement Format Standar to store user's achievement data
  • This standard allows user to transmit achievement data between Snap Hutao wiht other achievement tools, such as Achievement exporter
• You can click on Import at top right menu on Achievement Management page, and select file import to load UIAF formatted data

Achievement Tools We Recommend

• YaeAchievement

• 椰羊 cocogoat

Gacha is one of the core gameplay in Genshin Impact. Whether it's for commemorative and show-off purposes, or for serious planning for a gacha strategy, it's very important to perform statical analysis on historical gacha record. However, Genshin Impact only provides players with six months of gacha records, which is not user-friendly (although they still keep tracking how many Timmie's pigeons you've killed for the whole year)

Therefore, we need to use the gacha records from these six months to retrieve the data and transfer the record to our local device. This is the purpose of wish history export feature in Snap Hutao.

Regarding the technical principles of exporting Genshin Impact gacha records, you can refer to our article on Gacha System and Export Principles

As shown in the above figure, through the wish history feature in Snap Hutao, you can clearly obtain the following information: total number of wishes, current pity count, quantity and percentage of obtained items with different rarity, number of times a 5-star rarity item was not obtained and the current pity status.

Fetch Wish History

Refresh with Stoken Cookie

• Make sure the account you want to refresh wish history has been signed in to Snap Hutao
• Switch to Wish History feature page in Snap Hutao
• Click on Refresh button and select SToken Refresh
• Wait for refresh task to complete

Refresh with Web Cache

• Switch to Wish History feature page in Snap Hutao
• Start the game, go to in-game wish history page
• Go back to Snap Hutao, clock on Refresh button and select Refresh with Web Cache
• Wait for refresh task to complete

Refresh with Manually Input URL

• If you get your personal wish history URL, you can select Manual Input and submit your wish history URL
• Be aware that the URL is time-sensitive

Explanation on Full Refresh Option

By default, Snap Hutao will stop importing gacha records once it matches a Wish ID that already exists locally. However, if you wish to obtain all the historical records from the Genshin Impact servers (even if they are already present in your local wish history), you can check the "Full Refresh" option.

Not selecting Full Refresh will not cause you to lose your wishing data, and selecting Full Refresh will not cause your local records to mistakenly record the same wishing data twice.

Import Wish History Data from Other Applications

Snap Hutao supports importing wish history data file that in UIGF data format^[1]

Export Wish History Data

Snap Hutao support exporting wish history data to a Json file written in UIGF data format

If you need to export the wish history data, you can:

• Start Snap Hutao, switch to Wish History feature page
• Switch to the archive you want to export, and select Export
  • In the pop-up window, confirm your export path
• Confirm and export data

Recommended Method

• You can submit bug reports when you find reproducible issue that cannbot be fixed by youself
• When submitting the issue, you should describe the problem in as much detail as you can.Screenshots of error should be attached if you have.This is help us to identify the issue faster.
  • A good example is DGP-Studio/Snap.Hutao/issues/100
• If you are able to fix the issue from code, you are also welcome to make PRs directly.

Client Issue

• Check if the document already answered your issue

  • Make sure you are in the latest version
  • You can check FAQ document in the sidebar
    • FAQ

• Open an Issue

  • github.com/DGP-Studio/Snap.Hutao/issues/new/choose

• Open Issue on QQ Support (zh-CN only)

  • support.qq.com/products/451231

Request New or Update Document

• Open issue on GitHub: DGP-Studio/Snap.Hutao.Docs

Snap Hutao is an MIT-licensed open-source project that provides a Genshin Impact Toolset on Windows, aiming to provide a better experience on PC gaming. It makes undestructive feature expansions on desktops by making features that Genshin Impact provides only on mobile applications.

Feature Migration

Snap Hutao project was originally from the Snap Genshin project. Currently, we are still migrating features.

Documents will be provided on this website for all migrated features. The migration process is shown below:

• In-game announcements
• MiHoYo BBS account management
• Game Launcher
• Wish history export
• WIKI - Daily Materials
  • Will be integrated to Dev Plan feature
• WIKI - Weekly Materials
  • Will be integrated to Dev Plan feature
• WIKI - Characters
• WIKI - Weapons
• Achievement
• Hutao Abyss Database
• Dev Plan
• My character stat
• Players stat
• Custom browser

New features

The following features are planned to add when the project was established.

• Wish history cloud sync
• Localization
• International server support
  • Game Launcher
  • Server Switch
  • Wish history export

If you believe Snap Hutao is a good project and helps you, you can support us by the following ways

• Star our project on GitHub ⭐
  • Snap.Hutao
  • Snap.Hutao.Docs
• Rate our App on Microsoft Store
• Promote our project in your network

Video Tutorial

For most people, follow the instruction on this page is more effiency.

However, if you are not familiar with the operation mentioned below, you can come back the follow the video tutorial.

Minimum System Requirements

Download Snap Hutao

Whatever installation method you used, package source and registration are always handled by Microsoft Store.

Upgrade to MS Store Version from Sideload Versions

• Uninstall the sideload version with our uninstallation instruction document
  • You data will not lose as long as you don't delete data directory manually
• Follow the method above to install the Microsoft Store version application

Update Snap Hutao

You can use any of the update methods, whatever method you used when you installed Snap Hutao. They don't need to be consistent, as Microsoft Store is the only source of packages.

Installing WebView2 Runtime

WebView2 Runtime is provided by Microsoft, which enables a built-in browser at a low resource cost inside the program. As an optional component, WebView2 is not a mandatory component, but it will make some Snap Hutao's features easier.

At the bottom of the Microsoft official page, you can findEvergreen Standalone Installer, choosex64download and install as prompted