高级启动器

• 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏
• 你可以通过点击左侧菜单栏中的 “启动游戏” 进入高级启动器功能
  • 第一次使用时你会被跳转到设置页面以设置你的游戏路径
  • 选择游戏路径时，请注意此处选择的应是游戏本身（YuanShen.exe）而不是游戏启动器（launcher.exe）
    • 例如（仅作示范，请以实际情况为准）： C:\Program Files\Genshin Impact\Genshin Impact Game\YuanShen.exe
• 在设置完毕启动游戏所需的附加选项后，点击右上角的 “启动游戏” 按钮即可，附加选项请看本页下方的功能文档

切换服务器

权限提示

1. 使用该功能时需要以管理员权限启动胡桃工具
2. 胡桃工具箱会在数据目录下创建一个名为 ServerCache 的文件夹并储存转换服务器所需要的文件

• 进入 “启动游戏” 页面
• 找到 “文件” 分类中的 “服务器” 一栏
• 点击右侧选项中的服务器名称，选择要进入的服务器。目前可选的服务器包括：

选项	服务器
官方服 Default	中国大陆服务器
官方服 Official	中国大陆服务器，与上一栏无实质区别
官方服 NoTapTap	禁用 TapTap 帐号登录的中国大陆服务器
渠道服 Default	使用 BiliBili 帐号登录的中国大陆服务器
国际服 Default	HoYoverse 国际服服务器
国际服 Epic	使用 Epic 商城支付网关的 HoYoverse 国际服服务器
国际服 Google	使用 Google Pay 支付网关的 HoYoverse 国际服服务器

• 点击右上角的 “启动游戏” 按钮，胡桃会从对应的米哈游官方服务器自动下载并应用对应服务器的文件替换并启动游戏

账号保存

提示

本功能所描述的账号，特指当前原神所登录游戏账号的登录状态

	官方服	国际服	渠道服
保存登录状态	支持	支持	支持
切换账号	支持	支持	不支持

1. 进入 “启动游戏” 功能页面
2. 点击 “注册表” 分类中的 “检测账号” 一栏，胡桃工具箱会保存当前原神游戏的登录状态
3. 在弹出的 “为账号命名” 界面中，输入您要为此账号设置的名称，点击确认
4. 在游戏中，注销当前登录并登录你另一个账号，随后关闭游戏。重复执行上述的第二步和第三步直至你将全部的账号添加进胡桃工具箱中。
5. 此时即可在账号切换功能下方自由选择您要切换的账号
   • 每个已保存的账号均是可点击选择的按钮
   • 在其右侧有三个按钮，分别为：
     • “绑定当前用户角色”，即将您当前选择的米游社登录状态绑定至该账号中，点击该按钮后，对应的 UID 将出现在该账号自定义名称的下方，可帮你你分辨账号
     • “重命名”，即修改当前选择账号的自定义名称
     • “删除”，即删除当前选择的账号

Windows 平台上的原神 HDR

原神目前内置了仅能通过设置注册表键值开启的 HDR 功能，虽然此举可能意味着该功能属于游戏的测试功能，但是你已经能够抢先体验！

可以在支持 HDR 的显示器上启用 Windows 平台上的原神 HDR 功能以提升视觉体验。在游戏启动器中，你可以启用 Windows HDR 选项，胡桃工具箱会在游戏启动时激活游戏的此内置功能。

原神暂时禁用了 HDR 功能，因此该功能暂时无法生效。

启动参数

• 进入 “启动游戏” 功能页面
• 在 “进程” 一栏中，启用 “启动参数” 功能，点击展开后你可以设置更多细节：
  • -window-mode exclusive 参数
    • 独占全屏，即选择游戏进程以独占全屏模式运行
    • 该功能与游戏内浏览器功能不兼容，你应仅在能独立描述独占全屏的技术原理和效果的情况下开启本项
  • -screen-fullscreen 参数
    • 全屏，即选择启动游戏后的游戏界面是否设置为全屏
  • -popupwindow 参数
    • 无边框，即选择启动游戏后的游戏界面是否设置为无边框窗口
  • -platform_type CLOUD_THIRD_PARTY_MOBILE 参数
    • 触摸屏模式，即启用原神内置的触摸屏操作模式（键鼠输入将被忽略）
  • 分辨率
    • 该功能可以快速设置下方的覆盖屏幕宽度和高度选项
  • -screen-width 参数
    • 宽度，即选择启动游戏后的游戏界面的宽度，例如 1920
  • -screen-height 参数
    • 高度，即选择启动游戏后的游戏界面的高度，例如 1080
  • -monitor 参数
    • 显示器，允许多显示器用户选择指定的显示器来运行游戏
    • 如果你无法判断各选项代表的显示器，可以点击 “识别显示器” 来获得提示

    注意

    请注意，修改主显示器可能会导致游戏出现在与编号不对应的显示器上。

资源下载

胡桃工具箱在高级启动器的资源下载页面会列出实时的原神国服游戏的安装包和增量包。用户可以点击对应包右侧的超链接按钮以跳转到浏览器并开始下载对应的文件， 从而使用自己偏好的下载工具下载游戏。

当用户需要进行游戏版本升级时，可以执行以下步骤：

1. 升级官方启动器
2. 在胡桃工具箱中找到对应版本的增量包及已安装语言的升级包，点击下载
3. 将所有下载的压缩包移动至与游戏程序同级的目录中
4. 启动官方启动器，点击更新按钮。此时官方启动器将跳过下载步骤，直接解压升级包并完成升级

高级功能

警告

