nonebot-plugin-epicfree 0.1.8

A Epic free game info plugin for Nonebot2

Nonebot Plugin EpicFree

🤖 用于获取 Epic 限免游戏资讯的 Nonebot2 插件

安装方法

使用以下命令之一快速安装（若配置了 PyPI 镜像，你可能无法及时检索到插件最新版本）：

nb plugin install nonebot_plugin_epicfree

pip install --upgrade nonebot_plugin_epicfree

重启 Bot 即可体验此插件。

关于 nonebot2 及相关依赖版本

此插件在以下两种环境测试通过！

# 文件夹拷贝方式安装
nonebot2.0.0.a16 nonebot-adapter-cqhttp==2.0.0a16

# 命令行 / 脚手架安装
nonebot2.0.0.b2 nonebot-adapter-onebot==2.0.0b1

此插件在 nonebot2.0.0.b1 下可能不兼容，需要参考 commit 44f4bf8 自行修改 __init__.py 中 T_State 的写法。

在已淘汰的 Nonebot2 适配器 nonebot-adapter-cqhttp 下，通过拷贝文件夹 nonebot_plugin_epicfree 至 Nonebot2 插件目录、手动安装 nonebot-plugin-apscheduler 和 httpx 依赖后仍可正常启用此插件。在未来某个版本会完全移除该适配器支持，请尽快升级至 nonebot-adapter-onebot。

以上述命令行方式安装本插件时，可能由于依赖版本差异报错。对于新手，推荐在安装插件前备份当前环境依赖版本，以便后续恢复：

# 备份当前的依赖版本
pip3 freeze > requirements.txt

# 尝试安装 nonebot_plugin_epicfree

# 若安装出错，可尝试恢复之前备份的依赖版本
pip3 install -r requirements.txt

单独加载此插件

在 Nonebot2 入口文件（例如 bot.py）增加：

nonebot.load_plugin("nonebot_plugin_epicfree")

使用方法

# nonebot_plugin_epicfree/__init__.py#L27
epicMatcher = on_regex("((E|e)(P|p)(I|i)(C|c))?喜(加一|\+1)")

# nonebot_plugin_epicfree/__init__.py#L34
epicSubMatcher = on_regex("喜(加一|\+1)(私聊)?订阅")

发送「喜加一」查找游戏，群组内发送「喜加一订阅」订阅限免游戏资讯。基于正则匹配，所以，甚至「EpIc喜+1」这样的指令都可用！（

限免游戏资讯订阅功能默认在插件文件夹内生成配置文件。但建议自行指定用于存放订阅配置的文件夹，将其写入 resources_dir 环境变量即可。注意该文件夹需要包含一个名为 epicfree 的子文件夹。在 Nonebot2 .env 中填写时注意去除结尾的 /，如果是 Windows 系统应写成形如 D:/path/to/resources_dir。

限免游戏资讯订阅默认每周六 08:08:08 发送，如需自定义请在 .env 中添加格式如下的配置，其中四个数字依次代表 day_of_week hour minute second。

resources_dir="/data/bot/resources"
epic_scheduler="5 8 8 8"

特别鸣谢

@nonebot/nonebot2 | @Mrs4s/go-cqhttp | @DIYgod/RSSHub | @SD4RK/epicstore_api

作者是 Nonebot 新手，代码写的较为粗糙，欢迎提出修改意见或加入此插件开发！溜了溜了...