nb-plugin-uma 0.1.0

NoneBot2 赛马娘插件 - 模拟抽卡 | 新闻推送 | 生日提醒

nonebot-plugin-uma

NoneBot2 赛马娘插件 — 模拟抽卡 / 新闻推送 / 生日提醒

声明

本插件移植自 azmiao/uma_plugin（HoshinoBot 版），原作者 azmiao。

本项目仅对原插件进行框架适配（HoshinoBot → NoneBot2），核心逻辑和数据来源归原作者所有。 本项目遵循 GPL-3.0 开源协议，与原插件保持一致。

如有问题反馈，建议优先前往原仓库 azmiao/uma_plugin 提交 issue。

功能

模块	功能	说明
抽卡	马娘单抽/十连/天井、支援卡单抽/十连/天井/满破	支持日/台/韩/B服卡池
新闻	日服官网新闻查看 + 定时推送	每5分钟检测更新
生日	马娘生日查询 + 每日推送	每天8:31推送

安装

以下三种方式任选其一：

方式一：nb-cli（推荐）

nb plugin install nonebot-plugin-uma

方式二：uv

uv add nonebot-plugin-uma

方式三：pip

pip install nonebot-plugin-uma

从 GitHub 安装

pip install git+https://github.com/Baimotong/nonebot-plugin-uma.git

配置

在 NoneBot2 的 .env.prod 中添加以下配置（均为可选）：

# 数据存储目录，默认 data/uma
UMA_DATA_DIR=data/uma

# 默认服务器，可选 jp/tw/ko/bili，默认 jp
UMA_DEFAULT_SERVER=jp

# 是否使用代理，默认 false
UMA_USE_PROXY=false

# 代理地址
UMA_PROXY_URL=http://localhost:1081

命令

抽卡

命令	说明
马娘单抽 / 单抽马娘	马娘池单抽
马娘十连 / 马十连	马娘池十连
马之井 / 马娘井	马娘池200抽天井
支援卡单抽 / 育成卡单抽	支援卡池单抽
支援卡十连 / 育成卡十连	支援卡池十连
支援卡井 / 育成卡井	支援卡池200抽天井
支援卡抽满破	模拟抽到满破(5张)
支援卡选择满破目标	设置满破目标(不带参数查看列表)
支援卡查询满破目标	查询当前满破目标
支援卡清除满破目标	清除满破目标
查看马娘卡池	查看当前卡池详情
切换马娘服务器 jp/tw/bili	切换服务器(群管理员)
切换马娘卡池 数字ID	切换卡池(群管理员)
更新马娘卡池	手动更新卡池数据(超级用户)

新闻

命令	说明
马娘新闻	查看日服最新5条新闻
开启马娘新闻推送	开启日服新闻定时推送(群管理员)
关闭马娘新闻推送	关闭日服新闻定时推送(群管理员)

生日

命令	说明
查今天生日马娘	查询今天生日的马娘
查马娘生日 角色名	查询指定马娘的生日
查生日马娘 月-日	查询某天生日的马娘
开启马娘生日推送	开启每日生日提醒(群管理员)
关闭马娘生日推送	关闭每日生日提醒(群管理员)

帮助

命令	说明
马娘帮助	显示全部命令帮助

定时任务

任务	时间	说明
卡池数据更新	每天 3:30	自动从 Bwiki 更新卡池数据和图片
日服新闻检测	每5分钟	检测日服新闻更新并推送到已开启的群
生日推送	每天 8:31	推送当天生日的马娘到已开启的群

致谢

• azmiao — 原 HoshinoBot 赛马娘插件作者
• azmiao/uma_info_data — 马娘基础数据库
• BWiki — 卡池数据和图片资源来源
• 赛马娘官网 — 新闻数据来源

协议

本项目基于 GPL-3.0 协议开源。