VRCX使用指南:如何完整管理VRChat好友、实例与虚拟形象记录
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
管理几十个VRChat好友后,谁改过名、谁在哪个世界、上次见面是什么时候、截图到底在哪拍的,这些信息很容易散落丢失。VRCX 是一款开源的 VRChat 辅助工具,把这些信息整理成本地可查询的记录,这篇 VRCX 使用指南会讲清它的能力与上手方法。
项目速览
VRCX 定位为 VRChat 的外部伴侣应用:它运行在游戏客户端之外,调用 VRChat Web API 拉取实时数据,再落到本地数据库,让你在不进游戏的情况下完成好友、世界、模型的管理与信息追溯。它解决的问题很具体:好友关系与互动历史缺乏记录、截图丢失上下文、游戏内通知无法及时回复、崩溃后需要手动重新进房。适合好友关系活跃、经常组织多人活动、或对截图归档有需求的玩家;轻度玩家也可以只使用其中的搜索和收藏功能。
| 关键信息 | 说明 |
|---|---|
| 项目 | VRCX(MIT 协议,开源) |
| 核心定位 | VRChat 好友管理 + 实例/世界记录 + 截图元数据 |
| 技术栈 | 前端 Vue 3 + Vite,容器 Electron / CEF,后端 .NET (C#) |
| 数据 | 本地 SQLite 数据库,支持收藏列表导入导出 |
| 仓库 | https://gitcode.com/GitHub_Trending/vr/VRCX |
功能实战
好友状态与社交历史追踪
痛点:好友多了以后,最怕两个人改同名或改名后认不出来;想知道"和某个朋友共线多久、上次见面在哪",游戏里没有任何入口。
VRCX 的好友模块(状态逻辑在 src/stores/friend.js)持续同步每位好友的在线状态、当前所在世界、模型(Avatar)变更记录,并记录成为好友的时间、上次见面的世界。好友改名时会有提示,不会丢失对应关系;你还能给每个好友写备注,比如"XX 世界认识的"。在 FriendsLocations 视图里可以一屏看到所有好友当前都在哪个房间、房间人数如何,相当于一个不依赖游戏客户端的"好友雷达"。
虚拟形象收藏与导入导出
痛点:看到朋友穿了一套很棒的模型,想在游戏外快速记下它;收藏列表换机之后无法迁移。
虚拟形象收藏的存储机制在 src/stores/avatar.js,界面位于 src/views/MyAvatars/。你可以把感兴趣的 Avatar 加入本地收藏、打标签分类,在 MyAvatars 页面统一管理已上传和收藏的模型,无需打开 Unity 就能编辑模型与世界的封面图、管理已上传内容。收藏列表支持一键导入/导出,换设备时带上备份文件即可恢复。
截图元数据设置方法
痛点:三个月后翻到一张游戏截图,完全不记得当时是在哪个世界、和谁一起拍的。
VRCX 会在你于游戏内拍摄截图时,把世界名称、世界 ID 等上下文数据写入 PNG 文件本身的元数据中(解析与写入逻辑在 Dotnet/ScreenshotMetadata/)。之后在 Tools 页面的 ScreenshotMetadata 工具中打开旧截图,就能查到拍摄时的世界信息。对经常截图存图的用户来说,这是让相册"可检索"的关键一步。
通知监控、实例信息与自动重连
痛点:人不在游戏里时,好友的邀请和好友请求容易漏掉;VRChat 崩溃后要从头找房间重新进。
VRCX 可以常驻监控通知(好友请求、各类邀请),你能直接在里面查看邀请指向的房间信息并回复;同时显示当前实例的用户列表与统计数据。此外它支持 VR 手腕叠加界面,游戏内就能瞥一眼事件与通知;VRChat 崩溃后会自动重启客户端并尝试重新加入崩溃前的房间。还可以把当前世界信息同步到 Discord 状态面板,对 PyPyDance、LSMedia 等热门世界做了深度展示(封面图、房间 ID、人数,公共房间甚至带"加入"按钮)。
使用图表与统计
痛点:想回顾"最近一个月我玩了多久、常去哪些世界",游戏内没有任何统计。
src/views/Charts/ 提供本地统计图表,基于你积累的游戏日志数据绘制活动趋势与世界分布,数据全部来自本地记录,不涉及额外隐私上传。
快速上手
# 1. 克隆仓库 git clone https://gitcode.com/GitHub_Trending/vr/VRCX cd VRCX # 2. 安装前端依赖 npm install- 启动前端开发环境:
npm run dev,Vite 会serve出 Vue 界面,用于界面开发调试。 - 构建 .NET 后端:进入
Dotnet/目录,按目标容器选择VRCX-Cef.csproj或VRCX-Electron.csproj进行dotnet build(完整打包可参考仓库内VRCX.slnx与electron-builder.config.js的配置)。 - 以 Electron 方式运行完整应用:
npm run start-electron。 - 首次登录:启动后按提示输入 VRChat 账号密码登录,支持两步验证。
- 基础配置:在设置中打开需要的通知项、选择主题风格,并配置"启动 VRChat 时自动启动的程序"(如变声器、OSC 工具)。
日常使用推荐直接下载 release 安装程序,从源码构建主要用于开发与定制。
进阶技巧与常见问答
- 自动联动游戏外程序:利用"随 VRChat 启动"功能,可以固定拉起变声器、Discord 语音等配套工具,省去每次手动开的动作,适合有固定直播或活动流程的玩家。
- 用搜索替代记忆:VRCX 的搜索覆盖世界、模型、好友、群组,配合本地收藏与备注,遇到"那个人当时穿的是哪套模型"这类问题,先搜收藏再查备注,比翻相册快得多。
- 挑实例进房:在好友都在线的时段,先通过实例监控查看目标房间的人数与状态,避开刚开房的拥挤期,适合组织多人活动前确认大家的位置。
- 界面可以换主题:外观不满意时,VRCX 支持自定义主题,修改配色后整个界面风格随之变化,方便区分多开设备。
技术架构概览
VRCX 采用前后端分离结构:前端是 Vue 3 + Vite 的 Web 界面,通过 Pinia 管理状态(好友、虚拟形象、游戏状态等均有独立 store),容器层提供 Electron 与 CEF 两种实现;后端为 C# .NET 组件,负责进程监控(Dotnet/ProcessMonitor.cs)、截图元数据读写、本地存储等。前端与 .NET 后端之间通过 IPC(Dotnet/IPC/)通信,实时数据经 VRChat Web API 拉取后落入本地 SQLite 数据库,界面展示全部基于本地记录渲染,因此查询速度快且离线可用。
总结
VRCX 把 VRChat 散落各处的好友关系、互动历史、世界记录与截图上下文集中成一套可检索的本地系统,适合好友活跃、重视记录归档的玩家。现在就克隆仓库、按上面的步骤跑起来,先配置好友通知,你会立刻感受到它和纯游戏客户端的差别。
【免费下载链接】VRCXFriendship management tool for VRChat项目地址: https://gitcode.com/GitHub_Trending/vr/VRCX
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考