介绍
VRC-Notifier是一个专门为 VRChat 玩家设计的后台监控工具,它可以持续地在后台监控您所指定的好友的状态变化,比如上线信息、下线信息、状态切换信息、和世界切换信息,并通过邮箱 SMTP 服务或者 Gotify 等其他开源平台实时通知你。
功能
- 智能好友监控 - 选择性监控指定好友,而非全部好友列表
- 仅监控状态模式 - 无限制监控所有好友的在线状态,不监控世界变化
- 邮件通知 - 支持自定义 SMTP 服务器,实时接收状态变化通知
- Gotify 推送 - 支持开源推送平台 Gotify,手机实时接收通知
- 世界轮询 - 智能轮询机制追踪好友所在世界变化(标准模式)
- API 保护 - 多层限流保护机制,确保不触发官方 API 限制
- 防抖动机制 - 避免服务器抖动导致的误判,确保通知准确性
- 精美界面 - 现代化 Web UI,支持明暗主题切换
- Docker 支持 - 一键部署,支持 Docker Compose
- 国际化支持 - 中英双语翻译
使用
部署本项目,并启用本项目。在终端会收到访问密钥输入生成的访问密钥即可登录 VRChat 官方账号(账号不会明文保存,相关数据均已加密并保存在本地)。
进入好友列表,便会自动刷新一次好友列表,后面工具将不会主动地自动刷新以降低 API 的请求频率。刷新完后好友列表会进入六十秒等待期(不会调用任何 API),以防止用户在此多次频繁地使用 API 导致限流问题。
用户可选择标准模式和仅监控状态模式。标准模式会监控好友的世界信息,但最多只能监控五个好友;仅监控状态模式下可以监控所有好友,但无法监控他们的世界变化信息,两种模式均在关于按钮中呈现。
接下来用户只要配置 SMTP 服务或者 Gotify 服务或者 Webhook 服务就可以将好友状态及其变化推送到推送平台了。
快速开始
环境要求
- Node.js 18.0 或更高版本
- 支持的平台:Windows / macOS / Linux
安装步骤
方式一:直接运行
# 克隆仓库
git clone https://github.com/shanyaojinjn/vrc-notifier.git
cd vrc-notifier
# 安装依赖
npm install
# 启动服务
npm start
方式二:Docker 部署(推荐)
- 创建项目目录并进入
mkdir vrc-notifier && cd vrc-notifier
- 创建 docker-compose.yml 文件
version: '3.8'
services:
vrc-notifier:
image:

