Description

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你的用户名.n8ncustomnode_modulesn8n-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 / 实时接收好友动态触发器

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
• 转发功能：将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

如何获取 authCookie

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

!alt text

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

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

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

*

💡 Example / 示例

!视奸喵

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

*

⚖️ Disclaimer / 免责声明

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

*

📋 ToDo

• [ ] 返回全文搜索
• [ ] 本地日志 Trigger
• [x] OSC 功能

*

👥 Group / 群组功能

🛡️ 安全说明

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

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

• Email:

*

累了，有问题再call我（