Package: nonebot-plugin-gsmaterial
NoneBot Plugin GsMaterial🤖 用于展示原神游戏秘境材料和升级消耗数据的 NoneBot2 插件安装方法如果你正在使用 2.0.0.beta1 以上版本 NoneBot2，推荐使用以下命令安装：# 从 nb_cli 安装python-mnb_cliplugininstallnonebot-plugin-gsmaterial# 或从 PyPI 安装python-mpipinstallnonebot-plugin-gsmaterial插件配置环境变量一般来说，插件安装完成后无需设置环境变量，只需重启 Bot 即可开始使用。你也可以在 NoneBot2 当前使用的.env文件中添加下面的环境变量，对插件进行更多配置。环境变量修改后需要重启 Bot 才能生效。tz时区设置，默认为"Asia/Shanghai"如果定时任务时区异常，请查看@nonebot/plugin-apscheduler文档添加该依赖插件的apscheduler_config环境变量配置gsmaterial_mirror角色及武器图标下载镜像，需提供UI_AvatarIcon_Layla.png等形式的图片，可供选择的镜像有：https://api.ambr.top/assets/UI/安柏计划（默认）https://enka.network/ui/Enka.Networkhttp://file.microgg.cn/ui/小灰灰gsmaterial_scheduler每日材料订阅推送时间，默认为"8:10"gsmaterial_skip_three每日材料是否忽略三星物品，默认为truegsmaterial_config插件缓存目录，默认为 NoneBot2 根目录下data/gsmaterial文件夹，填写时路径中的反斜杠\务必全部替换为正斜杠/gsmaterial_avatargsmaterial_weapongsmaterial_item分别为角色图标、武器图标、物品图标文件夹或文件路径。一般情况不需要配置。这些配置针对的是已经使用@KimigaiiWuyi/GenshinUID等插件在本地下载了 GsMaterial 所需资源的用户，合理配置这些环境变量可以避免 GsMaterial 重复下载。如果启用了这些配置，请注意检查 NoneBot2 启动时由此插件输出的图片缓存规则，确保插件正确识别！配置具体填写的形式如下：/path/to/avatars指定某个文件夹。如果 GsMaterial 后续需要补充下载文件，文件命名与当前已有文件的格式一致。如果该文件夹内尚无文件，则 GsMaterial 会在此文件夹下载以中文名称.png形式命名的文件/path/to/avatars/10000002.png指定某个文件。如果 GsMaterial 后续需要补充下载文件，文件命名规则为数字 ID.png。与此同理，如果填入形如../神里绫华.jpg，后续补充下载文件的命名规则就为中文名称.jpg@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 文件：最普通的一种{"account_id":"272894075","cookie_token":"PV6zzXj28UUSUHetJZO2sqEff4sqwdzDAA3Wz3xY","stoken":"5CzsKTYLuoCy4Pf5t7y3bHkS0MjljkOm89rOYfGh"}使用 stoken v2 的那种{"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{"account_id":"272894075","login_ticket":"5CzsKTYLuoCy4Pf5t7y3bHkS0MjljkOm89rOYfGh","mid":"0cckyppmwl_mhy"}命令说明插件响应以下形式的消息：以材料开头的消息附带参数说明空返回今日天赋培养与武器突破材料总图天赋/角色返回今日天赋培养材料图片武器返回今日武器突破材料图片周一/1/ ...返回指定日期的天赋培养与武器突破材料总图更新立即更新每日材料数据，并返回最新的今日天赋培养与武器突破材料总图订阅启用当前消息来源的每日材料订阅，群组内仅 Bot 管理员、群组创建者、群组管理员可操作订阅删除禁用当前消息来源的每日材料订阅，群组内仅 Bot 管理员、群组创建者、群组管理员可操作以周本开头的消息附带参数说明空返回周本材料总图风龙/风魔龙返回风魔龙·特瓦林掉落材料图片狼/北风狼/王狼返回安德留斯掉落材料图片公子/达达利亚/可达鸭/鸭鸭返回「公子」掉落材料图片若托/若陀/龙王返回若陀龙王掉落材料图片女士/罗莎琳/魔女返回「女士」掉落材料图片雷神/雷电/雷军/将军返回祸津御建鸣神命掉落材料图片正机/散兵/伞兵/秘密主返回「正机之神」掉落材料图片草龙/草龙王/阿佩普/绿洲守望者返回阿佩普的绿洲守望者掉落材料图片测试/未知/未实装/未上线返回尚未实装周本掉落材料图片（如果有）以原神计算开头的消息第一个附带参数必须为角色名称或武器名称（支持别名），并且与后面的参数用空格隔开。计算角色时：角色等级允许的输入包括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-88-101-10消耗材料原神计算琴 1 10计算琴天赋等级 1-10消耗材料原神计算琴 天赋101010计算琴三个天赋等级均 1-10消耗材料原神计算琴 天赋 10 1-8 1-10计算琴天赋等级 1-101-8、1-10消耗材料原神计算狼末 81计算狼的末路等级 1-81消耗材料原神计算狼末 81 88计算狼的末路等级81-88消耗材料计算角色示例计算武器示例其他说明插件秘境材料数据来源为Project Amber，所有未实装角色及武器的数据均由该数据库提供。插件升级材料数据来源为米游社养成计算器，使用此功能需要有效的account_id和cookie_token。插件使用的所有角色及武器图标会在 Bot 连接建立后从环境变量GSMATERIAL_MIRROR下载，所有计算器所需图标会在查询时从米游社下载。这些资源通常只需下载一次，其下载路径及保存文件名均可通过环境变量控制，具体说明请查看环境变量第 5 条。插件的原神每日材料定时推送基于@nonebot/plugin-apscheduler，如果 NoneBot2 启动时插件的定时任务未正常注册，可能需要额外添加该插件的环境变量apscheduler_autostart=true来使scheduler自动启动。特别鸣谢@Mrs4s/go-cqhttp|@nonebot/nonebot2|@nonebot/plugin-apscheduler|Project Amber