Snap Hutao is using C# and .NET Framework to develop both client and server. If you are willing to contribute your code to the project, please read the following guidelines.

You can find all unsolved opened issues on GitHub

1. Download and install Visual Studio 2022 Community
2. Open Visual Studio Installer to complete Visual Studio installation
   • You need to install .NET desktop development, Desktop development with C++ and Universal Windows Platform development components
3. Install Single-project MSIX Packaging Tools for VS 2022 provided by Microsoft in Visual Studio marketplace
4. Use git to clone the project https://github.com/DGP-Studio/Snap.Hutao.git to your local device
5. Switch git branch to develop
6. Open project solution with your Visual Studio and then you are ready to go

1. Download and install Sysinternals Suite from Microsoft Store or Microsoft website
2. Locate and run DebugView program in the installed app list or unzipped folder
3. Run Snap Hutao client
4. Check DebugView output

• All code-related changes from authors' own branches are only allowed be merged to develop branch
• Please use keywords to link your PR or commits with issues, so issues can be automatically closed once commits are merged into main branch.

Once the code in updated in develop and main branches, an Azure Pipeline CI script will build the latest code to Snap Hutao Alpha package. Once the package is built, it will be released on GitHub Release page as a pre-released package.

You need to install Snap.Hutao.CI.cer certificate to your local machine, and then install the msix package in the release.

*If the latest release does not contain attached file, that means package is still in uploading process.

Snap Hutao relies on Windows App Runtime as a dependency, when user's system is missing this environment, Windows will install this framework before Snap Hutao's installation.

If you are in a poor network, you may slow or even stuck at framework installation stage. In such a scenario, you can download the framework from Microsoft website and install it manually.

1. Visit Microsoft document page：Latest downloads for the Windows App SDK
2. Click on Dwonload the latest x64 stable installer to download the offline installer
3. Run Windows App Runtime installer you just downloaded, and then install Snap Hutao

Monster WIKI is an embedded WIKI database used to look up each monster's Base ability, ability in each level, RES, drop items

Included Data

• Monster list
  • Use the icon above the list, you can change the view between list and grid
  • Click on monster's icon or title, and you will be directed to its WIKI page
• WIKI data
  • Monster's ability
    • Monster base HP, base ATK, base DEF
    • Monster's HP, ATK and DEF in each level switched to
  • Drop items

When launching the Snap Hutao for the first time, the client will automatically enter an initialization setup guide to assist users in configuring the client correctly.

Currently, Snap Hutao will guide users through the process of setting the language, confirming user agreements, checking necessary environmental configurations, and downloading static resources.

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

Developers can ask for access in Snap Hutao development group chat or discord group from administrator.

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.

Gaming data dashboard includes:

• Snap Hutao Announcement
  • If Snap Hutao dev team publish a new announcement, it will be shown on the dashboard, it can be manually closed
• Snap Hutao Account
  • If you have a signed in Snap Hutao account, the email address will be shown on the top; If not signed in, there will be a register/login hint
• 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

Verify Current User and Role

If you are using a MiYouShe account, then you account is very likely to be marked as robot-usage and leads to an anti-bot verification. In this status, Real-time Notes data cannot be updated.

You can click on Verify Current User and Role button, Snap Hutao will pop up verification window. After finishing the verification, then your account can be used to refresh data.

Global Notification Settings

• In the Notification Settings on the top right, you can change the global settings of Real-time Notes, including:
  • Enable/Disable auto refresh
  • 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

You can view all issues on GitHub Issue page

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

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

    Tips

If the risk prompt is too frequent, or the verification cannot be triggered at all, it means that the risk of your account is too high, please change the password, so that the simultaneous login status of multiple devices will be reset

:::

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.

You can also execute the following PowerShell script to remove all container loopback limits

Error Finding Required Modules

When user launching game with unlock frame-rate feature on, the game may be failed to be launched with the following error shows up:

1. Error finding required modules: could not read any module, the protection driver may have been loaded
2. Error finding required modules: timeout

This issue only occurs when Genshin Impact's anti-cheat module starts earlier than frame-rate-unlocker module. When these errors happen, Snap Hutao will exit game process, and you can re-launch the game.

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 (with no admin privilege)

• 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

Starting from Snap Hutao 1.7.4, you can create a desktop shortcut with Administrator privilege by click Create Desktop Shortcut in the settings page.

You can move this shortcut to any place you need.

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
  • Change of network adapter or network adapter MAC 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

How to Recover config.ini Configuration File

