NoneBot2米游社大别野Bot适配器。MiHoYo Villa Bot adapter for nonebot2.
Project description
安装
在nb create
创建项目时选择Villa
适配器
或在现有NoneBot2
项目目录下使用脚手架安装:
nb adapter install nonebot-adapter-villa
配置
修改 NoneBot 配置文件 .env
或者 .env.*
。
Driver
本适配器同时需要ReverseDriver
和ForwardDriver
,参考 driver 配置项。
例如:
DRIVER=~fastapi+~httpx
VILLA_BOTS
配置 Bot 帐号列表,每个bot有3个必填配置,可前往大别野「机器人开发者社区」(ID: OpenVilla
)申请,取得以下配置:
bot_id
: 机器人id,以bot_
开头bot_secret
: 机器人密钥callback_url
: http回调地址 endpoint,例如申请bot时给的回调地址是http://域名/your/callback/url
,那么配置里的callback_url
填写/your/callback/url
例如:
VILLA_BOTS='
[
{
"bot_id": "bot_123456789",
"bot_secret": "abc123def456",
"callback_url": "/your/callback/url"
}
]
'
示例
注意,当前大别野只能接收到有@Bot(在哪个位置皆可)的消息事件,且不能有多个@(即使是@两次Bot都不行)
消息段展示
以下是一个简单的插件示例,展示各种消息段:
from nonebot import on_command
from nonebot.params import CommandArg
from nonebot.adapters.villa import Bot, SendMessageEvent, Message, MessageSegment
matcher = on_command('发送')
@matcher.handle()
async def matcher_handler(bot: Bot, event: SendMessageEvent, cmd_arg: Message = CommandArg()):
msg = Message()
args = cmd_arg.extract_plain_text().strip().split(' ')
for arg in args:
if arg == "艾特我":
msg += MessageSegment.mention_user(event.villa_id, event.from_user_id)
elif arg == "艾特bot":
msg += MessageSegment.mention_robot(bot.self_id, bot.nickname)
elif arg == "文字":
msg += MessageSegment.text("文字")
# 表情也是用text来发送,以[表情名]格式,例如MessageSegment.text("[爱心]")
elif arg == "房间":
msg += MessageSegment.room_link(event.villa_id, event.room_id)
elif arg == "链接":
msg += MessageSegment.link("https://www.miyoushe.com/ys/article/39670307", show_text="这是链接")
# 使用link的话链接能够点击进行跳转,使用text的话不能点击
# show_text是指链接显示的文字,但在当前版本Web端大别野会无法正常跳转,最好不使用该参数
elif arg == "图片":
msg += MessageSegment.image("https://www.miyoushe.com/_nuxt/img/miHoYo_Game.2457753.png")
# 暂时只支持url图片
# 如果在单次消息中,发送多张图片或者与其他消息段拼接,那么将无法在web端显示出来
# 所以建议每张图片单独发送
elif arg == "帖子":
msg += MessageSegment.post("https://www.miyoushe.com/ys/article/40391314")
# 帖子消息段只能单独发送,和其他消息段拼接时将被无视
await matcher.finish(msg)
使用命令@bot /发送 艾特我 艾特bot 文字 房间 链接
时,bot会回复@你的名字 @bot的名字 文字 #房间名 这是链接
交流、建议和反馈
大别野 Bot 和本适配器均为开发测试中,如遇问题请提出 issue ,感谢支持!
也欢迎来我的大别野「尘世闲游」(ID: wgiJNaU
)进行交流~
相关项目
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for nonebot_adapter_villa-0.4.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 589e22303f537b5fea3b203638351c02c3d806d7c0dd1e4f053b9cb317da300c |
|
MD5 | 3fe8a448efb11df365e25114f1d118d0 |
|
BLAKE2b-256 | 2fffa0999f732e88b722cefe44540986135016924bbf569bcbcbd3f36a145615 |
Close
Hashes for nonebot_adapter_villa-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ecc239bc28b325cb74da5a0591cbd0f9ff208a234b21ba52d609e2c2bdc05294 |
|
MD5 | 938dc8490cc4d13266a34b01d3ae17e0 |
|
BLAKE2b-256 | b300176b010eb6ef4c2802ca31d9b0a88d0bec82d0d6947815e40c3e7979f5b9 |