n8n-nodes-vrchat

This is an n8n community node that allows you to use the VRChat API in your n8n workflows. 这是 一个 n8n 社区节点，可用于在 n8n 工作流中调用 VRChat API。

n8n is a fair-code licensed workflow automation platform. n8n 是一个采用 fair-code licensed 许可的工作流自动化平台。

⚠️ Usage Notice / 使用声明

This project is intended for personal use and learning only.

• No advertising, spam, or mass messaging
• No illegal use
• No API abuse (rate abuse, bypassing limits, etc.)
• No automated login, verification bypass, or account hacking
• User behavior is not related to this project; use at your own risk

本项目仅供个人使用与学习。

• 禁止广告、刷屏及群发行为
• 禁止任何违法用途
• 禁止滥用 VRChat 或第三方 API（包括刷请求、绕过限制等）
• 不支持自动登录、绕过验证、账号破解等行为
• 用户行为与本项目无关，使用此类项目可能导致封号，风险自负

📦 Installation / 安装

首先 安装 n8n

然后执行：

npm install n8n-nodes-vrchat

如果你使用的是 n8n desktop 或自建服务，进入 n8n 的 .n8n/custom/node_modules 目录下执行上述命令即可。

如果需要手动安装，也可以在 这里 下载最新的 n8n-nodes-vrchat.zip 文件，解压到 C:\Users\你的用户名\.n8n\custom\node_modules\n8n-nodes-vrchat。

应该就行了吧（

🔧 Operations / 支持功能

The following VRChat API operations are currently supported: 目前支持的 VRChat API 功能包括：

VRChat API 节点

• Get Current User / 获取当前用户信息
• Update Current User / 修改当前用户信息
• Search Users / 搜索玩家
• Get User Info / 获取玩家信息
• Get Mutual Friends / 获取共同好友
• Get Notifications / 获取通知
• Accept Friend Request / 接受好友请求
• Get World Info / 获取世界/实例信息

VRChat Trigger 节点

• Real-time friend activity trigger / 实时接收好友动态触发器
  • WebSocket 直连 VRChat pipeline，支持 8 种事件类型
  • 可过滤事件类型，支持自动重连

VRChat Log Trigger 节点

• 实时读取 VRChat 日志文件 / 无需凭证
  • 监听玩家进出房间、世界切换、目的地设置等事件
  • 支持 fs.watch + 轮询双模式
  • 自动检测日志路径，也可在 Credential 中指定

VRChat Log Analyzer 节点

• 日志文件快照分析 / 无需凭证
  • 尾部快速读取（从最近一次进房开始），无需全量扫描
  • 输出模式：Full Snapshot / Player List / Current Video / Room Info / Activity Log / Unique Players
  • 视频 URL 检测（支持当前 VRChat 格式 + 旧版格式）
  • 可选的 VRChat Log Directory 路径配置（在 Credential 中）

VRChat OSC Send / OSC 发送

• VRChat Preset Mode / VRChat 预设模式
  • Chatbox: 发送聊天框消息、打字指示器
  • Input Axes: 移动、视角控制（7个轴向）
  • Input Buttons: 跳跃、奔跑、语音等（20个按钮）
  • Avatar Parameters: 设置角色参数
• Custom Mode / 自定义模式：自由输入OSC地址和JSON值

VRChat OSC Trigger / OSC 接收

• 监听VRChat OSC输出 / 默认端口9001
• 消息过滤：All Messages / Avatar Change / Avatar Parameters / Custom Address
  • 通配符 * 支持：VRCEmote（精确）、Fiona*（前缀）、*Face*（包含）
  • 支持中文参数名（VRChat 发送的 \uXXXX 转义自动解码）
• 转发功能：将OSC消息转发到其他端口，支持多消费者共享同一份数据

🔐 Credentials / 凭证说明

This node uses VRChat authCookie for authentication 本节点使用 VRChat authCookie 进行认证

⚠️ Please note that casually sharing any cookies is very dangerous. Do not disclose your cookies to anyone. This project will not upload any cookies. ⚠️ 请注意，任意泄露任何 Cookie 都是很危险的行为，请勿将 Cookie 泄露给任何人，本项目不会上传任何 Cookie。

• 本项目不会帮助用户自动登录获取 authCookie，请手动获取 authCookie

可选配置

Credential 中还有一个可选字段 VRChat Log Directory，供 Log Trigger 和 Log Analyzer 节点使用：

• 留空则自动检测（%USERPROFILE%\AppData\LocalLow\VRChat\VRChat\）
• 填写后可统一管理日志路径，多个工作流共享

如何获取 authCookie

1. 登录 VRChat 官网，打开开发者工具（F12）
2. 点击上方的网络（Network）选项卡，然后按 F5 刷新或等待一会
3. 按照下面的方法查找

⚠️ 请注意，任意泄露任何 Cookie 都是很危险的行为，请勿将 Cookie 泄露给任何人，本项目不会上传任何 Cookie。

获取到这一个 authCookie：auth=authcookie_ca80483d-xxxx-xxxx-xxxx-xxxxxxxxxxxx

打开一个节点，点击新建凭证，导入这个 authCookie

💡 Example / 示例

只是开个玩笑啦，这个示例已获得该玩家本人许可。

⚖️ Disclaimer / 免责声明

This project is not affiliated with VRChat Inc. 本项目与 VRChat 官方无任何关联。

📋 ToDo

• [ ] 全文搜索
• [ ] VRChat 群组管理节点
• [x] 本地日志 Trigger
• [x] 本地日志 Analyzer
• [x] 视频播放检测
• [x] OSC 功能
• [x] 中文参数名支持

👥 Group / 群组功能

🛡️ 安全说明

为了防止恶意行为，群组相关功能仅对认证群组开放。

如需使用群组管理功能或有任何问题，请联系我：

• Email: [email protected]

累了，有问题再call我（