In some particular conditions (such as wrong game folder permission), config.ini may lose after server conversion. This will cause user not able to get into advanced launcher page and launch the game.

After identify the server version on your device, you can manually create and fill the configuration file with the right content. The following are common configurations.

How to Fully Backup/Recover Client Data

Copy Userdata.db from Snap Hutao data folder (%userprofile%/Documents/Hutao by default) to your backup location, this file contains entire data of the client.

1.7.11

• Fixed the game launching arguments error (hotfix)

1.7.10

• Fix
  • Fixed login issue with HoYoverse account #1011 #1012
  • Fixed daily check-in issue on HoYoLAB account #1013
  • Fixed issue that Invalid item error show up when language does not match in UIGFv2.2 data file #1001
  • Fixed crash issue when an invalid CAPTCHA Url is input in the setting
  • Fixed crash issue when an invalid channel setting is given when launching the game
  • Fixed crash when switching account while WebView2 Runtime version is too low to have necessary feature
  • Fixed crash issue when an invalid record is displayed in Spiral Abyss page
  • Fixed a memory overflow issue in embedded pages
• Optimization
  • Current game account now can be automatically identified when reaching the game launcher page

1.7.9

• Fix
  • Fixed an issue that prevented the program from launching with the correct window size after the monitor resolution was changed after exiting the program
  • Fixed login issue of MiHoYo BBS #1005
  • Fixed HoYoverse login issue #1007
  • Fixed crash log upload issue in version 1.7.7
  • Fixed UI display issue on Team Lineup page in Spiral Abyss feature #1008

1.7.7

• Added card shadow in the following elements to optimize visual effect
  • Dashboard and in-game announcements
  • Download resource card in advanced game launcher page
  • Overview card in wish export page
  • Statistics card in wish export page
  • Real-time note card
  • List view in my character page
  • Image card in character WIKI
  • Image card in weapon WIKI
• Fix
  • Fixed top margin error under grid view
  • Fixed grid view crash issues from multiple causes
  • Fixed server conversion issue from CN server to Bilibili server
• Optimize
  • Optimize button position for manual account validation
    • You can now find it directly from account panel
  • Added retry logic for fetching abyss record and record upload
    • User who does not set up CAPTURE verification API can retry after manually validating account from account panel

## 1.7.6

• Add
  • Added mouse auto click feature triggered by F8, under Administrator privilege mode
    • In the upcoming Genshin Impact 4.1 and 4.2 version, this feature may help you skip some task conversation you dislike
• Fix
  • Fixed crash issue when switching account after validating cookie on Realtime Notes page #947
  • Fixed failure of matching current in-game account after rebooting Snap Hutao and game client #865
  • Fixed display issue on Achievement page #956
  • Fixed an issue that Genshin Impact 4.1 version metadata will cause program to crash on Spiral Abyss page
• Optimize
  • Optimized some user interface details on some pages
  • Optimized announcement text color in some particular situation
  • Optimized download logic of downloading static images

1.7.5

• Add
  • Added version number for each achievement
  • Added monster waves data in Abyss Data page (data provided by @妮可少女)
  • Added Microsoft Store rating button on settings page #876
  • Added a document button above user panel, user will be redirected to current page's document when click on it #875
• Fix
  • Fixed game launcher card on dashboard showing empty account issue #924
  • Fixed achievement status cannot be saved when be manually unchecked #880
  • Fixed issue that Realtime Note verification on wrong MiHoYo BBS account
  • Fixed issue that sometime spiral abyss statistics data are missing
• Optimizations
  • Optimized some error messages, added solution hints #930
  • Snap Hutao Announcements content on dashboard now is copyable #929
  • Abyss Stats page is now merged into Abyss Records page
  • Optimized time format in multiple places

1.7.4

• Add
  • Added option to change PowerShell entry in settings page
  • Added option to create desktop shortcut in settings page #912
  • Added option to switch display of cards on home dashboard
  • Added batch-add to Dev Plan option on My Character page
• Fix
  • Fixed an issue which event start time is not accurate on Home Dashboard #887
  • Fixed an issue on My Character page that caused crashes when clicking on weapon that is not synchronized by Enka API #904
  • Fixed an issue of weapon value display error on My Character page #907
  • Fixed an issue where Bilibili server cannot be converted to some other servers #893
  • Fixed an issue where fetching Novice Wish history will cause the program to crash #917
  • Fixed an issue where a Dev Plan was not pre-selected before entering the Dev Plan page, which had caused the Dev Plan page to need to be entered at least once to add a Dev Plan archive
  • Fixed the issue that failed to claim checkin reward when triggered anti-bot verification, even when anti-bot API returns success result
