由 VRChat SDK Patcher 作者写的 Patcher 使用说明
Misaka-L
编辑于 2026年06月26日 04:05

该工具已停止维护

替代品请移步:

原文

推荐移步此处阅读,后续更新只会在此处更新,并且此处拥有更好的阅读体验(因为哔哩专栏一言难尽):https://docs.vrcd.org.cn/books/all-about-vrchat-sdk-patcher

### 在前面先做几点说明

  • 使用该补丁需要启用“TUN/虚拟网卡”。

  • 使用该补丁需要启用“系统代理”或“HTTP 代理”或类似选项。

  • 请使用 ALCOM/VRChat Creator Companion 或其他 VPM 包管理器安装本补丁,不要直接解压 Zip 包或者使用其他安装方式(除非您很清楚的知道您在做什么)。

  • 除非修改了“Others”节的设置在专业人士(清楚 Patcher 的工作原理并且熟悉 Unity/C# 工具链)指导(或你很清楚你在干什么)的情况下排故,否则您用不到 Reload SDK 按钮

  • 即使您不使用代理,Patcher 也可以改善上传时的网络稳定性。(见“关于 Patcher 如何增强上传稳定性”

强烈建议在执行任何包管理器操作前关闭您的 Unity。

1、添加 VRCD VPM 源仓库

以下方法二选一

  • 请使用该链接前往 VPM 镜像站添加仓库(点击“添加到包管理器”点击“复制镜像仓库地址”手动添加到包管理器):https://vcc.vrczh.org/repos/vrcd/cn.org.vrcd.vpm.vrchat-sdk-patcher@latest

  • 或者直接添加 VPM 镜像站内的 `vrcd` 源:https://vpm.vrczh.org/vpm/vrcd

    2、在包管理器安装 VRChat SDK Patcher(请选择最新版本

不要非世界项目安装“VRChat SDK Patcher - Worlds”,这很可能会破坏您的项目!一般情况下您不需要这个包。

3、打开您的项目,在 Unity 完成所有工作后检查控制台是否出现“Patcher Loaded”字样和工具栏是否出现“VRChat SDK Patcher”选项卡。

如果您的控制台出现了大片报错并且没有出现以上选项和控制台消息,请先关闭您的 Unity,并回到包管理器打开您的项目,并点击“修复依赖关系”或类似选项,待包管理器完成操作后再启动 Untiy

如果问题依然没有解决,可以前往 VRCD 玩家社区寻求帮助:750258838

二、检查 VRChat SDK Patcher 设置

1、在工具栏找到“VRChat SDK Patcher”选项卡,点击后在下拉菜单点击“Settings”选项卡。

2、在弹出的“VRChat SDK Patcher Settings”窗口中,勾选“Use Proxy”选项。

除非您知道您在做什么或正在专业人士的指导下操作否则不要修改任何其他选项

三、检查您的魔法软件设置

请连接您的魔法,检查魔法规则(可以无脑全局),打开“系统代理”或“HTTP 代理”或类似选项。您不需要 TUN/虚拟网卡模式!

四、再次尝试上传

如果您的控制台出现了如下内容,请退出登录并重新登录您的账号。

如果以上错误持续发生,请尝试更换魔法节点并重试该步骤操作。如果问题依旧没有得到解决,您可以前往 VRCD 玩家社区寻求帮助:750258838。

五(?)、我还是无法上传!

请完成如下检查单:

  • 使用了包管理器(如 ALCOM、VRChat Creator Companion)安装 VRChat SDK Patcher。

  • 安装了“VRChat SDK Patcher”,并且没有在虚拟形象(Avatar)项目安装“VRChat SDK Patcher - Worlds”包

  • 我正确执行了“二、检查 VRChat SDK Patcher 设置”内的所有步骤,除启用“Use Proxy”外没有修改任何设置。

  • 我安装的是最新版本的“VRChat SDK Patcher”。

  • 我的魔法软件设置为“系统代理”、“HTTP 代理”或类似选项。并且没有在不清楚软件设置能否正常工作时启用“TUN/虚拟网卡模式”。

  • 我的魔法软件在正常工作(可以在其他软件正常使用魔法)。

  • 在出现“四、再次尝试上传”内的错误时,我退出并重新登录了 VRChat SDK,并且尝试过更换魔法节点。

    如果您完成了以上检查单的所有项目,但是问题依旧,可以前往 VRCD 玩家社区寻求帮助:750258838。

您不需要读以下内容,这些是技术性内容,为想了解 Patcher 原理的用户提供解释。

在 v0.3.0 或更新版本,Patcher 添加了以下功能:

  • 自动跟随系统 HTTP 代理设置(关于其局限性,请查看 Patcher 设置内的 Tooltip)(在 v0.3.0 之前的版本中,您需要手动设置 HTTP 代理 URL)。

  • 让 VRChat SDK 支持重用 HttpClient。

    那么 Patcher 是怎么通过这些功能改善您的使用体验呢?

  • VRChat SDK 的所有网络请求都会使用系统的代理设置,只要代理正确设置,那么 VRChat SDK 就会通过代理发送请求。

  • 在安装补丁前,VRChat SDK 会在每次请求都创建一个新的 HttpClient。

  • 并且在上传世界或虚拟形象时,SDK 会使用分块上传:

  • 也就是每上传一个分块,VRChat SDK 就需要重新执行查询 DNS 记录,与服务器建立 TCP 连接,发送 HTTP 请求等一系列步骤,而不是重用已与服务器建立的连接。

  • VRChat SDK Patcher Github:https://github.com/vrcd-community/vrchat-sdk-patcher

  • VRChat SDK Patcher VPM 镜像站页面:https://vcc.vrczh.org/repos/vrcd/cn.org.vrcd.vpm.vrchat-sdk-patcher@latest

  • VRCD 玩家社区 QQ 群:750258838