Practical-Widgets
-
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下载插件放置于
./plugins1.指令
无需下载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
退群提醒
- 格式: $memberNick + $quit + , QQ号: + $memberID + , $quitExpress
- 例子: 終末牽挂 退出了群聊, QQ号: 123456
- 请前往配置文件填写
quit和quitExpress字段
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=g1003931532b.用法
[...]内为可填内容,<...>内为必填内容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
- 修复 今日人品排行榜 非固定时间重置BUG 现在为 每次开机 和 每天0点 自动重置
- 新增music目录,为新功能做准备
- 关于 API 锁死问题以及 排行榜建议合并转发 已经纳入规划，未来版本解决
V0.1.3
2023.02.07
- 修复 今日人品排行榜 显示来自何群信息bug
- 改为合并转发方式发送排行榜 (来自MiraiForum中@FIREFAIRY提出的建议)
- 此版本建议尽早更新！此版本建议尽早更新！此版本建议尽早更新！
V0.1.4
2023.02.05
- 修复 舔狗日记 @用户未转义问题
- 新增配置文件，文件目录
./PracticalWidgets/data.properties为将来做准备 - 现有BUG 如果 今日人品排行榜 重复则排行榜将会报错问题 预计下版本(V0.1.5)修复
- 今日人品排行榜将会更换写法，做到区分群聊发送(获取当前群号然后遍历此群的今日人品做排行，这取决于用户在哪个群查看的今日人品)
- 将就着先用着吧，靖暄这边高三应届毕业生，我尽力快点换写法
V0.1.5
2023.02.09
- 配置文件增加用户自定义
今日人品形容词 - 修复
V0.1.4版本 排行榜bug - 修复
舔狗日记无法获取到数据导致数据库报错问题 - 更换
今日人品排行榜写法, 现在可以做到分群发送 排行榜 每个群有不同的排行榜数据 - 更换
舔狗日记获取写法 - 解决数据库乱码问题
- 代码更为完善
V0.2.0
2023.02.09
- 新功能
点歌(欢呼!) - 完善上版本代码
V0.2.5
2023.02.15
- 增加新功能
new对象 - 完善上版本代码
V0.2.6 2023.02.17 修复 今日人品排行榜转发信息时锁死末酱, 现改为自动获取到群bot的昵称V0.3.0
2023.02.19
- 优化上版本代码
- 新增
询hypixel服务器相关信息功能 - 配置文件更新
V0.3.1
2023.02.21
- 修复数据库异常过大问题
- 完善
查询hypixel服务器相关信息功能 - 主数据库更新, 新增版本条目, 方便查看
V0.3.2
2023.02.22
- 经用户反馈, 修复
今日人品排行榜经常缺人问题 - 新增即便是在不同群也能查看到自己的人品值排行榜(在群A获取人品值后在群B再获取一次人品值就会写入数据库保留群B的排行数据)
V0.3.3
2023.02.24
- 修复
hyp相关信息中玩家不存在或数据不存在的报错 或 直接不给回复 问题 (来自MiraiForum中@MC__luoluo提出的反馈) - 修复
自动更新数据库问题 (如果跨多个版本更新可能导致需要重启多次才会完整更新数据库功能) - 预计下版本更新
hyp相关信息中添加更多游戏模式
V0.3.4
2023.02.27
- 修复
hyp相关信息中玩家存在但玩家数据不存在得报错, 现在拥有回复, 且不会在控制台报错 (来自MiraiForum中@MC__luoluo提出的反馈) - 修复
今日人品排行榜中 如果群成员试图 逆天改命 进行重复查询今日人品导致排行榜数据过大问题 (来自GitHub中@光影)
V0.4.0
2023.02.28
- 修复
hyp相关信息中 大部分BUG 现在很少遇到报错, 都带有提示 - 以下内容全部来自MiraiForum中@MC__luoluo提出
- 新增
自定义指令前缀可在配置文件自定义您的指令前缀 默认/ hyp相关信息中player字段 新增显示大厅等级保留三位小数hyp相关信息中player字段 新增显示RANKhyp相关信息中player字段 新增显示玩家皮肤预览
V0.4.1
2023.03.06
hyp信息查询中 新增街机游戏模块/hyp acd <ID>包含了绝大多数的街机游戏模式hyp信息查询中player字段 新增rank赠送数- 修复
hyp信息查询中player字段缺少【MVP++】问题
V0.4.2 - Alpha
2023.03.25
- 该版本为
V0.4.2测试版即上版本的修复版本, 缺少内容待下版本更新 - 修正
hyp信息查询中MVP++判断错误问题 - 为
hyp信息查询中 新增<type>字段错误提醒 - 为
hyp信息查询功能预留文件夹, 用于新模式添加 - 按照 @MC__luoluo 要求 新增退群提醒 (配置文件有更新)
V0.4.2 - Alpha - 2
2023.03.31
- 该版本为
V0.4.2测试版2即上版本的 新功能预发布 版本, 可能存在严重BUG(这次细心了, 不出意外的话是不会有bug的, 但是不出意外的话肯定会出意外) - 新功能
签到但是没有什么实际作用, 属于是按照 MiraiForum 中 De6ris 的要求测试自定义消息结构详细可查看配置文件
V0.4.3
2023.09.24
- 新增可控的退群提醒, 详情见配置文件更新
- 完善了几个测试版
- 修复已知bug
hyp信息查询中 新增密室杀手模块
V0.5.0
2023.10.08
- 新增权限系统
- 新增可选的自动注册功能, 存在于
EnableGroup.json中 - 修复已知bug
这个版本的bug请及时反馈给靖暄!
V0.5.1
2023.10.10
- 修复权限文件无法自动创建问题
- 修复配置文件跨版本更新插件时无法更新配置文件问题
- 新增分群控制退群提醒
V0.5.2
2024.02.06
- 优化
点歌功能详见issues1 hyp信息查询中 新增公会数据hyp信息查询中 新增决斗游戏模块
四.关于
如果您发现 BUG 可以联系靖暄
如果您有 任何想要的功能 也可联系靖暄或者加群提出建议，如果加群请回答您看到此内容的平台(GITHUB; MiraiForum; GITEE) 三选一
如果你也觉得 Practical-Widgets 做的好的话可以给靖暄赞助(备注上您的任意 平台主页地址 及 ID 将会列入赞助列表)
赞助方式如下
-
可以的话……希望可以自己填写对应的人品评价
-
建议将api token设置成用户自己配置而不是写死自己的
-
建议排行榜以转发形式发出…太长了
-
此回复已被删除！ -
@diyigemt 后面写个配置文件吧
-
@firefairy 这个是指自己每天手动指定自己的人品数值？其实可以上配置文件自己去修改数值然后保存，唯一的缺点就是如果今天有人看了舔狗日记的话保存之后会乱码，但是第二天就好了
-
@jxmm52547 不是，是添加每个范围内人品数值的评论 比如 "你今日的人品是：1 评价：干脆414算了。"
-
v0.1.3 调用舔狗日记时[mirai:at:xxxxxxx] 没有转成艾特
-
-
@firefairy 看见了，这个问题在修了，然后是想配合着新内容
-
@firefairy 这个的话，靖暄也想不到怎么形容（文盲），靠你们投稿吧，比如哪个范围用什么句子形容
-
@diyigemt 这个问题解决了，现在有配置文件了，详细可看README.MD
-
@jxmm52547 我意思是可以搞个配置文件自己来填写？毕竟每个人的点都不太一样……
-
@firefairy 啊这样昂，我知道了，那就预计V0.1.5版本吧，我要把排行榜的写法换了，现在的写法有问题，V0.1.4版本只要没人重复人品值的话就不会报错，即使是重复了只要再来一位工具人填充的话也没事了
-
/hyp 报错啊
-
@MC__luoluo 该问题在
V0.3.3版本修复, 详细可查看更新日志 -
可不可以省略掉注册的过程，第一次使用功能就当于注册了
-
@huajisang 当时有人跟我提起过取消注册这个指令 ，第一次使用功能自动注册，后面还是放弃了，一是懒得改了，二是有些人只是用那么一两次功能 而愿意花时间注册的想必是会长期使用的钱，所以就保留了注册节省空间占用
-
/注册 他没反应 有头绪吗
