JoyPro2 Discord GitHub
入门

下载和安装

显示:

JoyPro 2 是免费的开源软件(GPL-3.0)。不需要账号,不需要注册,也没有遥测。

新手入门

#三个步骤

  1. 打开 GitHub 上的发布页面,下载 JoyPro2-<version>-win-x64.zip(在 Assets 下)。
  2. 右键单击 zip,选择 全部解压缩...,然后选择一个你有写入权限的文件夹,例如 C:\JoyPro2 或“文档”中的某个文件夹。(不要用 C:\Program Files:JoyPro 会在它自己的文件夹中自我更新。)
  3. 打开该文件夹,双击 JoyPro.Gui(带摇杆图标的程序;如果显示文件扩展名,它显示为 JoyPro.Gui.exe)。

Windows 显示 Windows 已保护你的电脑?点击 更多信息,然后点击 仍要运行。对于从互联网下载、Windows 还不认识的程序,它只会问一次。

首次启动时,JoyPro 会查找你的游戏并在一个窗口中显示它们:请参见首次启动。第一次使用 JoyPro?请在那里按 完成,并全部帮我设置好,然后按照快速入门:让我的摇杆工作操作。

然后欢迎界面会询问你想做什么,并启动适合你的导览。同一文件夹中的 JoyPro 2 - Tour 可以随时再次打开这个欢迎界面。想要大字和短句?在欢迎界面中勾选 简单用语:大字、短句(简单用语、导览和 F1)。

#你需要什么

  • Windows 10 或 11,64 位。
  • JoyPro 引擎需要 .NET Framework 4.8。Windows 10 和 11 已经自带;如果缺少,JoyPro 会提供 Microsoft 的安装程序。
  • 不需要别的:zip 中包含所有内容(该程序不需要另外安装 .NET 9)。

#更新

JoyPro 启动时会在 GitHub 上检查是否有新版本(设置:启动时检查更新)。有新版本时会打开一个窗口,显示更改内容以及 立即更新 / 以后再说 / 跳过此版本。你的配置文件和设置会保留。

高级

#JoyPro 把东西存放在哪里

你的配置文件位于“文档”文件夹中的 JoyPro2 里。问题报告也放在那里。更新只替换程序文件夹:你的配置文件、设置、命令列表、备份和历史记录都会保留。完整的文件夹列表见“技术细节”。

#可选组件

设置 > 组件 可以在你同意后一键安装以下各项:vJoy(虚拟摇杆)、HidHide(对游戏隐藏实体设备)和 ViGEmBus(虚拟 Xbox 手柄),用于虚拟摇杆模式。设置 > 本地 AI 可以为助手下载一个可选的 AI 模型;没有它一切也都能正常工作。

#联网

JoyPro 只会在以下情况联网:检查更新(GitHub)、获取设备制造商提供的产品照片(只有在你对每个设备都同意后)、你的电脑上缺少的游戏封面(可以关闭)、可选的 AI 模型、可选组件以及缺少的 .NET Framework 安装程序。这些网站会看到你的 IP 地址。详情:隐私。

技术细节

#JoyPro 的所有文件夹

内容 位置
程序 你解压的文件夹(包含 engine\engine.exe、vjoy\、tray\,以及 JoyPro 自带的 DB\ 中的数据)
你的配置文件 Documents\JoyPro2(或你保存它们的任何位置)
设置 %APPDATA%\JoyPro2(ui-settings.json、export-settings.json、hud.json ……)
在你的电脑上生成的游戏命令列表 %LOCALAPPDATA%\JoyPro2\GameData
游戏文件备份 %LOCALAPPDATA%\JoyPro2\GameBackups(每个游戏保留最新的 30 份)
配置文件历史记录(重启后仍可撤销) %LOCALAPPDATA%\JoyPro2\ProfileHistory
日志 %LOCALAPPDATA%\JoyPro2\Logs(几天后自动删除)
问题报告 Documents\JoyPro2\Problem Reports

#安装包里有什么

  • JoyPro.Gui.exe:Avalonia 应用程序(.NET 9,独立部署)。
  • JoyPro 2 - Tour.cmd:启动 JoyPro.Gui.exe --welcome,即带导览的欢迎页(如果 JoyPro 已在运行,则交给它处理)。
  • engine\engine.exe:引擎(.NET Framework 4.8)。GUI 的每个操作都会运行它;你也可以在控制台中运行它(引擎命令行)。
  • vjoy\JoyPro.VJoy.exe(虚拟摇杆转发程序)、JoyPro.Ffb.exe(遥测力反馈)、tray\JoyPro.Tray.exe(GUI 关闭时的监视器)。
  • 更新会下载发布的 zip 文件,对照发布的 .sha256 文件进行校验,然后安装。
  • 从源代码构建:dotnet build gui/JoyPro.Gui/JoyPro.Gui.csproj(同时构建引擎;需要 .NET Framework 4.8 构建工具),参见仓库的 README。