https://github.com/azmiao/uma_plugin

hoshino python qqbot umamusume

Last synced: 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/azmiao/uma_plugin
Owner: azmiao
License: gpl-3.0
Created: 2022-03-04T06:18:56.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2026-03-04T03:50:19.000Z (3 months ago)
Last Synced: 2026-03-04T08:25:22.653Z (3 months ago)
Topics: hoshino, python, qqbot, umamusume
Language: Python
Homepage:
Size: 7.64 MB
Stars: 129
Watchers: 1
Forks: 9
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# 赛马娘QQ机器人插件

### ★ 纯粹用爱发电，如果你喜欢的话，请给仓库点一个star支持一下2333 ★

#### 如有魔改版请遵守本插件的GPL3.0开源协议并保持开源！！最好注明来源支持一下作者hhh

#### 马娘别称存在插件目录/uma_info/replace_dict.json文件中，有新增的别称可以提交PR共享出来哦

#### 本插件作者已经弃坑马娘，新功能不再增加，仅做重构优化和BUG修复

[![image](https://img.shields.io/badge/license-GPL3.0-blue.svg)](https://raw.githubusercontent.com/azmiao/uma_plugin/main/LICENSE)
[![image](https://img.shields.io/badge/release-2.9.2-orange.svg)](https://github.com/azmiao/uma_plugin)
[![image](https://img.shields.io/badge/auther-AZMIAO-blue.svg)](https://github.com/azmiao/uma_plugin)

文档
·
问题反馈
·
讨论
·
基础数据库

插件说明

这是一个适用[hoshinoBot](https://github.com/Ice-Cirno/HoshinoBot)的赛马娘功能插件，数据来自：

+ [马娘官网](https://umamusume.jp/)
+ [BWiki](https://wiki.biligame.com/umamusume)
+ [马娘基础数据库](https://github.com/azmiao/uma_info_data)
+ [台服马娘官网](https://uma.komoejoy.com/)
+ [乌拉拉大胜利](https://urarawin.com/#/)

反馈说明

+ 有空的话建议先看看已关闭的历史issue有没有类似的参考一下
+ 可直接在本仓库提交issue，但最好带上报错的日志完整截图，并说明清楚哦，因为部分从网页获取，所以有BUG请及时反馈适配新页面
+ 目前由于时间关系主要做BUG修改和优化，如果有好的建议/新特性，可以直接提交issue，有空的话会考虑修改/增加

当前支持的功能和支持的服务器

（具体命令请看本页面下方功能命令和描述）

+ 马娘新闻播报【已支持台/日/B服】
+ 马娘模拟抽卡v2【已支持台/日/韩/B服】
+ 马娘基础数据库【台/日/韩/B服通用】
+ 支援卡节奏榜【已支持台/日/B服】
+ 相性计算器【台/日/韩/B服通用】
+ 马娘黄历【台/日/韩/B服通用】
+ 马娘耐力计算器【台/日/韩/B服通用】
+ 马娘表情包【台/日/韩/B服通用】
+ 马娘漫画【台/日/韩/B服通用】
+ 马娘限时任务【台/日/韩/B服通用】
+ 马娘技能查询【台/日/韩/B服通用】
+ 育成目标查询【台/日/韩/B服通用】

版本号的编号方式

+ v2.5.1为例：
+ v2为大版本号，除非有超级有益的重构类大更新，一般不会更新
+ 5为功能迭代版本号，有新功能或者某一功能重写了就会更新
+ 1为BUG修复/数据更新版本号，有关键性的BUG修复或者重要的数据更新就更新
+ 其余不刷版本号的更新，一般来说为不影响大局的BUG修复或小数据更新
+ 末尾带f标识的为强制更新版本，需要手动`git pull -f`来更新

## 本仓库链接

https://github.com/azmiao/uma_plugin/

## 最近的五条更新日志

| 更新时间 | 版本号 | 更新日志&备注 |
|:--------:|:-------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 24-08-31 | v2.9.2 | 规避旧的卡池图片丢失导致的异常，[issue 74](https://github.com/azmiao/uma_plugin/issues/74) |
| 24-04-18 | v2.9.1 | 马娘抽卡功能新增支持自选育成目标，[issue 72](https://github.com/azmiao/uma_plugin/issues/72) |
| 24-04-18 | v2.9.0 | 适配最新的V2数据库，适配新版官网数据，优化代码，[issue 69](https://github.com/azmiao/uma_plugin/issues/69) |
| 24-02-20 | v2.8.7 | 修复特殊卡池导致的更新卡池错误，[issue 67](https://github.com/azmiao/uma_plugin/issues/67) |
| 24-01-22 | v2.8.6f | 一些代码优化，以及由于镜像源问题，修改插件的更新源为官方源.
此次更新请在插件目录下检查`/.git/config`文件中，
`[remote "origin"]`后面的`url: xxxx...`改为
后手动使用`git pull -f`强制更新 |

◆ 2024年的历史更新日志

> 空空如也

◆ 2023年的历史更新日志

+ 23-12-19 v2.8.5 马娘新闻代码整理优化，修复之前增加短链导致的翻译BUG

+ 23-11-21 v2.8.4 马娘新闻链接更换短链，防止tx屏蔽

+ 23-10-23 v2.8.3 修复由于wiki不同地方马娘名不同导致的相性错误，[# 63](https://github.com/azmiao/uma_plugin/issues/63)

+ 23-10-23 v2.8.2 修复一处书写错误导致的BUG，[# 62](https://github.com/azmiao/uma_plugin/issues/62)

+ 23-09-07 v2.8.1 适配国服马娘新闻

+ 23-09-05 v2.8.0 适配国服卡池和支援卡节奏榜

+ 23-08-25 v2.7.14 修复节奏榜获取失败的问题

+ 23-06-28 v2.7.13 修复马娘抽卡由于名称变更导致的部分报错，[# 53](https://github.com/azmiao/uma_plugin/issues/53)

+ 23-04-13 v2.7.12 修复马娘技能页面更新后的刷新报错

+ 23-03-09 v2.7.11 修复马娘漫画由于图片路径变动导致的问题

+ 23-02-24 v2.7.10 修复马娘技能更新失败的问题

+ 23-02-24 v2.7.9 优化部分代码，同步官网更新的马娘数据

+ 23-02-16 v2.7.8 修复限时任务页面更新的问题

+ 23-02-08 v2.7.7 修复节奏榜匹配错误

+ 23-02-07 v2.7.6 修复日服马娘新闻翻译功能

◆ 2022年的历史更新日志

+ 22-11-29 v2.7.5 修复由于UI变动导致的马娘卡池异常，更新后请使用命令“更新马娘卡池”更新一下

+ 22-11-12 v2.7.4 修复模拟抽卡SSR个别出货率比其他高0.026%的BUG，修改R卡卡池逻辑跟随bwiki更新

+ 22-10-30 v2.7.3 新增模拟抽卡频次限制和每日上限，在uma_gacha_v2/\_\_init\_\_.py文件中可自定义修改

+ 22-09-28 v2.7.2 新增由于网络问题导致插件版本获取不到的日志，并更新文档

+ 22-09-01 v2.7.1 修复当前版本为f版本时，更新不迭代版本的更新，缺仍然提示须手动的BUG

+ 22-08-31 v2.7.0f 新增插件统一管理功能，具体配置方式请看本文末‘额外定制配置’，本次也需要`git pull -f`来更新，如果启动的时候获取马娘插件版本报错，请按照定制配置内方法添加代理后再重启bot

+ 22-08-28 v2.6.6f 临时改变节奏榜的内容为bwiki上巅峰杯歌姬杯分开的节奏榜，新增可选设置插件默认服务器，配置方法在本文末。注意：本次更新需要使用命令`git pull -f`来更新，并且定制配置的`properties.json`的配置会回到默认状态须重新设置，另外节奏榜的uma_support_chart文件夹下的日服配置文件`sup_config.json`建议删一下并重启bot再使用。

+ 22-28-28 v2.6.5 修复耐力计算的BUG，修复方案来自[@aaaaaaria](https://github.com/aaaaaaria)，[issue #36](https://github.com/azmiao/uma_plugin/issues/36)

+ 22-08-22 v2.6.4 常规数据更新，新增红宝石和凯斯的别名，更新后记得“手动更新马娘数据”或者等半夜自动更新

+ 22-08-18 v2.6.3 新增图片可选发送形式`properties.json`，配置方法在本文末, [issue #37](https://github.com/azmiao/uma_plugin/issues/37)

+ 22-08-15 v2.6.2 修复台服节奏命名规则修改后产生的BUG

+ 22-08-08 v2.6.1 修复卡池界面更新的BUG

+ 22-08-02 v2.6.0 完全重写马娘抽卡功能，减少人为BUG率，且能切换服务器支持日台韩B服，且能切换卡池，缩减抽卡结果长度防刷屏，[issue #27](https://github.com/azmiao/uma_plugin/issues/27)，[issue #32](https://github.com/azmiao/uma_plugin/issues/32)

+ 22-07-27 v2.5.2 同步官网更新马娘：谋勇兼备，敏锐奇才，北港火山，更新完插件后请使用命令“手动更新马娘数据”

+ 22-07-20 v2.5.1 临时兼容一下最新的卡池，有BUG讲究一下吧，后续打算重写，不然实在不好整

+ 22-07-17 v2.5.0 新增一个小功能“马娘速查”，方便萌新

+ 22-07-16 v2.4.0 美化帮助界面，同时方便autohelp服务模式显示，详情本文末尾

+ 22-07-16 v2.3.1 修复技能查询BUG同时新增繁中技能查询 by[@Yui-xy](https://github.com/Yui-xy)，[issue #28](https://github.com/azmiao/uma_plugin/issues/28)

+ 22-07-08 v2.3.0 新增查询赛程的育成目标功能，使用命令 “查目标角色名” 即可，结果图片仿自bwiki，[issue #25](https://github.com/azmiao/uma_plugin/issues/25)

+ 22-07-06 v2.2.2 修复台服支援卡命名方式变化后的BUG，更新后请务必手动删除uma_support_chart文件夹下的`sup_config_tw.json`再重启hoshino

+ 22-07-05 v2.2.1 修复支援卡节奏榜网页更新后的BUG，更新后请务必手动删除uma_support_chart文件夹下的`sup_config.json`再重启hoshino，[issue #24](https://github.com/azmiao/uma_plugin/issues/24)

+ 22-06-30 v2.2.0 新增台服马娘新闻功能，整进了“马娘新闻帮助”里

+ 22-06-30 v2.1.0 新增台服支援卡节奏榜功能，整进了“支援卡节奏榜帮助”里

+ 22-06-24 v2.0.4 请务必更新！同步translators更新，以便修复马娘新闻翻译显示不全的BUG

+ 22-06-23 v2.0.3 马娘新闻修复不具合翻译不了的BUG和其他遇不到的BUG，且现在支持配置代理，已添加进本文档的食用教程里

+ 22-06-19 v2.0.2 马娘新闻部分代码改进优化，并且翻译结果默认采用转发消息发送，可以自行更换

+ 22-05-05 v2.0.1 优化更新逻辑，当更新失败自动回退防止再次更新时出错，同时更换数据镜像站提高更新速度

+ 22-04-25 v2.0 大版本更新！！！强烈推荐，之后可无需APIKEY，注意：更新后需要更新安装依赖，并重新“手动更新马娘数据”

+ 22-04-24 v1.7 新增马娘技能查询功能

+ 22-04-15 v1.6 新增马娘限时任务功能，并修复一些描述，此版本开始需要更新依赖

+ 22-04-11 v1.5.3 修复图片文件夹的问题，并修复由于也文摄辉背景图分辨率过高导致OCR无结果的问题

+ 22-04-10 v1.5.2 将所有的图片文件夹移动至umamusume文件夹下

+ 22-03-30 v1.5.1 重构支援卡节奏榜代码，理论上性能更好，冗余更低

+ 22-03-28 v1.5 新增马娘一格漫画功能

+ 22-03-28 v1.4 新增马娘表情包功能

+ 22-03-20 v1.3.3 节奏榜新增了友人卡节奏榜

+ 22-03-19 v1.3.2 新增了更新数据时自动下载语音文件，更新到此版本后需要手动更新一下数据，当然等半夜的自动更新也行

+ 22-03-18 v1.3.1 调整了自动更新策略，将在更新时生成一个缓存文件，更新完再复制过去，以防止更新期间部分功能不能用，顺便新增手动更新相性信息功能

+ 22-03-09 v1.3 新增了“马娘耐力计算器”功能，但数据为根性与下坡改版前的数据，且为非常理想的数值

+ 22-03-09 v1.2 一些调整，以及修改部分文件使之规范化github储存库，方便 git pull, [pull #4](https://github.com/azmiao/uma_plugin/pull/4)

+ 22-03-06 v1.1 新增了“马娘签到”功能

+ 22-03-04 v1.0 first commit

## 更新

### 1.如何更新

> 选择一：自动更新

插件已自带更新功能，更新后会发私聊消息到维护者，之后会提醒您手动重启bot完成更新，请确保能链接Github服务器，如不行请按照下面额外定制功能配置代理或者关闭插件自动更新

> 选择二：手动更新

【注意】如果不想插件自动更新，请看下方额外定制功能修改配置。

根据定制功能修改完配置后，如果需要手动更新的话，请在你的 `hoshino/modules/uma_plugin` 文件夹里，打开powershell输入 `git pull` ，运行完重启hoshinoBot即可

如果报错如下：
```
error: Your local changes to the following files would be overwritten by merge:
Please, commit your changes or stash them before you can merge
```
一般是有因为你修改了部分代码导致的，删了它提示的那些文件再`git pull`就好了

### 2.如何查看版本

使用命令：`马娘插件-v`即可查看

### 3.如何跟踪新版

现插件已自带，只要确保bot能访问Github即可，如不能访问请配置代理，方法在下面额外定制功能内，或者关闭自动更新，自己手动更新吧

## 功能命令和描述

维护组的命令

子模块的图片版帮助

![uma_comic](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_comic/uma_comic_help.png)
![uma_compatibility](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_compatibility/uma_compatibility_help.png)
![uma_endurance](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_endurance/uma_endurance_help.png)
![uma_face](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_face/uma_face_help.png)
![uma_gacha_v2](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_gacha_v2/uma_gacha_v2_help.png)
![uma_info](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_info/uma_info_help.png)
![uma_skills](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_skills/uma_skills_help.png)
![uma_support_chart](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_support_chart/uma_support_chart_help.png)
![uma_target](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_target/uma_target_help.png)
![uma_tasks](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_tasks/uma_tasks_help.png)
![umamusume_news](https://raw.githubusercontent.com/azmiao/uma_plugin/main/umamusume_news/umamusume_news_help.png)

### 汇总命令 (群里发送“马娘帮助”也可查看)

![汇总命令](https://raw.githubusercontent.com/azmiao/uma_plugin/main/uma_help.png)

## 插件安装

点我展开

1. git clone本插件（注：一定要git clone，不要下载压缩包，另外请确保git环境变量正常）：

在 HoshinoBot\hoshino\modules 目录下使用以下命令拉取本项目
```
git clone https://github.com/azmiao/uma_plugin
```

2. 安装依赖：

到HoshinoBot\hoshino\modules\uma_plugin目录下，管理员方式打开powershell
```
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --user
```

3. 在 HoshinoBot\hoshino\config\ `__bot__.py` 文件的 MODULES_ON 加入 'uma_plugin'

然后重启 HoshinoBot

装完插件后首次启动时会更新马娘各种数据，按带宽的大小可能需要3-10分钟不等，请耐心等待。

【注意】如果首次启动很快没有新的日志，即没有出现更新操作，请查看日志是否是马娘插件版本获取失败，如是，说明你的服务器连不到Github，需要手动按照下文额外定制功能配置代理或者关闭自动更新功能

4. 手动选择开启是否自动提醒功能：

在某个群里发消息输入下文以开启马娘生日提醒（提醒当天哪知马娘生日）
```
开启 uma_bir_push
```

在某个群里发消息输入下文以开启马娘新闻播报，一个日服，一个台服（推送新闻更新）
```
开启 umamusume-news-poller
```
```
开启 umamusume-news-poller-tw
```

可以通过发消息输入"lssv"查看这个功能前面是不是⚪来确认是否开启成功

## 额外定制配置（可选）

点我展开

### 马娘抽卡自定义冷却和每日上限

具体在uma_gacha_v2/\_\_init\_\_.py文件中可自定义修改，改数字即可，自定义建议关闭插件自动更新，不然可能被自动更新覆盖回默认，大概吧，没有确认过，有好兄弟确认过可以issue里说一下。

```
##########自定义配置##########

# 每个人的指令冷却 | 默认10秒
lmt = FreqLimiter(10)

# 单抽和十连的萝卜上限 | 默认每天30000萝卜
single_limit = DailyNumberLimiter(30000)

# 抽井的次数(马娘池和支援卡池次数共通) | 默认每天15次
tenjo_limit = DailyNumberLimiter(15)

# 抽满破的次数 | 默认每天10次
full_limit = DailyNumberLimiter(10)

# 超过次数的消息
SINGLE_EXCEED_NOTICE = f'您今天已经抽过{single_limit.max}颗萝卜了，欢迎明早5点后再来哦！'
TENJO_EXCEED_NOTICE = f'您今天已经抽过{tenjo_limit.max}张天井券了，欢迎明早5点后再来哦！'
FULL_EXCEED_NOTICE = f'您今天已经抽过{full_limit.max}次支援卡满破了，欢迎明早5点后再来哦！'

#############################
```

### 该功能的所有配置均在插件目录下的 `properties.json` 里

> 可选图片发送形式：

如果你使用docker，且hoshino和gocqhttp不在一个容器里，可选base64，默认file
```
"image_send_form": {
"notes": "图片发送形式，可选值有 [ file | base64 ]",
"current": "file"
},
```

> 可选是否自动更新插件代码：

默认auto，自动更新，将会自动更新插件的代码，不会影响资源的更新，更新完会有私聊消息提醒。【注意】自动更新后也需要手动重启bot，因为插件内部没法仅靠自己实现自动重载

如果想从默认的自动更新换为手动更新，需要更改下面的配置即可。

但是，如果换成手动更新后，又想回自动更新了，那就需要先改下方配置，然后删除插件目录下的`version.json`，没有的话就不用删了，接着`git pull`手动更新一下，再重启bot方可恢复成自动更新
```
"code_auto_update": {
"notes": "插件代码自动更新，默认auto，可选自动更新、不自动更新，对应的可选值是 [ auto | no ]",
"current": "auto"
},
```

> 可选默认服务器

如果你主要玩的不是日服，可以将所有子模块修改至你玩的服务器，可选[ jp | tw | ko | bili ]，切换之后节奏榜和马娘新闻等功能的命令前不加服务器名时，将回复所选的服务器内容
```
"default_server": {
"notes": "一键切换所有子的模块的服务器，可选值有 [ jp | tw | ko | bili ]",
"current": "jp"
},
```

> 可选资源更新周期

默认每天更新一次，同时也会影响插件代码的更新周期
```
"res_update_cycle": {
"notes": "调整图片等资源的数据更新周期，单位：天，默认1，可选值 [ 1 | 2 | 3 | 4 | 5| 6 | 7 ]",
"current": 1
},
```

> 可选是否全插件使用代理

默认不使用，如果你检查马娘插件遇到链接不到Github或查马娘新闻链接官网失败等问题，可以尝试开启
```
"if_use_proxy":{
"notes": "是否全插件均使用代理，默认false",
"current": false
}
```
附：代理的设置在插件目录下的`proxy.json`里，默认代理配置如下，1081记得改成你自己的代理端口
```
{
"http": "http://localhost:1081",
"https": "http://localhost:1081"
}
```

## [AutoHelp](https://github.com/SonderXiaoming/autohelp)推荐配置(可选)

点我展开

安装 [AutoHelp](https://github.com/SonderXiaoming/autohelp) 即可，可显示更好看的帮助界面

你可以选择help模式（推荐，但不是默认）或者读取userreadme模式

关于本马娘插件推荐添加的`black.json`：

```
{
"uma_bir_push",
"umamusume-news-poller",
"umamusume-news-poller-tw",
"umamusume-news-poller-bili"
}
```

推荐添加的`replace.json`：

```
{
"uma_almanac": "马娘黄历",
"uma_comic": "马娘漫画",
"uma_compatibility": "马娘相性",
"uma_endurance": "马娘耐力",
"uma_face": "马娘表情包",
"uma_gacha_v2": "马娘抽卡V2",
"uma_info": "马娘基础数据查询",
"uma_skills": "马娘技能查询",
"uma_support_chart": "马娘支援卡节奏榜",
"uma_target": "马娘育成目标查询",
"uma_tasks": "马娘限时任务查询",
"umamusume_news": "马娘新闻",
"uma_help": "马娘帮助汇总",
}
```

## 鸣谢

[](https://jb.gg/OpenSourceSupport)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/azmiao/uma_plugin

Awesome Lists containing this project

README