• Optimize
  • Optimized monsters' display order on Monster WIKI page
  • Optimized launch speed of Wish History page
  • Optimized local database thread on UI display functions
  • Optimized the scrolling experience for some views of Dev Plan, it may now take longer for views to be loaded

1.7.3

• Fixed the issue of HoYoverse web login not working
• Upgraded the Windows App SDK version to fix the issue where the top of the title bar could not resize the window
• Adjusted the prompt for UIGF v2.2 file import failures, now allowing for faster issue identification based on IDs
• Fixed the issue where the user panel would display a successful claim of login rewards even if it failed
• Fixed the problem where launching the game from the taskbar would open both the game window and the main program window simultaneously

1.7.2

• Wish Export
  • Fixed an issue where full refresh was not working correctly.
  • Fixed an issue where no-error UIGF files were not being imported correctly
  • Fixed an issue where Hutao Cloud records were not being retrieved correctly
  • Adjusted the UI of the Hutao Cloud window to display the number of wishes corresponding to the UID archive
• My Characters
  • Adjusted the UI to make it more compact
• Adjusted the UI of the homepage notifications to align them with the right edge

1.7.0

• Add a startup guide to help user familiarize Snap Hutao on start launch
  • Guiding users to select a language
  • Guiding users to confirm terms of service
  • Guiding users to install Segoe Fluent Icons font and WebView2 Runtime
  • Guiding users to download static assets
• Main Interface
  • Adjusted icon styles in the navigation bar
  • Fixed a bug where adjusting window size could lead to unexpected crashes
• User Panel
  • Adjusted styles of the user panel
  • Added a button to allow the current user to claim sign-in rewards
  • Fixed an issue where in some cases, the current user and character could not be selected correctly on startup
• Home Dashboard
  • Added Snap Hutao announcement
  • Real-Time Note now display refresh time for each card
  • Fixed an issue where Real-Time Note card fail to load correctly, leading program to freezing or crashing
  • Corrected start/end times for certain event announcements
  • Fixed an issue where some paragraphs were not displaying correctly when viewing details of certain announcements
• Game Launch (Advanced Launcher)
  • Added game status indicator text to the command bar
  • Fixed an issue where server switch function was not working
  • Adjusted server switch function logic to allow retries after resource download failure
  • Adjusted unlocked frame rate logic; game process will automatically end if unlocking fails
  • Removed multi-client
  • Fixed an issue in resource download page where game client had no names and couldn't be downloaded
• Wish History
  • Adjusted card style on the overview page, making items larger and collapsing multiple text items
  • Fixed an issue where entering the wish history page without logging in or without Snap Hutao Cloud service caused errors
  • Fixed progress bar and color display issues in the card list view on the overview page
  • Fixed incorrect text for Snap Hutao Cloud's upload reward
  • Fixed the issue that UIGF formatted data file with incorrect item ID can be imported
  • Fixed the issue that failed to locate game cache directory
  • Optimized page load speed when there is a large amount of items
• Achievement
  • Fixed a display issue that occurs after selecting achievement categories in list/grid view and switching to the other view type
  • Optimized page load speed
• Real-Time Notes
  • Adjusted the style of the Verify Current User and Role button
  • Adjusted the style of the notification settings view
  • Added an option to disable auto-refresh for real-time notes (toggle available only in non-administrator mode; users who have previously accessed the real-time notes page in administrator mode might not be able to toggle this option)
  • Adjusted the style of real-time notes
  • Adjusted text prompts for locked Serenitea Pot and unowned Parametric Transformations
  • Added previous refresh time for each Real-time note cards
• My Characters
  • Adjusted width of character list when using list view
  • Added a button to toggle display of refresh time in command bar
  • Added previous refresh time for each refresh function
  • Added display of times artifacts were enhanced in character details
• Dev Plan
  • Fixed issue failure of saving active archive when switching page from dev plan to others
• Character WIKI
  • Fixed a display issue that occurs after selecting character in list/grid view and switching to the other view type
• Weapon WIKI
  • Fixed a display issue that occurs after selecting weapon in list/grid view and switching to the other view type
  • Added ascension material section for each weapon
• Monster WIKI
  • Fixed a display issue that occurs after selecting monster in list/grid view and switching to the other view type
• Settings
  • Fixed issue that unable to clear game cache directory
  • Added configuration field for Geetest CAPTCHA verification API, correct configuration on this field can handle anti-bot verification from MiYouShe
• Improved program frame rate performance
• Optimized memory usage for multi-thread scheduling
• Optimized loading speed of item image assets
• Adjusted database read/write methods to optimize memory usage and responsiveness
• Adjusted text prompts for return codes -100 and -10001 to help users better understand their meanings
• Other minor changes

1.6.6

• New
  • Snap Hutao Cloud tab will show expiration time and developer's license on the wish history page now
  • Wish statistics are now available on the wish history page, with data supported by Snap Hutao Cloud
• Fix
  • Fix failure of web cache refresh method for wish history export
  • Fix Traditional Chinese metadata loading error

1.6.5

• New
  • Japanese is now a new language option; community members can contribute Japanese language on translate.hut.ao
• Fix
  • Issue that cannot add weapons to dev plan Issue #745
  • Issue on some users failed to unlock frame rate limit under certain environment Issue #747
• Optimize
  • Refine dashboard UI
  • Introducing Metadata v2
  • Sorting order of materials in dev plan Issue #749

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

Snap.Hutao Discussion

• Snap Hutao
• Snap Developer Open Discussion Group
  • General tech talk, not Snap Hutao Project development group
  • The Dev group requires some basic tech knowledge

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 (in progress)
    • 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

Add Develop Goals into Material Checklist

Add Goals from WIKIs

• Click Character WIKI or Weapon WIKI from the left menu bar
• Select on character or weapon to want to add
• Click Add to Dev Plan on the top right
• In the pop-up window, input the base level and target level
  • By default, add goals from WIKIs will set base level as 1

Add Goals from My Characters Data

• Click My Characters from the left menu bar
• Select the character you want to add
• In the pop-up window, input the base level and target level
  • By default, add goals from WIKIs will set base level as player's live data'
  • Refer to My Characters document to get more guides

Inventory Items

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

• 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
    • You should only use this option when you are able to independently describe technical principles and effects of exclusive fullscreen
  • 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

Resource Download

Game launcher in Snap Hutao also offers resource download feature, which lists real time Genshin Impact (CN server) client package and OTA package. User can click the hyperlink icon on each package's right side to redirect to browser to download them by user favored download tools.

When you are updating the game client, you can do the following steps:

1. Update official launcher to the latest
2. In Snap Hutao - Game Launcher - Resource Download, find needed client OTA package and installed language OTA package
3. Move all package to folder where game client located
4. Start official launcher, click on update button. The launcher should skip the download and directly starts to unzip the OTA packages to update client

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

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

Data Sharing

Snap Hutao is contributing data to Hutao Database with other developers. You can view our Abyss Stats, and upload your Abyss data in multiple applications other than Snap Hutao. Currently, Snap Hutao is sharing Abyss data with following applications:

1. Miao-Plugin for Yunzai-Bot
2. Pizza Helper for Genshin
3. WeChat Mini Program: Ysin

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.

Shell Experience

• Create Desktop Shortcut
  • Snap Hutao will create a shortcut with Administrator privilege on user's desktop

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

Home

• Dashboard Card
  • You can click on this option to switch display of card on Home Dashboard
    • Game Launcher
    • Wish History
    • Achievement
    • Realtime Notes

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

• PowerShell Path

  • Snap Hutao uses PowerShell to modify Genshin Impact registry field to switch game account. This option allows user to select PowerShell path to fix issue when PowerShell path is unable to located automatically

• 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

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

Geetest Verification

MiYouShe uses Geetest verification to block requests not from real human operations, so some requests from Snap Hutao, such as claim check-in reward and fetch Real-time Notes data may be failed due to marked as robot operation. If you have a third party service to bypass Geetest verification, you can config this setting to pass verification parameters to service provider you used.

Successfully config this setting will help Snap Hutao pass verification when fetching data from Real-time Notes and claiming check-in rewards, and avoid -1034 error from MiYouShe.

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

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
  • After select an account in the panel, you can also
    • Click Refresh Cookie to update local cookie
    • Click Claim Check-In Reward to get daily check-in reward. For MiYouShe account, you need to bypass Geetest verification first.

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 ascension materials
  • 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

Trustable Domains

Snap Hutao project is holding the following domains, they are trustable in this project scope, please be wary of information provided by domains outside this list (including websites, emails, etc.)

• hut.ao
• snapgenshin.com
  • We only use this domain for system emails
• dgp-studio.cn
  • We only use this domain for public email contact
• snapgenshin.cn
• hutao.ao
• snaphutao.com

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.
   • Snap Hutao program and hut.ao website are not affiliated with miHoYo.
   • The copyright of Genshin Impact's game content and various materials and trademarks belongs to miHoYo.

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.

