uma_plugin

KO | EN

gitlite — search

#javascript #python #hacktoberfest #go #docker #java #windows #awesome #cli #kubernetes #awesome-list #security #ios #mcp

(★ 127)

uma_plugin 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 赛马娘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)

</div>

<a href="https://github.com/azmiao/uma_plugin/blob/main/README.md">文档</a>
 ·
 <a href="https://github.com/azmiao/uma_plugin/issues">问题反馈</a>
 ·
 <a href="https://github.com/azmiao/uma_plugin/discussions">讨论</a>
 ·
 <a href="https://github.com/azmiao/uma_info_data">基础数据库</a>

这是一个适用[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/#/)

</details>

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

</details>

<details>
<summary>当前支持的功能 和 支持的服务器</summary>

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

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

</details>

<details>
<summary>版本号的编号方式</summary>

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

</details>

## 本仓库链接

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...`改为 <https://github.com/azmiao/uma_plugin>后手动使用`git pull -f`强制更新 |

<details>
<summary>◆ 2024年的历史更新日志</summary>

> 空空如也

</details>

<details>
<summary>◆ 2023年的历史更新日志</summary>

+ 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  修复日服马娘新闻翻译功能

</details>

<details>
<summary>◆ 2022年的历史更新日志</summary>

+ 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

</details>

## 更新

### 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即可，如不能访问请配置代理，方法在下面额外定制功能内，或者关闭自动更新，自己手动更新吧

## 功能命令和描述

<details>
<summary>维护组的命令</summary>

</details>

<details>
<summary>子模块的图片版帮助</summary>

![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)

</details>

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

![汇总命令](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"查看这个功能前面是不是⚪来确认是否开启成功

</details>

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

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

具体在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"
}
```

</details>

## [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": "马娘帮助汇总",
}
```
</details>

## 鸣谢

[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" width="200"/>](https://jb.gg/OpenSourceSupport)

uma_plugin

uma_plugin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

uma_plugin

uma_plugin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README