mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Update docs
This commit is contained in:
@@ -7,6 +7,7 @@ redirectFrom: /en/advanced/mihoyo-risk-tip.html
|
||||
---
|
||||
|
||||
# Common Program Exceptions
|
||||
|
||||
This document covers solutions of **foreseeable client error**
|
||||
|
||||
## RuntimeEnvironmentException
|
||||
@@ -34,14 +35,14 @@ This document covers solutions of **foreseeable client error**
|
||||
## 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
|
||||
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
|
||||
::: tip
|
||||
::: tip
|
||||
|
||||
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
|
||||
@@ -59,17 +60,29 @@ account is too high, please change the password, so that the simultaneous login
|
||||
:::
|
||||
|
||||
## 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](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](https://www.telerik.com/fiddler/add-ons) to remove
|
||||
[Windows APP Container Loopback limits](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback).
|
||||
|
||||
## 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.
|
||||
|
||||
@@ -10,4 +10,4 @@ order: 3
|
||||
|
||||
This document records known issues that **need to be fixed**.
|
||||
|
||||
All known issues before 1.7 version have been fixed
|
||||
You can view latest version of opened BUG report on [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG)
|
||||
|
||||
@@ -18,7 +18,7 @@ As open-source software, community power is an important part of the ecology of
|
||||
|
||||
## QQ Group (CN)
|
||||
|
||||
- [Snap Hutao](https://go.hut.ao/qun1)
|
||||
- [Snap Hutao](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153)
|
||||
- _Snap Developer Open Discussion Group_
|
||||
- General tech talk, not Snap Hutao Project development group
|
||||
- The Dev group requires some basic tech knowledge
|
||||
|
||||
@@ -28,19 +28,20 @@ comment: false
|
||||
|
||||
:::
|
||||
|
||||
- Enter Game Launcher page
|
||||
In the `General - Server` field, select the server you want
|
||||
Enter Game Launcher page
|
||||
In the `General - Server` field, select the server you want
|
||||
|
||||
- Current available serves options include:
|
||||
- Current available serves options include:
|
||||
|
||||
| Option | Server |
|
||||
| -------------- | --------------------------------------------------------- |
|
||||
| CN Default | Mainland China server |
|
||||
| CN NoTapTap | Mainland China server without TapTap account login method |
|
||||
| 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 |
|
||||
| Option | Server |
|
||||
| -------------- | --------------------------------------------------------- |
|
||||
| CN Default | Mainland China server |
|
||||
| CN Official | Mainland China server, no difference with previous row |
|
||||
| CN NoTapTap | Mainland China server without TapTap account login method |
|
||||
| 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
|
||||
|
||||
@@ -82,6 +83,7 @@ comment: false
|
||||
- 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`
|
||||
|
||||
@@ -3,7 +3,12 @@ headerDepth: 2
|
||||
icon: debug
|
||||
category: [FAQ]
|
||||
order: 2
|
||||
redirectFrom: [/advanced/exceptions.html,/advanced/mihoyo-risk-tip.html,/zh/advanced/mihoyo-risk-tip.html]
|
||||
redirectFrom:
|
||||
[
|
||||
/advanced/exceptions.html,
|
||||
/advanced/mihoyo-risk-tip.html,
|
||||
/zh/advanced/mihoyo-risk-tip.html,
|
||||
]
|
||||
---
|
||||
|
||||
# 常见的程序异常
|
||||
@@ -78,3 +83,11 @@ redirectFrom: [/advanced/exceptions.html,/advanced/mihoyo-risk-tip.html,/zh/adva
|
||||
- 网络请求错误,请求异常前程序会说明具体哪一个功能的网络请求失败。
|
||||
- 如果仅是偶尔出现的问题,你可以考虑忽略该错误
|
||||
- 如果持续该错误,请检查本地网络到目标服务器的连接是否正常
|
||||
|
||||
## 在查找必要的模块时出现问题
|
||||
|
||||
当用户在解锁游戏帧数限制的情况下启动游戏时,可能会遇上以下错误提示并启动游戏失败
|
||||
|
||||
1. 在查找必要的模块时遇到问题:无法读取任何模块,可能是保护驱动已经加载完成
|
||||
2. 在查找必要的模块时遇到问题:查找模块超时
|
||||
该问题仅当原神反作弊模块早于解锁帧率模块启动时出现。在出现该错误后,胡桃会主动关闭游戏进程,用户再次尝试启动游戏即可。
|
||||
|
||||
@@ -10,4 +10,4 @@ redirectFrom: /advanced/known-issue.html
|
||||
|
||||
该文档包含由所有已知问题和修复计划
|
||||
|
||||
1.7 版本前已知问题已全部修复
|
||||
你可以在 [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG]) 查看最新的来自社区的 BUG 报告
|
||||
|
||||
@@ -21,7 +21,7 @@ order: 8
|
||||
|
||||
> 若入群问题为最新版本号则请输入三位版本号(如 `1.2.3`)而不是四位版本号(如 `1.2.3.0`)
|
||||
|
||||
- [Snap Hutao](https://go.hut.ao/qun1)
|
||||
- [Snap Hutao](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153)
|
||||
- _Snap 开发交流群_
|
||||
- 广泛的技术交流群,并非胡桃工具箱开发群
|
||||
- 开发群对申请者的技术水平有一定要求
|
||||
|
||||
@@ -36,6 +36,7 @@ comment: false
|
||||
| 选项 | 服务器 |
|
||||
| --------------- | ------------------------------------------------- |
|
||||
| 官方服 Default | 中国大陆服务器 |
|
||||
| 官方服 Official | 中国大陆服务器,与上一栏无实质区别 |
|
||||
| 官方服 NoTapTap | 禁用 TapTap 帐号登录的中国大陆服务器 |
|
||||
| 渠道服 Default | 使用 BiliBili 帐号登录的中国大陆服务器 |
|
||||
| 国际服 Default | HoYoverse 国际服服务器 |
|
||||
@@ -82,6 +83,7 @@ comment: false
|
||||
- 在主界面点击左侧菜单栏进入`启动游戏`标签
|
||||
- 在`外观`功能中,有六个选项:
|
||||
- **独占全屏**,即选择游戏进程以独占全屏模式运行
|
||||
- **你应仅在能独立描述独占全屏的技术原理和效果的情况下开启本项**
|
||||
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
|
||||
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
|
||||
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
|
||||
|
||||
Reference in New Issue
Block a user