VRCX 功能深度指南VRChat 辅助工具的核心能力与源码实现解析【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCXVRCX 是一款面向 VRChat 的辅助/伴侣assistant/companion应用它通过 VRChat 官方 API 在桌面客户端或 VR 客户端之外提供更便捷的信息获取与任务处理能力。本文以 README.es.md 的功能导览为主线结合本仓库的实际源码如 AutoAppLaunchManager.cs、ProcessMonitor.cs、ScreenshotHelper.cs 等逐一拆解其核心功能背后的实现原理帮助你既了解能做什么也理解是怎么做的。项目定位一个使用 API 的外部辅助工具VRCX 的定位是 VRChat 的伴侣应用它不修改游戏本体不注入任何代码而是作为外部工具调用 VRChat API 来提供功能。原文档明确强调它不是 mod、不是作弊工具也不是任何形式的游戏修改官方对 API 使用的立场可参考 VRChat Discord 的 #faq 频道。这一点在仓库结构上也能得到印证——本项目由三部分组成Dotnet/目录负责与 VRChat 客户端交互的底层逻辑进程监控、日志解析、IPC、截图元数据、VR 叠加层等src/目录基于 Vue 3 与 Pinia 的前端界面好友、世界、收藏、通知等各功能视图src-electron/目录Electron 桌面壳与主进程入口 main.js。快速入门从项目 Releases 页面下载最新安装包VRCX_Setup.exe并安装即可使用。官方同时提供beta/nightly 渠道可在应用内通过Configuración - General - Cambiar versión即设置 → 常规 → 切换版本随时切换构建渠道Linux/macOS 用户可参考仓库 wiki 中的运行指南。仓库根目录的 package.json 记录了当前版本号2026.07.18及完整的构建脚本例如npm run build-electron会依次执行下载 .NET 运行时、打补丁、electron-builder 打包等流程可作为从源码构建的参考。功能全景与实现解析1. 好友、世界与头像列表管理VRCX 允许你在不启动 VRChat 的情况下管理好友列表、世界/群组/头像列表并持续跟踪多项社交数据活动监控持续记录好友的在线状态、所在位置与当前使用的头像相识追踪记录何时添加对方为好友、最后一次见面时间、在同一个世界里共度的时间与次数改名记录跟踪好友的显示名称变更历史备忘笔记为每位好友保存笔记帮助你回忆如何相识。从源码结构看这些数据由本地 SQLite 数据库承载。database/index.js 中定义了相关数据表例如{user}_friend_log_current与{user}_friend_log_history分别保存好友当前信息display_name、trust_level、friend_number与历史变更记录含previous_display_name、previous_trust_level字段而{user}_notes表则用于存储好友笔记display_name、note、created_at。好友/世界/头像的收藏分别落在favorite_world与favorite_print等表中。前端侧对应的数据库模块见 friendLogCurrent.js、friendLogHistory.js、friendFavorites.js、worldFavorites.js、avatarFavorites.js。2. 启动 VRChat 时自动启动其他应用VRCX 可以配置为当你启动 VRChat 时自动拉起其他应用——例如 OSC 调试工具、语音变声器、表情控制器等。其核心实现在 AutoAppLaunchManager.cs工作原理如下进程监控ProcessMonitor.cs 每秒轮询一次系统进程表监控vrchat与vrserver两个进程见其Init()方法一旦检测到 VRChat 进程启动/退出即触发事件快捷方式扫描VRCX 在你的数据目录下维护startup/desktop与startup/vr两个目录构造函数中通过Path.Join(Program.AppDataDirectory, startup)创建分别存放桌面模式与 VR 模式下要启动的应用快捷方式文件识别通过校验文件头识别.lnk快捷方式比对 ShellLinkHeader 的 4 字节签名0x4C 0x00 0x00 0x00与.url网络快捷方式比对[{000214A0-...}]头并支持从.url中解析URLsteam://rungameid/xxx来拉起 Steam 游戏StartSteamGame会读取注册表中的 Steam 安装路径与libraryfolders.vdf进而通过appmanifest_*.acf定位游戏安装目录进程树管理可选项KillChildrenOnExit默认开启控制在 VRChat 关闭时是否终止由 VRCX 拉起的整个进程树含子进程通过CreateToolhelp32Snapshot/Process32First/Next递归查找RunProcessOnce则控制同名进程已在运行时是否重复启动。3. 跨实体搜索与快速搜索VRCX 提供对头像、用户、世界、群组的搜索能力并且可以直接粘贴 ID 或 URL 直达对应实体。前端实现了Quick Search快速搜索以 quickSearch.js 为核心使用 Web Worker见quickSearchWorker.js?workerinline的引入方式在客户端本地对好友、头像、世界、群组进行即时模糊搜索搜索结果不依赖服务器往返响应更快。4. 本地无限制的世界收藏你可以在 VRChat 之外创建一份本地的、不受官方收藏槽位限制的世界收藏列表。与官方在线的收藏系统不同这份列表完全由 VRCX 本地管理数据库中的favorite_world表即为其存储载体。5. 截图中的世界数据Screenshot Metadata这是 VRCX 颇具特色的功能把拍摄照片时所在世界的信息直接写入 PNG 文件内部这样即使几个月后翻到旧照片也能一键回忆起拍摄地点。其实现集中在 ScreenshotMetadata 目录ScreenshotHelper.cs 负责读写 PNG 的文本块text chunk。VRChat 官方截图通常携带XML:com.adobe.xmp块XMP 元数据VRCX 则额外写入一个名为Description的 JSON 文本块读取时按顺序解析XMP 元数据作者、世界 ID/名称、拍摄时间、VRCX 的 JSON 块玩家列表、实例 ID并兼容旧版 modLFS、ScreenshotManager追加在文件尾部的lfs|...格式元数据ParseLfsPicture支持 v1/v2 与 CVR 版本为加快检索元数据会缓存在metadataCache.dbProgram.AppDataDirectory下支持按用户名、用户 ID、世界名、世界 ID 四种维度搜索ScreenshotSearchType枚举跨应用开发者在没有 VRCX 的情况下也能读写该格式JSON 结构由 screenshotMetadata-schema.json 明确定义包含application写入方应为VRCX、version当前为 1、author拍摄者 id/displayName、worldid/name/instanceId、players拍照时在场的玩家数组五个必需字段。6. 通知监控与响应VRCX 可以直接收发邀请与好友请求并查看收到的邀请对应的实例信息。通知数据保存在数据库的{user}_notifications与{user}_notifications_v2表见 database/index.js后者是结构更完整的通知格式包含type、link、message、title、image_url、responses、details等字段支撑起邀请的回复操作与实例信息展示。前端对应的视图与交互位于 views/Notifications 目录。7. 当前实例的统计与玩家列表进入任意实例后VRCX 可以显示该实例的玩家统计与列表。底层依据是GameLog游戏日志数据——database/index.js 定义了gamelog_location位置进出、gamelog_join_leave玩家进出、gamelog_portal_spawn传送门生成、gamelog_video_play视频播放、gamelog_resource_load资源加载、gamelog_event、gamelog_external等表几乎覆盖了实例内发生的所有可记录事件。解析与展示逻辑见 views/GameLog、services/gameLog.js 与 stores/gameLog。8. 世界中正在播放的视频链接对应gamelog_video_play表VRCX 会记录世界中正在播放的视频 URL、名称、ID、播放者display_name、user_id与所在位置让你离开后仍能回溯当时播放的内容。9. 增强版 Discord 富文本状态Rich Presence可选地将当前实例的详细信息展示到 Discord 个人资料上世界缩略图、世界名称、实例 ID、玩家数量对 PyPyDance、LSMedia、MoviesChill、VRDancing 等热门世界有专门的世界集成公开大厅还能显示加入按钮。实现位于 Discord.cs使用DiscordRPC库维护DiscordRpcClientInit()后每 3 秒_timer.Change(0, 3000)通过回调刷新一次状态SetAssets(...)方法接收 details、state、大小图标的 key/text、时间戳Unix 毫秒、Party玩家数/上限与按钮等参数其中 details/state 会按 UTF-8 字节长度裁剪到 Discord 限制的 127 字节LimitByteLength是否展示玩家数量等信息由配置决定且私有大厅lobby privado默认不展示敏感信息。10. VR 叠加层VR OverlayVRCX 提供一个可配置的 VR 叠加层以实时 feed 的形式展示所有受支持的事件与通知。叠加层以独立进程方式运行OverlayManager.cs 通过--overlay启动参数拉起一个新进程StartupArgs.VrcxLaunchArguments.Overlay进程间通过 WebSocket 通信见 OverlayWebSocket 目录下的 OverlayServer、OverlayMessage 等。叠加层的前端实现位于 src/vr包含 VR 专用的 Vue 入口 Vr.vue 与 vr.html桌面与 VR 分别支持 CEF 与 Electron 两套渲染后端Overlay/Cef 与 Overlay/Electron。11. 无需 Unity 上传与管理内容VRCX 支持不借助 Unity直接上传头像/世界的图片以及编辑管理已上传头像/世界的详情。前端的图片上传与裁切能力见 useImageCropper.js配套测试 useImageCropper.test.js与 ImageCropDialog.vue对应的 API 封装在 api/image.js、api/avatar.js、api/world.js。12. 崩溃自动重启并回到原实例当 VRChat 崩溃时VRCX 可以自动重启游戏并重新加入刚才所在的实例。支撑这一能力的是 ProcessMonitor.cs它在Init()中注册监控vrchat与vrserver两个进程并对外暴露ProcessStarted/ProcessExited事件前端通过 ProcessMonitor 相关状态结合测试 game.test.js感知崩溃并执行自动重启与加入最后实例流程。13. 收藏组导出/导入VRCX 支持将收藏组favorite groups导出为文件、随后再导入便于迁移与备份。数据库中的favorite_world世界收藏与favorite_print打印/收藏条目表是导出的数据来源前端入口位于 Favorites 视图。其他实用信息主题定制VRCX 支持自定义外观主题仓库内置了 blue、green、midnight、orange、red、rose、violet、yellow 八套主题样式见 styles/themes从源码构建仓库根目录 package.json 提供了完整的开发脚本如npm run devVite 开发服务器、npm testVitest 测试、npm run lintoxlint 代码检查、npm run build-electron打包 x64 安装包等.NET 侧对应 VRCX-Cef.csproj 与 VRCX-Electron.csprojLinux 运行Linux 用户可参考仓库 wiki 中的运行指南Electron 版在 Linux 下需要原生 OpenVR 库已随仓库附带src-electron/libs/linux/libopenvr_api.so启动参数StartupArgs.cs 定义了若干命令行参数包括--startup随系统启动、/Upgrade升级模式、--debug调试模式、--overlay启动 VR 叠加层进程、--config目录指定数据目录、--proxy-serverURL代理以及vrcx://协议链接。关于 TOS 合规性VRCX 是否违反 VRChat 的服务条款不违反。原文档对此有明确说明VRCX 是使用 VRChat API 的外部工具不修改游戏、不是 mod、不是作弊只是负责任地使用 API 提供上述功能。同时 VRCX 与 VRChat 官方无任何隶属关系——VRCX 未获得 VRChat 的背书也不代表 VRChat 或相关权利人的观点VRChat 及其相关资产均为 VRChat Inc. 的商标。【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考