NoneBotPluginText

nonebot_plugin_vrchat

✨ 使用第三方 API 实现 VRChat 相关操作 ✨

说明

国内服务器可使用
支持 alconna 跨平台适配器
支持 alconna i18n 多语言（zh-CN / en-US / ja-JP）
图片生成使用浏览器渲染
当前项目功能已完善，以后仅做bug维护。之后会迁移更新这个项目VrchatUID

安装

推荐：nb-cli

nb plugin install nonebot-plugin-vrchat

包管理器

pip install nonebot-plugin-vrchat
# 或
uv add nonebot-plugin-vrchat
# 或
poetry add nonebot-plugin-vrchat

然后在 pyproject.toml 中启用：

[tool.nonebot]
plugins = ["nonebot_plugin_vrchat"]

使用

首先私聊机器人发送 vrc登录，按提示输入账号密码和 2FA 验证码。

指令

命令	说明
`vrc帮助`	查看所有指令
`vrc登录`	登录 VRChat 账户（建议私聊）
`vrc全部好友`	查询全部好友状态（图片）
`vrc显示通知`	查看通知列表
`vrc搜索用户 <关键词>`	搜索用户（图片）
`vrc搜索世界 <关键词>`	搜索世界（图片）
`vrc收藏列表`	查看收藏
`vrc收藏组列表`	查看收藏组
`vrc群组帮助`	群组相关指令
`vrc经济帮助`	经济相关指令

切换语言：

lang switch zh-CN   # 中文
lang switch en-US   # 英文
lang switch ja-JP   # 日文

配置（全部可选）

# 好友列表/个人卡片图片模板
vrchat_img="default"

# 是否下载并显示用户头像（关闭可大幅提升出图速度）
vrchat_avatar=true

# 2FA 验证码等待超时（timedelta 格式，PT5M = 5 分钟）
session_expire_timeout=PT5M

常见问题

playwright._impl._errors.Error: Page.wait_for_timeout: expected float, got undefined

注释掉 nonebot_plugin_htmlrender\data_source.py 中的 await page.wait_for_timeout(wait) 即可临时解决。

截图

反馈

致谢

vrchatapi-python

更新日志

0.3.5

修复累计的 bug
优化代码结构
修复了请求和图片缓存的一些问题
使用httpx全面替代aiohttp

0.3.4

修复累计的 bug
更新 vrchatapi-python 至 1.20.7
新增 vrc群组帮助 / vrc经济帮助
优化代码结构

0.1.2

修复无法加载 cookie 的 bug
新增 i18n

0.1.0

修复人物图片错误
新增好友参数显示
新增查询好友图片

Metadata

Release files for nonebot-plugin-vrchat 0.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-vrchat 0.3.5
File	Size	Uploaded
nonebot_plugin_vrchat-0.3.5.tar.gz	1.2 MB	Jun 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-vrchat 0.3.5
File	Interpreter	ABI	Platform	Reset
nonebot_plugin_vrchat-0.3.5-py3-none-any.whl 206.7 kB Jun 9, 2026	Python 3	none	any	Details

Total release size: 1.4 MB

Release files / nonebot_plugin_vrchat-0.3.5.tar.gz

Download URL	nonebot_plugin_vrchat-0.3.5.tar.gz
Size	1.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`65f027d285df2189194d4f7941886ba96676cf99d04ad6283a5611481f9629cf`
BLAKE2b-256 checksum How to use checksums	`f69b1d3e9bbc46bc7e12d723a7658568c4add6d1eb954fea8cf369480d4e6153`
Upload date	Jun 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`pdm/2.27.0 CPython/3.12.3 Linux/6.17.0-1015-azure`

Release files / nonebot_plugin_vrchat-0.3.5-py3-none-any.whl

Download URL	nonebot_plugin_vrchat-0.3.5-py3-none-any.whl
Size	206.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8968c6a97043808c3cc658aa174a7c78cfa384a15dea58ad20dce1fbb3d124fa`
BLAKE2b-256 checksum How to use checksums	`1827286a4022d87d36730ba322b42569cfa5e6d4bb6fae8f5cb5e748ed01dbb4`
Upload date	Jun 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`pdm/2.27.0 CPython/3.12.3 Linux/6.17.0-1015-azure`