Fun/Snap.Hutao.Docs
1
0
Fork 0
mirror of https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git synced 2025-11-19 21:16:31 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update docs

Browse Source
This commit is contained in:
Masterain
2023-12-28 23:10:43 -08:00
parent a6cb9f3ab5
commit 50afafa081
5 changed files with 139 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

153
docs/en/advanced/FAQ.md
View File

@@ -8,11 +8,80 @@ order: 1
# FAQ
## How to create desktop shortcut (with no admin privilege)
> Please use **search bar on the top right** or **browser built-in search `(ctrl+F)`** to search keyword such as error code to improve your searching efficiency
## Installation FAQ
### 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
- You can also download and install the [dependency](dependency.md) manually
### Mojibake in Snap Hutao Icons
- 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](https://aka.ms/SegoeFluentIcons)
### Snap Hutao Throws Failed to add Scheduled Task Error
Open Windows Task Scheduler, find and delete `SnapHutaoDailyNoteRefreshTask` task
### My Computer Cannot Open MSIX Format Installer
Your computer is missing the App Installer, an important component of the Windows system.
If Microsoft Store is installed on your system, you can restore this component by reinstalling it from the [App Installer Store Page](https://apps.microsoft.com/detail/9NBLGGH4NNS1?hl=en-us&gl=US).
If you don’t have Windows Store, please use the latest full version of Microsoft’s official consumer version [Windows 10](https://www.microsoft.com/zh-cn/software-download/windows10) or [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11) mirror. Using the Windows 10 Upgrade Assistant and Windows 11 Installation Assistant provided by Microsoft can help you simply upgrade to the latest full version of Windows while retaining your data.
### Got `This app package’s publisher certificate could not be verified` Error when Install with MSIX Package
This issue is commonly seen in Home Edition of Windows. If you are not using a Home Edition, your Windows Update module may be disabled or cracked, this cause worldwide CA certificates cannot be updated from Microsoft servers.
Snap Hutao's code signing certificate comes from [GlobalSign Code Signing Root R45](https://support.globalsign.com/ca-certificates/root-certificates/globalsign-root-certificates), you can manually download [this CA certificate](https://secure.globalsign.com/cacert/codesigningrootr45.crt) from GlobalSign official website.
### Got `Policy check failed` Error when Install with MSIX Package
If you are using Windows Home Edition, please try to enable developer mode in your system settings and try the installation again.
### Got Error Prompt or Error Code when Install with MSIX Package
| Error | Reason |
| ------------------------------------ | -------------------------------------------------------- |
| `0x80040154` Error Code | Broken Windows account permission |
| `The app did not start` Error Prompt | Cracked App Installer or broken App Installer permission |
| `0x80073CF0` Error Code | Broken folder permission |
| `0x80070005` Error Code | Broken Windows account permission |
| `0x80070570` Error Code | Broken Windows account permission |
| `0x8007065E` Error Code | Broken Windows account permission |
If you got any of error showing above, please use the following steps to solve the issue:
1. Manually download and install [Snap Hutao Dependency](dependency.md)
2. Right click on Windows Start button, and select `PowerShell (Admin)`
3. In the PowerShell windows, copy and paste the following command and run it (Right-click is paste feature in PowerShell)
```PowerShell :no-line-numbers
cd $env:USERPROFILE\Downloads; $url="https://api.snapgenshin.com/patch/hutao/download"; $targetFileName="Snap.Hutao.latest.msix"; $targetFilePath=Join-Path -Path $PWD -ChildPath $targetFileName; Invoke-WebRequest -Uri $url -OutFile $targetFilePath; Add-AppxPackage -Path $targetFilePath; Remove-Item -Path $targetFilePath
```
4. If PowerShell does not outcome any error message, then it means installation is successful. Please find `Snap Hutao` in your Start Menu and enjoy it.
### Can I Add Missing System Components to Install Snap Hutao
Probably not if you are asking this, because you are not familiar with your system.
You don't know how many components are missing. When you install the one that tell you in the error message, you will see next missing component in the next error message, endless.
### Starting FAQ
### How to Create Desktop Shortcut (with No Admin Privilege)
::: tip Community Power
Thanks to [solution provided by CzHUV](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12)。
Thanks to [CzHUV](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12) for the solution.
:::
@@ -21,21 +90,30 @@ Thanks to [solution provided by CzHUV](https://github.com/DGP-Studio/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
### How to Create Desktop Shortcut (With Admin 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.
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
### How to run Snap Hutao when Windows starts
**This is a workaround solution**
- Create a bat file, content refers to [this Issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184), 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
### 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
## Feature FAQ
### Use Snap Hutao to quick start the game
- Config the game launcher in the settings
- Pin Snap Hutao on taskbar
@@ -45,18 +123,7 @@ You can move this shortcut to any place you need.
- Select `Lauch Game`, you will be asked which account to start the game
## Use Snap Hutao with Network Proxy
Refer to [HttpRequestException Error (502)](exceptions.html#_502-bad-gateway) 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](https://aka.ms/SegoeFluentIcons)
## MiHoYo BBS Account often Lose Login Status
### 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
@@ -68,7 +135,7 @@ you can use `Refresh Cookie` in the account panel; You can also remove your acco
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
### 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:
@@ -79,30 +146,7 @@ this may cause Snap Hutao failed to check validation of the cookie
- 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](ttps://d.hut.ao/releases/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
### 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.
@@ -136,7 +180,26 @@ plugin_7_version=1.0.0
:::
## How to Fully Backup/Recover Client Data
## Network FAQ
### Use Snap Hutao with Network Proxy
> Snap Hutao has a well-designed cloud network structure, you should be able to get good network service wherever you are located
Loopback network are disabled for all Windows Appx container application (including Snap Hutao), so some modern network proxy software will cause container applications to lose Internet access, and lead to application errors.
If you need network proxy to use Snap Hutao, you have two ways to fix it:
1. Enable `TUN Mode` in your network proxy software
2. Use [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) to unlock Windows App Container Loopback limit
- If network security is not a concern for you, you can use the following PowerShell command to unlock all container loopback limit in your computer
```PowerShell :no-line-numbers
FOR /F "tokens=11 delims=\" %p IN ('REG QUERY "HKCU\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer\Mappings"') DO CheckNetIsolation.exe LoopbackExempt -a -p=%p
```
## Uninstallation FAQ
### How to Fully Backup/Recover Client Data
::: warning Data Security Warning
`Userdata.db` contains all client data, including MiHoYO BBS Cookie, please save the data file properly and do NOT share it