• 请注意：高级功能已明确标注为 “Dangerous Feature”，即危险功能，选择启用即代表您选择自行承担任意风险
• 你需要首先在胡桃设置页面中启用高级功能

解锁帧率上限

警告

• Unlocker 项目仅作用于 UnityPlayer 本身，即直接作用于 Unity3D 引擎，与游戏本体不发生直接关系，本质上与移动端中 “120帧率” 等设置无异，但您仍应谨慎使用并自行阅读用户协议

• 使用 “管理员模式” 启动胡桃工具箱
• 确认已在设置中启用 “高级功能”
• 进入 “启动游戏” 功能页面
• 在最下方可见 “解锁帧率限制” 选项
  • 在右侧点击 “开启或关闭” 按钮，所显示的 “禁用” 或 “启用” 分别代表 “已禁用” 或 “已启用” 该功能
  • 在下方的 “设置帧率上限” 选项中，可自由拖动拉杆，调整到您需要设置的最高帧率上限
• 点击右上角的 “启动游戏” 按钮

会导致解锁帧率上限失败的因素：

1. 胡桃工具箱没有保持在后台运行
2. 游戏内未关闭垂直同步选项
3. 在显卡驱动中存在 “最大帧速率” 的设置
4. 在显卡驱动软件内存在未关闭的类似于 “节能模式” 的选项
5. 显卡性能不足

常见问题

如何通过胡桃工具箱快速地启动游戏

• 在主程序中正确设置高级启动器功能

• 将胡桃工具箱在系统中固定在快速启动栏中

• 在快速启动栏中右键胡桃应用程序

  

• 选择 “启动游戏” 即可

为什么游戏登录状态会失效，导致切换账号功能无效

• 保存游戏登录状态的要素有两个：网络环境和设备 ID
• 导致该问题的常见原因是：
  • 网络环境频繁变换，如公网 IP 更换
  • 网络设备变换，比如网卡更新、MAC 地址更换
  • 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别）
    • 确认你的账号已登录后，进入游戏
    • 关闭游戏后，确定游戏进程已关闭
    • 再次进行账号检测，来添加登录状态

转换服务器失败后如何恢复游戏程序

功能原理说明

胡桃客户端始终只从原神官方服务器下载转换服务器需要的文件，这保证了用户不会下载到被第三方篡改的危险程序。 如果你在转换到某一种目标服务器时频繁因网络问题而转换失败，则意味你的网络到目标的原神官方服务器连接质量差。 你应检查你的互联网连接、联系你的运营商或向专业人士咨询以保证你的正常使用体验。

在转换原神服务器时，如果胡桃客户端意外退出或由于用户侧网络问题会导致转换流程中断并进而导致原神客户端损坏。 此时胡桃工具箱会提示 游戏路径不正确，前往设置更改游戏路径，而游戏路径下此时可能不存在任何游戏主程序文件，导致用户无法正确设置。

在这种情况下，用户可以执行下面的步骤手动将胡桃客户端备份的游戏主程序恢复至原本的游戏目录中或直接使用官方启动器修复游戏。

在开始手动恢复游戏程序之前，你需要知道以下基本知识：

1. 关于游戏客户端
2. 国服原神客户端目录下有名为 YuanShen.exe 的游戏主程序和名为 YuanShen_Data 的游戏程序目录
3. 国际服原神客户端目录下有名为 GenshinImpact.exe 的游戏主程序和名为 GenshinImpact_Data 的游戏程序目录
4. 关于胡桃客户端转换服务器功能下的备份步骤
5. 在转换服务器前，胡桃客户端会备份当前游戏客户端的主程序以及国服／国际服客户端专有的一些组件程序，即 exe 主程序和 _Data 目录
6. 备份文件储存于当前 Windows 用户下的文档库中的 Hutao/ServerCache 目录下，即 %userprofile%/Documents/Hutao/ServerCache

手动恢复游戏主程序步骤（此处以国际服转国服为例）：

1. 进入胡桃用于备份游戏主程序的 ServerCache 目录，此时该目录下存放着转换前的游戏程序备份文件，即 GenshinImpact.exe 和 GenshinImpact_Data
2. 进入游戏主程序目录，此时既没有 YuanShen.exe 也没有 GenshinImpact.exe，并且有一个国服目录 YuanShen_Data
3. 手动将游戏主程序目录下的 YuanShen_Data 文件夹更名为 GenshinImpact_Data
4. 手动将 Hutao/ServerCache 下的 GenshinImpact.exe 和 GenshinImpact_Data 复制回游戏主程序目录中并覆盖当前已有文件
5. 此时你的游戏客户端应已恢复正常
6. 重新进入胡桃客户端的 “游戏启动器” 界面，“游戏路径不正确” 错误应不再出现，且 “服务器” 设置一栏为空。此时，你可以选择原本的服务器版本（国际服）并立刻启动游戏，或选择新的服务器目标（国服）并转换客户端版本。

如何恢复 config.ini 配置文件

在某些特定条件下（如游戏目录权限错误），config.ini 文件会在转服后丢失。这会造成无法进入胡桃工具箱高级启动器界面和游戏无法正常启动。

在判断你当前的游戏版本后，你可以在游戏目录 %your_launcher_folder%/Genshin Impact Game/ 下手动创建并填入对应的配置文件，下面是常见的配置文件内容。

相关信息

请自行修改 game_version 至当前游戏版本

国服 Official

[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=1
plugin_7_version=1.0.0

国际服 Official

[General]
channel=1
cps=mihoyo
game_version=4.1.0
sub_channel=0
plugin_7_version=1.0.0