Additionally, user with Hutao Cloud can view prediction data calculated by Hutao Cloud server

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

Wish History Cloud Sync

Wish history cloud sync is designed on Snap Hutao Account. You need to register an account in the settings to use this feature

With this feature, you can upload your wish history to Hutao Cloud, to avoid risk of losing data, and make it easier to transfer data between devices.

Cloud Sync Privilege

Cloud synchronization is a service uses Snap Hutao's server resource, so it is a time-limited feature. Currently, you have the following ways to enable Cloud Sync:

1. Donate us on AiFaDian. The privilege will automatically assigned to Snap Hutao Account with same email address on AiFaDian
2. For all registered user, after upload Abyss record in each schedule, 3-day privilege will be automatically assigned
   • This is a method you can constantly use benefit of Hutao Cloud
3. Users who make contributions to our open-source community, including code development, program designing, localization translations, can contact the dev team to get your benefit for free
   • We are designing an automation system to auto assign license to our contributors, it will be live with more development of Hutao Cloud

After your Hutao Cloud privilege expired, you will not be able to upload, download or delete your data, but your data will not be removed. You can continue to operate it once you get your privilege again.

Upload

• In wish export page, select the archive you need to sync data
• Click Snap Hutao Cloud button on the top right
• Click Upload Current Wish Archive, and then your data will be backup to the cloud

Download

• In wish export page, Click Snap Hutao Cloud button on the top right
• Click download button on the right side of UID which data needs to be downloaded

Delete

• In wish export page, Click Snap Hutao Cloud button on the top right
• Click delete button on the right side of UID which data needs to be deleted

You can submit bug reports when you find reproducible issue that cannot be fixed by yourself

Before submitting your issue, please do the following checklist:

• Make sure you are in the latest version of Snap Hutao
• Check FAQ document and known issues document
• Search current issues in the project to see if there is same or similar issues

If you don't get a solution from the above checklist, you can start a new issue on GitHub

If you need some examples of good issues, you can check them here

• Submit your issue on GitHub
  • github.com/DGP-Studio/Snap.Hutao/issues/new/choose
• You should include these information in your issue:
  • Your device ID
  • Your operating system version
  • Describe your issue in details, so the developer can replicate your problem
    • How the issue being triggered?
    • Is there any error or warning message from the program or your OS?
    • Have you done any debug process by yourself? What's the outcome?
  • If your issue is about program crash, you need to find .NET error on Snap Hutao in your Windows Event Viewer, and include it in your issue

Request Document Update

If you think Snap Hutao document is missing some information or contains errors, you can start an issue on Snap.Hutao.Docs project

• Submit your issue on GitHub：DGP-Studio/Snap.Hutao.Docs

Snap Hutao is an open-source Genshin Impact toolkit under MIT license, designed for modern Windows platform to improve the gaming experience for desktop players. By combining existing official resources with new features designed by the development team, it provides a complete and useful set of tools without the need to rely on mobile devices. Snap Hutao does not take any destructive modification to the game client to ensure the security of the toolkit.

Project Resource

• GitHub code repository
• Crowdin localization translation
• Snap Hutao Community

Feature Overview

• In-game announcement & event countdown
• MiHoYo BBS multi account login
  • Support using web login or Cookie input to sign in to MiYouShe and HoYoLAB
  • Support daily checkin
• Advanced game launcher
  • Game server convert er
  • Game account switcher
  • Customized frame rate limit
  • Game patch download
• Wish history management
  • Refresh data from game
  • Import and export UIGF format data file
  • Global wish statistics
• Achievement management
  • Export achievement data from game
  • Import and export UIAF format data file
• Real-time Note
  • Support multi account real-time note
  • Customized refresh cycle
  • Windows native style notification push
• My Characters
  • Support multiple source synchronization
  • Artifact rating & CRIT rating
  • Export my character data as image to clipboard
• Spiral Abyss
  • Details of monster and blessing for each schedule
  • Sync detailed battle data for current schedule and store data in local device forever
  • Hutao Database (Spiral Abyss Database)
    • Character usage rate
    • Character appearance rate
    • Team lineup count
    • Character constellation
• Development Plan
  • Support to initial dev plan from my characters' data and WIKI data
  • Support multiple archives
• WIKI data
  • Character WIKI
  • Weapon WIKI
  • Monster WIKI
• Snap Hutao Account
  • Wish data backup
  • Wish stat-based prediction

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

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