Practical-Widgets
将任何想到的小功能添加至群聊，小功能来自 您 的反馈及建议
GITHUB项目地址
GITEE项目地址
一.介绍
1. 此项目为靖暄个人制作用于添加任何想到的小功能Mirai Console 插件，同样兼容Mirai core
2. 灵感来源于
| 序号 | 功能 | 来源 |
|---|---|---|
| 1 | 今日人品 | 龙腾猫越的PCL启动器中包含的 今日人品 功能 |
| 2 | 舔狗日记 | ALAPI中的舔狗日记API |
| 3 | 点歌 | 各位大佬制作的点歌插件想着自己也做一个 |
| 4 | new对象 | 呜呜呜, 情人节没人一起过new一个对象陪我过 |
| 5 | hyp相关信息 | 每次想看数据都得上服务器，麻烦死了 |
| 6 | 退群提醒(Alpha) | 来自MiraiForum中@MC__luoluo提出 |
| 7 | 签到(Alpha - 2) | 来自MiraiForum中@De6ris提出自定义消息格式, 此功能用于测试 |
| 8 | 权限系统 | P-W使用者强烈建议 |
3.代码参考于
MiraiForum
官方社区的插件开源代码
4. 当前拥有功能
| 序号 | 功能 | 介绍 |
|---|---|---|
| 1 | 今日人品 | 昨天 真是糟糕透了，一定是人品太低的原因！也不知道 今天 的人品会好起来吗？ |
| 2 | 今日人品排行榜 | 让我看看今天是谁人品最高，帮我抽个心海老婆吧 (原神乱入) |
| 3 | 舔狗日记 | 每天一次的文案，让你当上一名合格的舔狗 |
| 4 | 点歌 | 找到好听的歌想分享, 又不想发链接这么麻烦? 要试试点歌功能吗 |
| 5 | new对象 | 情人节没对象怎么办, 那就 new一个对象吧 |
| 6 | hyp相关信息 | 要来跟我比比数据吗 |
| 7 | 退群提醒(Alpha) | 当群成员退群时, 发送提醒至群内 |
| 8 | 签到(Alpha - 2) | 没什么作用, 用来测试自定义消息格式用 |
| 9 | 权限系统 | 终于有权限系统啦！ |
二.使用方法
从Releases下载插件放置于./plugins
1.指令
无需下载chat-command皆可在聊天内使用指令
仅群内可用
指令前缀: 默认 / 可在配置文件自行定义
| 序号 | 指令 | 功能 |
|---|---|---|
| 0 | /注册 |
向数据库中添加您的数据,注册后可使用以下指令 |
| 1 | /jrrp |
每天一次可查看 今日人品 (可查看src/main/xyz.jxmm/tools/JrrpMap中所有匹配项) |
| 2 | /jrrptop |
查看今日人品排行榜 (可查看src/main/xyz.jxmm/tools/JrrpMap中所有匹配项) |
| 3 | /reset jrrptop |
手动重置今日人品排行榜 如果今日已经有人获取今日人品将一并重置且今日无法再参与排行 |
| 4 | /舔狗日记 |
每天一次可调用API获取 舔狗日记 请前往配置文件填写Token后使用 |
| 5 | /点歌 <歌名> |
基于ALAPI获取音乐卡片, 获取到歌曲列表后请回复 1-10 到自己发送的点歌指令即可 |
| 6 | /new对象 |
每天一次 随机得到群成员作为您今日的new对象 |
| 7 | /hyp <type> <playerID> |
查询hyp相关信息 |
|
8 |
退群提醒 |
|
| 9 | /签到 |
每天一次 存储签到次数 (详细查看数据库) |
2.数据库
-
采用
.json文件格式存储数据,文件位于./PracticalWidgets其中会包含主要数据
data.json, 排行榜数据jrrpTop, new对象数据object.json -
首次启动会自动创建，如果损坏可删除文件后重新启动
请勿手动更改数据库,否则将会导致舔狗日记数据乱码
3.配置文件
- 采用
.properties文件格式储存数据，文件位于./PracticalWidgets/config.properties为未来做准备 - 配置文件有自动更新功能，您只需要在更新新版本后检查更新日志是否有新的配置信息，如果有可进行填写(无需重启即可生效)
4.权限系统
- 采用
.json文件格式存储数据,文件位于./PracticalWidgets/perm - 管理员数据
admin.json - 黑名单数据
blackList.json - 群权限
EnableGroup.json决定群是否启用某功能 - 用户权限
GroupMemberPerm.json决定用户在某群是否拥有某功能权限 - 首次启动会创建, 如某一段数据损坏可删除这一段后重启, 会进行自行修复
- 支持实时修改, 手动更改后无需重启
a.指令
/perm [groupID] [memberID] <type> <true | false>控制群或成员权限/bl <add | rm> <groupID | memberID>添加或删除黑名单
PS: groupID 为填写群号, 且必须在群号前添加 g 否则识别为成员QQ号 例如groupID=g1003931532
b.用法
[...]内为可填内容,<...>内为必填内容groupID为群号,memberID为成员QQ号- 若
[groupID][memberID]均不存在 则控制当前群聊的权限 即EnableGroup.json - 若只存在
[groupID]则控制群号为groupID的群聊权限 即EnableGroup.json - 若只存在
[memberID]则控制当前群聊下, QQ号为memberID的群成员权限 即GroupMemberPerm.json - 若
[groupID][memberID]均存在 则控制群号为groupID下QQ号为memberID的群成员权限 即GroupMemberPerm.json
c.例子
/perm jrrp false关闭当前群聊的jrrp功能/perm g1003931532 jrrp true开启群号1003931532的jrrp功能/perm 1250838250 sign false关闭当前群聊下 QQ号1250838250的sign功能/perm g1003931532 1250838250 hyp true开启群号1003931532下 QQ号1250838250的hyp功能/bl add g1003931532将群1003931532列入黑名单/bl rm 1250838250将QQ号1250838250的用户 移出黑名单
三.更新日志
| 版本号 | 发布时间 | 更新内容 |
|---|---|---|
| V0.1.0 | 2023.02.02 | 首个打包好地插件，拥有其主要功能 [今日人品;舔狗日记] |
| V0.1.1 | 2023.02.02 | 完善代码,修改写法,增加 今日人品排行榜功能 |
|
V0.1.2 |
2023.02.05 |
|
|
V0.1.3 |
2023.02.07 |
|
|
V0.1.4 |
2023.02.05 |
|
|
V0.1.5 |
2023.02.09 |
|
|
V0.2.0 |
2023.02.09 |
|
|
V0.2.5 |
2023.02.15 |
|
| V0.2.6 | 2023.02.17 | 修复 今日人品排行榜 转发信息时锁死末酱, 现改为自动获取到群bot的昵称 |
|
V0.3.0 |
2023.02.19 |
|
|
V0.3.1 |
2023.02.21 |
|
|
V0.3.2 |
2023.02.22 |
|
|
V0.3.3 |
2023.02.24 |
|
|
V0.3.4 |
2023.02.27 |
|
|
V0.4.0 |
2023.02.28 |
|
|
V0.4.1 |
2023.03.06 |
|
|
V0.4.2 - Alpha |
2023.03.25 |
|
|
V0.4.2 - Alpha - 2 |
2023.03.31 |
|
|
V0.4.3 |
2023.09.24 |
|
|
V0.5.0 |
2023.10.08 |
|
|
V0.5.1 |
2023.10.10 |
|
|
V0.5.2 |
2024.02.06 |
|
四.关于
如果您发现 BUG 可以联系靖暄
如果您有 任何想要的功能 也可联系靖暄或者加群提出建议，如果加群请回答您看到此内容的平台(GITHUB; MiraiForum; GITEE) 三选一
如果你也觉得 Practical-Widgets 做的好的话可以给靖暄赞助(备注上您的任意 平台主页地址 及 ID 将会列入赞助列表)
赞助方式如下
