Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/monsterxcn/nonebot-plugin-gsmaterial

🤖 NoneBot2 原神每日材料查询、升级材料计算插件，数据由安柏计划自动更新
https://github.com/monsterxcn/nonebot-plugin-gsmaterial

game genshin nonebot2 qq

Last synced: 4 months ago
JSON representation

🤖 NoneBot2 原神每日材料查询、升级材料计算插件，数据由安柏计划自动更新

Awesome Lists containing this project

README 

          
NoneBot Plugin GsMaterial



🤖 用于展示原神游戏秘境材料和升级消耗数据的 NoneBot2 插件





  license

  pypi

  python

  QQ Chat Group


  Code style: black

  Imports: isort

  Lint: flake8

  pre-commit




| ![daily 1 avatar](https://github.com/monsterxcn/nonebot-plugin-gsmaterial/assets/22407052/24b343b6-838a-4976-8566-fc14124cc5dd) | ![daily 2 weapon](https://github.com/monsterxcn/nonebot-plugin-gsmaterial/assets/22407052/ef9a9871-1b28-45dc-b52f-02872a319de7) | ![weekly 8](https://github.com/monsterxcn/nonebot-plugin-gsmaterial/assets/22407052/fd90b333-90e6-4d34-9523-1b991eb51945) | ![clac 10000084](https://github.com/monsterxcn/nonebot-plugin-gsmaterial/assets/22407052/2db48921-0dfa-453f-90b3-82d83af1238b) |

|:--:|:--:|:--:|:--:|



## 安装方法



如果你正在使用 2.0.0.beta1 以上版本 NoneBot2，推荐使用以下命令安装：



```bash

# 从 nb_cli 安装

python -m nb_cli plugin install nonebot-plugin-gsmaterial



# 或从 PyPI 安装

python -m pip install nonebot-plugin-gsmaterial

```



## 插件配置



### 环境变量



一般来说，插件安装完成后无需设置环境变量，只需重启 Bot 即可开始使用。你也可以在 NoneBot2 当前使用的 `.env` 文件中添加下面的环境变量，对插件进行更多配置。环境变量修改后需要重启 Bot 才能生效。



 - `tz` 时区设置，默认为 `"Asia/Shanghai"`

   

   如果定时任务时区异常，请查看 [@nonebot/plugin-apscheduler](https://github.com/nonebot/plugin-apscheduler) 文档添加该依赖插件的 `apscheduler_config` 环境变量配置

   

 - `gsmaterial_mirror` 角色及武器图标下载镜像，需提供 `UI_AvatarIcon_Layla.png` 等形式的图片，可供选择的镜像有：

   

   + `https://api.ambr.top/assets/UI/` 安柏计划（默认）

   + `https://enka.network/ui/` Enka.Network

   + `http://file.microgg.cn/ui/` 小灰灰

   

 - `gsmaterial_scheduler` 每日材料订阅推送时间，默认为 `"8:10"`

   

 - `gsmaterial_skip_three` 每日材料是否忽略三星物品，默认为 `true`

   

 - `gsmaterial_config` 插件缓存目录，默认为 NoneBot2 根目录下 `data/gsmaterial` 文件夹，**填写时路径中的反斜杠 `\` 务必全部替换为正斜杠 `/`**

   

 - `gsmaterial_avatar` `gsmaterial_weapon` `gsmaterial_item`

   

   分别为角色图标、武器图标、物品图标文件夹或文件路径。**一般情况不需要配置**。这些配置针对的是已经使用 [@KimigaiiWuyi/GenshinUID](https://github.com/KimigaiiWuyi/GenshinUID) 等插件在本地下载了 GsMaterial 所需资源的用户，合理配置这些环境变量可以避免 GsMaterial 重复下载。如果启用了这些配置，请注意检查 NoneBot2 启动时由此插件输出的 `图片缓存规则`，确保插件正确识别！配置具体填写的形式如下：

   + `/path/to/avatars` 指定某个文件夹。如果 GsMaterial 后续需要补充下载文件，文件命名与当前已有文件的格式一致。如果该文件夹内尚无文件，则 GsMaterial 会在此文件夹下载以 `中文名称.png` 形式命名的文件

   + `/path/to/avatars/10000002.png` 指定某个文件。如果 GsMaterial 后续需要补充下载文件，文件命名规则为 `数字 ID.png`。与此同理，如果填入形如 `../神里绫华.jpg`，后续补充下载文件的命名规则就为 `中文名称.jpg`

   

   [@KimigaiiWuyi/GenshinUID](https://github.com/KimigaiiWuyi/GenshinUID) 用户安装 GsMaterial 后推荐配置：

   ```

   gsmaterial_avatar="/path/to/GenshinUID/resource/chars"  # 填 chars 文件夹实际路径，不要照抄

   gsmaterial_weapon="/path/to/GenshinUID/resource/weapon"  # 填 weapon 文件夹实际路径，不要照抄

   ```



### Cookie 配置



如需使用材料计算功能，请在 `gsmaterial_config` 配置的目录下 cookie.json 文件中以字典形式填入米游社 Cookie，文件中至少需要有 `account_id` 和 `cookie_token`。考虑到 `cookie_token` 有效期比较玄学，建议再多配置一个 `stoken` 来自动更新 `cookie_token`。如果获取到的 `stoken` 以 `v2_` 开头，则还需要再配置一个 `mid`。



**注意**，Cookie 配置不需要普通用户单独配置，只需要 Bot 拥有者配置一个公共 Cookie！



最终你可能写入一个像这样的 cookie.json 文件：



最普通的一种



```json

{

  "account_id": "272894075",

  "cookie_token": "PV6zzXj28UUSUHetJZO2sqEff4sqwdzDAA3Wz3xY",

  "stoken": "5CzsKTYLuoCy4Pf5t7y3bHkS0MjljkOm89rOYfGh"

}

```



使用 stoken v2 的那种



```json

{

  "account_id": "272894075",

  "cookie_token_v2": "PV6zzXj28UUSUHetJZO2sqEff4sqwdzDAA3Wz3xY",

  "stoken": "v2_efTJdH0uiaDIcoVSINjZY9lHOtSRS5NcfREpDUpXX-AQlLujTP2HWbi14TXHrH_dA1Dxw9TdTGG0LiRONpW=",

  "mid": "0cckyppmwl_mhy"

}

```



使用 login_ticket 的那种



login_ticket 获取方式请参考 https://github.com/monsterxcn/nonebot-plugin-gsmaterial/issues/8#issuecomment-1365705339



```json

{

  "account_id": "272894075",

  "login_ticket": "5CzsKTYLuoCy4Pf5t7y3bHkS0MjljkOm89rOYfGh",

  "mid": "0cckyppmwl_mhy"

}

```



## 命令说明



插件响应以下形式的消息：



 - 以 `材料` 开头的消息

   

   | 附带参数 | 说明 |

   |:-------|:----|

   | 空 | 返回今日天赋培养与武器突破材料总图 |

   | `天赋` / `角色` | 返回今日天赋培养材料图片 |

   | `武器` | 返回今日武器突破材料图片 |

   | `周一` / `1` / ... | 返回指定日期的天赋培养与武器突破材料总图 |

   | `更新` | 立即更新每日材料数据，并返回最新的今日天赋培养与武器突破材料总图 |

   | `订阅` | 启用当前消息来源的每日材料订阅，群组内仅 Bot 管理员、群组创建者、群组管理员可操作 |

   | `订阅删除` | 禁用当前消息来源的每日材料订阅，群组内仅 Bot 管理员、群组创建者、群组管理员可操作 |

   

 - 以 `周本` 开头的消息

   

   | 附带参数 | 说明 |

   |:-------|:----|

   | 空 | 返回周本材料总图 |

   | `风龙` / `风魔龙` | 返回 *风魔龙·特瓦林* 掉落材料图片 |

   | `狼` / `北风狼` / `王狼` | 返回 *安德留斯* 掉落材料图片 |

   | `公子` / `达达利亚` / `可达鸭` / `鸭鸭` | 返回 *「公子」* 掉落材料图片 |

   | `若托` / `若陀` / `龙王` | 返回 *若陀龙王* 掉落材料图片 |

   | `女士` / `罗莎琳` / `魔女` | 返回 *「女士」* 掉落材料图片 |

   | `雷神` / `雷电` / `雷军` / `将军` | 返回 *祸津御建鸣神命* 掉落材料图片 |

   | `正机` / `散兵` / `伞兵` / `秘密主` | 返回 *「正机之神」* 掉落材料图片 |

   | `草龙` / `草龙王` / `阿佩普` / `绿洲守望者` | 返回 *阿佩普的绿洲守望者* 掉落材料图片 |

   | `吞星之鲸` / `鲸鱼` / `吞星鲸` | 返回 *吞星之鲸* 掉落材料图片 |

   | `测试` / `未知` / `未实装` / `未上线` | 返回 *尚未实装周本* 掉落材料图片（如果有） |

   

   ![周本总图](https://github.com/monsterxcn/nonebot-plugin-gsmaterial/assets/22407052/952979c8-7c05-4ee5-b065-4ff43069a716)



 - 以 `原神计算` 开头的消息

   

   第一个附带参数 **必须** 为角色名称或武器名称（支持别名），并且与后面的参数 **用空格隔开**。

   

   计算角色时：

   

   + 角色等级允许的输入包括 `90`、`81-90` 等

   + 天赋等级允许的输入包括 `8`、`1-8`、`888`、`81010`、`8 8 8`、`1-8 1-10 10` 等

   + 只计算等级消耗时，可以使用 `111` 作为天赋等级

   + 只计算天赋消耗时，可以使用 `1` 作为角色等级，或者不输入角色等级并在天赋等级前添加「天赋」二字

   + 同时限定天赋等级和天赋等级时，**必须** 角色等级在前、天赋等级在后，中间用空格或「天赋」二字隔开

   + 未限定等级范围时，默认计算角色等级 1-81、三个天赋等级 1-8 消耗的材料

   

   计算武器时：

   

   + 武器等级允许的输入包括 `90`、`81-90`、`81 90` 等

   + 未限定等级范围时，默认计算武器等级 1-90 消耗的材料

   

   此指令附带参数较为复杂，下面是一些举例：

   

   + `原神计算琴` 计算 *琴* 角色等级 1-90、三个天赋等级 1-8 消耗材料

   + `原神计算琴 81` 计算 *琴* 角色等级 1-**81**、三个天赋等级 1-8 消耗材料

   + `原神计算琴 81 111` 计算 *琴* 角色等级 1-**81** 消耗材料

   + `原神计算琴 81-90 111` 计算 *琴* 角色等级 **81**-**90** 消耗材料

   + `原神计算琴 90 8 8-10 10` 计算 *琴* 角色等级 1-**90**、天赋等级 1-**8** **8**-**10** 1-**10** 消耗材料

   + `原神计算琴 1 10` 计算 *琴* 天赋等级 1-**10** 消耗材料

   + `原神计算琴 天赋101010` 计算 *琴* 三个天赋等级均 1-**10** 消耗材料

   + `原神计算琴 天赋 10 1-8 1-10` 计算 *琴* 天赋等级 1-**10** **1**-**8**、**1**-**10** 消耗材料

   + `原神计算狼末 81` 计算 *狼的末路* 等级 1-**81** 消耗材料

   + `原神计算狼末 81 88` 计算 *狼的末路* 等级 **81**-**88** 消耗材料

   

   

   计算角色示例

   

   

   

   计算武器示例

   

   



## 其他说明



 - 插件秘境材料数据来源为 [Project Amber](https://ambr.top/chs)，所有未实装角色及武器的数据均由该数据库提供。

   

 - 插件升级材料数据来源为 [米游社养成计算器](#)，使用此功能需要有效的 `account_id` 和 `cookie_token`。

   

 - 插件使用的所有角色及武器图标会在 Bot 连接建立后从环境变量 `GSMATERIAL_MIRROR` 下载，所有计算器所需图标会在查询时从米游社下载。这些资源通常只需下载一次，其下载路径及保存文件名均可通过环境变量控制，具体说明请查看 [环境变量](#环境变量) 第 5 条。

   

 - 插件的原神每日材料定时推送基于 [@nonebot/plugin-apscheduler](https://github.com/nonebot/plugin-apscheduler)，如果 NoneBot2 启动时插件的定时任务未正常注册，可能需要额外添加该插件的环境变量 `apscheduler_autostart=true` 来使 `scheduler` 自动启动。



## 特别鸣谢



[@Mrs4s/go-cqhttp](https://github.com/Mrs4s/go-cqhttp) | [@nonebot/nonebot2](https://github.com/nonebot/nonebot2) | [@nonebot/plugin-apscheduler](https://github.com/nonebot/plugin-apscheduler) | [@DGP-Studio/Snap.Metadata](https://github.com/DGP-Studio/Snap.Metadata) | [@ctrlcvs/xiaoyao-cvs-plugin](https://github.com/ctrlcvs/xiaoyao-cvs-plugin) | [Project Amber](https://ambr.top/chs)