GitHub Helper

基于 Mirai Console 的 GitHub Notice 订阅插件

Release
Downloads
MiraiForum
GitHub Client Test

使用前应该查阅的相关文档或项目

User Manual Permission Command Chat Command 指令

注意: 使用前请确保可以 在聊天环境执行指令
<...>中的是指令名，例如/repo-issue add mamoe/mirai
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 io.github.gnuf0rce.github-helper:command.*, * 是指令的第一指令名
例如 /repo-issue add mamoe/mirai 的权限ID为 io.github.gnuf0rce.github-helper:command.repo-issue

[repo] 格式为 {owner}/{repo}, 举例 mamoe/mirai
[contact]?是可选的参数，会自动由当前环境填充，例如群聊填充群号，私聊填充QQ号
[type] 消息的格式，可选值为 OLD, TEXT, FORWARD, GRAPH

GitHubIssuesCommand 指令 描述 /<issues> <add> [contact]? 添加订阅 /<issues> <remove> [contact]? 移除订阅 /<issues> <interval> [millis] 设置订阅轮询间隔 /<issues> <format> [type] 设置订阅消息格式 /<issues> <list> [contact]? 查看订阅列表 /<issues> <test> [type] [contact]? 测试订阅

这个指令用于获取当前用户的issues，所以需要有效 token

GitHubRepoCommitCommand 指令 描述 /<repo-commit> <add> [repo] [contact]? 添加订阅 /<repo-commit> <remove> [repo] [contact]? 移除订阅 /<repo-commit> <interval> [repo] [millis] 设置订阅轮询间隔 /<repo-commit> <format> [repo] [type] 设置订阅消息格式 /<repo-commit> <list> [contact]? 查看订阅列表 /<repo-commit> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoIssueCommand 指令 描述 /<repo-issue> <add> [repo] [contact]? 添加订阅 /<repo-issue> <remove> [repo] [contact]? 移除订阅 /<repo-issue> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-issue> <format> [repo] [type] 设置订阅消息格式 /<repo-issue> <list> [contact]? 查看订阅列表 /<repo-issue> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoPullCommand 指令 描述 /<repo-pull> <add> [repo] [contact]? 添加订阅 /<repo-pull> <remove> [repo] [contact]? 移除订阅 /<repo-pull> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-pull> <format> [repo] [type] 设置订阅消息格式 /<repo-pull> <list> [contact]? 查看订阅列表 /<repo-pull> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoReleaseCommand 指令 描述 /<repo-release> <add> [repo] [contact]? 添加订阅 /<repo-release> <remove> [repo] [contact]? 移除订阅 /<repo-release> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-release> <format> [repo] [type] 设置订阅消息格式 /<repo-release> <list> [contact]? 查看订阅列表 /<repo-release> <test> [repo] [type] [contact]? 测试订阅 GitHubStatsCommand 指令 描述 /<stats> <card> [name] 查看状态 /<stats> <contribution> [name] 查看贡献 /<stats> <trophy> [name] 查看奖杯 设置 GithubConfig proxy Format http://127.0.0.1:8080 or socks://127.0.0.1:1080 doh Dns Over Https Url github_token Personal Access Tokens reply_type URL解析回复的消息格式 timeout Http 访问超时时间，单位秒 percentage_member_join 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能 percentages 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能 sign_member_join 加群放行提示信息 github_readme_stats stats card 绘制参数 安装 MCL 指令安装

请确认 mcl.jar 的版本是 2.1.0+
./mcl --update-package io.github.gnuf0rce:github-helper --channel maven-stable --type plugins

手动安装 从 Releases 或者 Maven 下载 mirai2.jar 将其放入 plugins 文件夹中

mirai-console-lolicon

受 ACGPro 启发而写

在群内随机发送来自 Lolicon API v2 的图片(默认30s自动撤回+60s冷却)，支持标签检索和JSON高级检索

也支持简单的自定义命令，自定义回复，是否使用闪照，是否保存图片等等。

具体使用文档在 Wiki 页面

GitHub top language
GitHub
GitHub all releases

一些碎碎念 其实这个插件早在今年一月就加到 awesome-mirai 了，一直懒得放到论坛里，今天更新了4.0.0，想了想还是放过来骗star。所以插件中心呢 最初的目的其实只是写来学习mirai和kotlin的，单纯用了CompositeCommand 来实现，现在码已经变成屎山了，但又不想重构正在努力重构。 总之有什么建议、意见和bug之类的发issue或者直接回帖就行，有时间总会做的。

https://github.com/MrXiaoM/qsign

8.9.58 - 8.9.85 支持。

8.9.88、8.9.90 协议信息包含，可登录不保证可用性

如果你对可快速配置上手的新版插件内置签名服务感兴趣，请参见 MrXiaoM/qsign，目前稳定运行，正在测试中。 能用，不保证以后能用，做好拉闸的准备。
MrXiaoM/qsign 的安装非常简单，只需要寥寥几步即可快速上手。

支持 mirai-core 使用，详见项目地址末尾。

仓库中 txlib 内，除了签名配置外，还有各协议版本的 android_phone.json 和 android_pad.json，这些资料也可以用于 go-cqhttp。

... SignManager

https://mirai.mamoe.net/topic/2421

外置签名服务的图形化搭建方法，更方便不懂得如何编辑配置文件、经常忽略确认版本正不正确的小白使用。

ufq 和 fpv 已删库，导致该软件依赖的下载源消失，已无法使用。

KawaiiMiku(已停更)

https://github.com/MrXiaoM/KawaiiMiku
KawaiiMiku 旧版可使用，已测试通过。但旧版缺少一部分算法。

KawaiiMiku 新版测试未通过，且 KawaiiMiku 不会再更新新版内容，请使用 fix-protocol-version

旧README备份

如果你觉得有用，给本帖点赞或者给仓库点个Star，感谢。

协议库可能撑不了多久了，且用且珍惜。

更多内容

解决 code=45 的详细教程以及注意事项：
https://wiki.mrxiaom.top/mirai/45

捐助

前往 爱发电 捐助我。

IMG_20231011_171334.jpg
mirai，2019——至今。

项目地址：
github
Release：
mirai插件
服务端插件

以下是说明：
全版本支持，发现问题建议在Github发issue，这边可能看不到
LuckPerms与本插件可能冲突，请自行测试

这个插件需要配合MC服务端插件使用

本插件属于socket服务端，因此请先启动Mirai再启动Minecraft服务端。
为了适应某些服务器有多个子服务器，设计上这个插件支持同时连接多个服务器，你只需要把服务端插件安装在各个子服务器即可。
首次启动时会在以下路径创建配置文件 qqnumber groupnumber token，你需要依次填写需要用于发消息的QQ号码，需要发的QQ群号和口令（口令可以随意填写，但是需要与服务端插件口令即token文件中填写的内容一致）

(Mirai主目录)/config/org.shirakawatyu.mc2qc

填写完成以后请重启Mirai

如果需要QQ群转发至Minecraft请点这里

项目地址：
Github
Release：
Github

每当指定群收到消息时，插件会自动通过rcon转发至Minecraft服务器，嗯，就是这么简单
出现问题建议在Github提issue，这边可能看不到
需要Minecraft转发至QQ群请看这里
效果图：
IMG_20220121_211837.png

以下是使用说明：
首先，你需要修改Minecraft服务端 server.properties 文件中的对应内容

rcon.port= #rcon端口号，随便填 enable-rcon= #这里填写true以开启rcon rcon.password= #rcon密码，随便填

本插件在首次启动时会在以下路径创建四个配置文件 ip,port,groupnumber,password，你需要依次填写 服务器IP,服务器rcon端口,需要转发的群号,服务器rcon密码

(mirai主目录)/config/org.shirakawatyu.qc2mc/

配置文件填写例子：一个文件只写一行对应的参数
屏幕截图 2022-01-25 151220.png
插件会在每次接收到消息时读取配置文件，如果配置文件为空或者填写不正确则会抛出异常

更新：
修复了无法指定群号的问题，另外据反馈LuckPerms似乎与本插件冲突，正在排查问题

目前
实现了 OpenAI 中 提供的 Completion 和 Image Generation
chat.jpg
image.jpg
completion.jpg
bind.png

详细文档请阅读 readme
https://github.com/cssxsh/mirai-openai-plugin#readme

有功能BUG或者建议请开 issue
https://github.com/cssxsh/mirai-openai-plugin/issues

Mirai News Reporter

一个简单的每日新闻速报/番剧速报 mirai-console 插件

项目地址:

https://github.com/LinHeLurking/mirai-news-reporter

功能 爬取知乎的一个每日新闻页面, 以图片形式分享. 向机器人说 "今日新闻", "今日速报" 即可触发. 爬取 B 站的今日番剧列表, 以图片形式分享. 用 "今日动画", "今日番剧" 触发. 白名单

为了避免打扰网友, 群聊使用白名单管理. 只有通过命令指定的群聊, 才会在群聊中触发本机器人.

番剧群组白名单和新闻播报群组白名单是分开的两个名单，你可以使用 /reporter_list 命令来管理这两个名单。
该命令允许 show, add, remove 三种后缀。其中 add, remove 两个后缀需要跟一个群号。
在群号之后你可以用 anime, news 来指定操作哪一个白名单（留空表示二者都操作）。

举例如下：

将群号为 123456 的群加入番剧、新闻白名单：
/reporter_list add 123456

将群号为 123456 的群加入番剧白名单：
/reporter_list add 123456 anime

将群号为 123456 的群加入新闻白名单：
/reporter_list add 123456 news

更多命令细节可以通过 /help 获取.

自定义语句

Bot 在回复命令时的很多语句，都可以通过 /reporter_msg 命令来自定义。

命令格式： /reporter_msg <key> <list>。

其中，<key> 的可能取值及其含义见下表。
<list> 是一个用逗号或分号分割的列表（也可以只是一个词），中文标点和英文标点都可以，但是不能有空格。
<list> 表示相应的用户发出触发语句可以使用 <list> 中的任何一个，
而机器人回复的语句会在列表中随机选取。

key 默认值 含义 dailyTriggers 今日,每日,日常,daily,Daily "今日番剧"/“每日新闻” 中的 “今日/每日” animeTriggers 番剧,动画,B站番剧,B站番剧 "今日番剧"/“每日动画” 中的 “番剧/动画” newsTriggers 新闻,速报,新闻速报 "今日新闻"/“每日速报” 中的 “新闻/速报” waitMessages 稍等哦QwQ 需要进行长加载时的提示语 animeDailyMessages 早上好呀,这是今天的B站番剧\n(•̀ω•́)✧ 早上的自动动画播报提示 animeReplyMessages 这是今天的B站番剧\n(•̀ω•́)✧ 用关键词触发播报后的回复语 noAnimeMessages 好像今天没有放送呢>_< 今天没有番剧时的提示语 newsDailyMessages 这是今天的新闻速报\nq(≧▽≦q) 早上的自动新闻播报提示 newsReplyMessages "这是今天的新闻速报 \nq(≧▽≦q)" 用关键词触发播报后的回复语 noDisturbingGroupMessages 为了防止打扰到网友，这个群不在日报白名单呢QwQ 白名单提示 errorMessages 出错啦,等会再试试吧￣へ￣ 错误提示

上述的 key，写成单数形式也 OK

效果展示

目前排版还不是很好, 以后找机会继续优化.

效果展示：

今日番剧:

000000000-000000000-00F92DB7B9564739595DD98104249079

今日新闻:

000000000-000000000-97C34B229D32E4E897AE6F268A950E3B

Petpet - 生成各种奇怪的图片 已更新 6.0版本, 支持多线程, 可自定义 头像 文字 坐标 概率 关键词 频率限制 等参数

项目地址 releases 前端版本 / 功能预览

如果你觉得此插件对你有帮助, 请在此帖下回复不错的插件 让更多人看到, 这对我非常重要!

Petpet

Mirai version
GitHub
GitHub all releases
GitHub Repo stars
GitHub release (latest by date)
GitHub issues
GitHub closed issues
GitHub closed pull requests

自定义合成图片的 Mirai 插件 / 独立程序 / gocq-http插件, 灵感/部分数据来自 nonebot-plugin-petpet。

原生 java 编写, kotlin仅用于数据序列化, 使用底层API, 多线程优化: 轻量, 高性能, 易拓展

在线编辑器

JS 前端版本

在线体验

使用方法 单独运行

下载 最新版本 petpet.jar 或 petpet-no-ws.jar

下载 图片素材

将图片素材放入 ./data/xmmt.dituon.petpet/ 目录

运行 start.bat 或 start.sh, 可自行更改配置文件 config.json, 重启后生效

参考WebServer一节 发起网络请求 / 或使用WebUI

Mirai插件

部署 Mirai 机器人框架

下载 最新版本

将插件放入 Mirai/plugins/

下载 图片素材

将图片素材放入 Mirai/data/xmmt.dituon.petpet/

启动 Mirai, 可自行更改配置文件 Petpet.yml, 重启后生效 (参考 配置项说明)

使用 戳一戳 有 30% 的概率触发; 或发送 pet @xxx

pet key @xxx 或 key @xxx 可返回指定图片 例如 pet kiss @xxx kiss @xxx

可通过发送的图片生成Petpet kiss [图片], 支持GIF

可通过回复构造图片, 例如 [图片] -> [回复[图片]] 对称

可使用 pet指令 获取 keyList

gocq-http插件

Warning

此功能处于测试阶段, 目前仅能通过key生成图片, 请期待后续开发!

部署 gocq-http 机器人框架, 设置正向 WebSocket 监听 (默认端口为8080)

更改 gocq-http 配置项 message.post-format 为 array

下载 最新版本 petpet.jar

下载 图片素材

将图片素材放入 ./data/xmmt.dituon.petpet/ 目录

cd ./ java -jar petpet.jar -gocq, 可自行更改配置文件 gocq-config.json, 重启后生效

配置文件 配置项说明

<details>

<summary>展开/收起</summary>
<br/>

command: pet

触发petpet指令, 默认为pet

例: pet @xxx pet kiss @xxx

仅发送pet时会返回keyList
<br/>

probability: 30

戳一戳 触发概率, 0-100整数, 默认为 30%
<br/>

antialias: true

画布抗锯齿, 默认为true
<br/>

resampling: true

重采样缩放, 启用后头像质量更高, 可对模板单独配置
<br/>

disabled: []

禁用表列, 默认为空, 在此数组中的key不会被随机触发 (会覆盖data.json中的配置)
<br/>

keyCommandHead: ''

key作为指令头时的前缀, 默认为空

例 (配置项为'#'时): #kiss @xxx osu hso!
<br/>

respondReply: true

响应回复的消息, 默认为true

可通过回复消息 定位到之前发送的图片并构造petpet

启用后 会缓存接收到的图片(见cachePoolSize)

例 : [回复[图片]]kiss(等价于 kiss [图片])
<br/>

cachePoolSize: 10000

respondReply=true时, 图片消息缓存池大小, 默认为10000

本质为HashMap<imageId(long), imageUrl(String)>, 超过此限制会清空Map
<br/>

respondSelfNudge: false

某些情况下, 机器人会主动戳其他成员, 响应机器人自己发出的戳一戳, 默认为false
<br/>

keyListFormat: FORWARD

发送pet时 keyList响应格式, 默认为FORWARD

枚举: MESSAGE(发送普通消息) FORWARD(发送转发消息) IMAGE(发送图片)
<br/>

disablePolicy: FULL

发送pet on/off时 禁用哪些功能, 默认为FULL

枚举: NONE(无效) NUDGE(只禁用戳一戳) MESSAGE(只禁用指令) FULL(同时禁用戳一戳和指令)

fuzzy: false

模糊匹配用户名, 默认为false

例 : (配置项为true时): kiss @田所浩二(响应) kiss 浩二(响应)
<br/>

strictCommand: true

严格匹配指令, 默认为true

人话: 可以省略key后的空格

例 : (配置项为false时): kiss 田所(响应) kiss田所(响应)
<br/>

synchronized: false

消息事件同步锁, 会锁住相同的消息事件, 默认为false

人话: 多机器人对于同一条指令只有一个会响应
<br/>

gifEncoder: ANIMATED_LIB

GIF编码器, 默认为ANIMATED_LIB

枚举:
BUFFERED_STREAM:
基于缓存的STREAM流, 在编码过程中对Gif进行压缩;

编码速度较慢, 所需堆内存小, 生成Gif体积小

ANIMATED_LIB:
基于byte[]序列, 使用多线程分析像素;

编码速度极快, 所需堆内存较多, 生成Gif体积较小

<br/>

gifMaxSize: []

GIF缩放阈值/尺寸, 默认为空 (不限制)

[width, height, frameLength]:

当Gif长度超过frameLength时, 会对Gif进行等比例缩放

注: 缩放在图片合成时进行, 不会影响性能

例: (配置项为[200, 200, 32]时)

当Gif长度超过32帧时, 检查Gif尺寸 当Gif尺寸大于200*200时, 对Gif进行等比例缩放 Gif缩放后 最长边不会超过设定值
(当Gif中包含40帧, 尺寸为300*500时) 输出的Gif长度不变, 尺寸为120*200

gifQuality: 5

Gif编码质量(1-49), 默认为5

数字越小, 速度越慢, 质量越好 (大于20时, 速度不会有明显提升)

仅适用于ANIMATED_LIB编码器

headless: true

启用headless模式, 默认为true

人话: 有些服务器没有输入输出设备, 画图库无法正常运行, 启用这个配置项可以修复, 因为总是有人不看常见问题, 干脆默认启用了(
<br/>

autoUpdate: true

自动更新PetData, 每次启动时都会检查并自动下载船新pet, 默认为true

注: 仅更新PetData, 不会更新插件版本, 请放心食用

人话: 每次启动都会自动下载新的超赞梗图, 墙裂推荐
<br/>

repositoryUrl: 'https://dituon.github.io/petpet'

仓库地址, 用于自动更新, 默认为此仓库的github page

devMode: false

开发模式, 启用后任何人都能使用pet reload指令热重载PetData, 默认为false
<br/>

messageHook: false

消息注入, 参考MessageHook, 默认为false
<br/>

coolDown: 1000

成功触发指令后对该用户的冷却时间(单位为毫秒), 默认为 1000

设置为 -1 可禁用冷却
<br/>

groupCoolDown: -1

成功触发指令后对该群聊的冷却时间, 默认为 -1
<br/>

inCoolDownMessage: 技能冷却中...

在冷却时间中触发命令的回复消息

配置项为[nudge]时, 会以戳一戳形式回复
<br/>

</details>

修改后重启 Mirai 以重新加载

权限管理

群主或管理员使用 pet on pet off 以 启用/禁用 戳一戳

pet on/off指令控制的事件可在配置文件中更改

可在配置文件中禁用指定key, 被禁用的key不会随机触发, 但仍可以通过指令使用

图片预览

在线尝试

自定义

在线编辑器

data.json

./data/xmmt.dituon.petpet/ 下的目录名为 key ，插件启动时会遍历 ./data/xmmt.dituon.petpet/$key/data.json

data.json 是模板配置文件, 程序解析此文件以生成图像

{ "type": "GIF", "avatar": [], "text": [], "delay": 50, "alias": [ "别名1", "别名2" ] } 属性 类型 注释 默认值 type 模板类型枚举 图片类型枚举, IMG或GIF 必须 avatar Avatar 数组 头像配置数组, 见下文 必须 text Text 数组 文本配置数组, 见下文 必须 inRandomList 布尔值 是否在随机列表中 false reverse 布尔值 GIF是否倒放 false delay 整数 帧间延时 (毫秒) 65 background Background 背景配置, 见下文 null alias 字符串数组 别名数组 [] hidden 布尔值 是否隐藏 false 模板类型枚举 GIF 动图, 程序会读取目录下所有.png格式的图像 IMG 静态图片, 程序会读取目录下随机.png格式的图像 头像

程序支持复杂的图像处理, 包括裁切, 旋转, 透明度, 滤镜等

{ "avatar": [ { "type": "FROM", "pos": [[92, 64, 40, 40], [135, 40, 40, 40], [84, 105, 40, 40]], "round": true, "rotate": false, "avatarOnTop": true, "angle": 90 }, { "type": "TO", "pos": [[5, 8], [60, 90], [50, 90], [50, 0], [60, 120]], "posType": "DEFORM", "opacity": 0.5 } ] } 属性 类型 注释 默认值 type 头像类型枚举 见下文, 例如FROM或TO 必须 pos 坐标数组 头像的坐标信息 必须 posType 坐标格式枚举 坐标格式枚举, ZOOM或DEFORM ZOOM round 布尔值 头像是否裁切为圆形 false avatarOnTop 布尔值 头像图层是否在背景之上 true angle 整数 头像的初始角度 0 origin 旋转原点枚举 头像的旋转原点 DEFAULT opacity 浮点数 头像的不透明度 1.0 rotate 布尔值 GIF类型的头像是否旋转 false fit 填充模式枚举 填充模式枚举, 可以是CONTAIN或FILL FILL crop 裁切坐标数组 头像裁切坐标信息 null cropType 裁切格式枚举 见下文 NONE style 风格化枚举数组 风格化枚举数组, 见下文 [] filter 滤镜对象数组 滤镜数组, 见下文 [] antialias 布尔值 是否使用抗锯齿算法, 默认跟随全局配置 null resampling 布尔值 是否使用重采样缩放, 默认跟随全局配置 null

头像类型枚举 type

FROM 发送者头像 TO 接收者头像, 或构造的图片 GROUP 群头像 BOT 机器人头像 RANDOM 随机头像 (随机从群聊成员中选择, 不会重复) 坐标

坐标格式枚举posType

ZOOM 缩放, 通过 x, y, width, height 表示图像 DEFORM 变形, 通过四点坐标来表示图像 ZOOM

ZOOM 缩放坐标的基本组成单位是 4长度 int[] 数组

其中，前两项为 左上角顶点坐标， 后两项为 宽度和高度

例:
[65, 128, 77, 72] 即 头像的左上角顶点坐标是 (65,128), 宽度为 77, 高度为 72

如果是 GIF 类型，坐标应为二维数组，GIF 的每一帧视为单个图像文件

{ // pos的元素对应GIF的4帧 "pos": [[65, 128, 77, 72], [67, 128, 73, 72], [54, 139, 94, 61], [57, 135, 86, 65]] }

如果是IMG类型, 可以使用一维数组

{ "pos": [0, 0, 200, 200] }

坐标支持变量运算, 例如 [100,100,"width/2","height*1.5^2"]

坐标变量

width 原图宽度 height 原图高度 DEFORM

DEFORM 仿射变换坐标格式为 [[x1,y1],[x2,y2],[x3,y3],[x4,y4],[x_anchor,y_anchor]];
分别对应图片的[[左上角],[左下角],[右下角],[右上角],[锚点]]，四角坐标用相对于锚点的偏移量表示

旋转原点枚举 origin

DEFAULT 左上角 CENTER 中心 裁切

图片裁切坐标 [x1, y1, x2, y2], [0, 0, x2, y2] 可简写为 [x2, y2]

裁切格式枚举 cropType

NONE 不裁切 PIXEL 按像素裁切 PERCENT 按百分比裁切

填充模式 fit

CONTAIN 缩小以适应画布, 不改变原比例 COVER 裁切以适应画布, 不改变原比例 FILL 拉伸, 改变原比例

风格化枚举 style

MIRROR 水平镜像 FLIP 上下翻转 GRAY 灰度化 BINARIZATION 二值化 滤镜 filter

通过滤镜实现头像特效, Java 与 JavaScript 版本实现有偏差, 并非完全相同

{ "filter": [ { "type": "SWIRL", "radius": 200, "angle": 5.0 } ] } 滤镜类型 type SWIRL 对应 AvatarSwirlFilter BULGE 对应 AvatarBulgeFilter BLUR 对应 AvatarBlurFilter CONTRAST 对应 AvatarContrastFilter HSB 对应 AvatarHSBFilter HALFTONE 对应 AvatarHalftoneFilter DOT_SCREEN 对应 AvatarDotScreenFilter NOISE 对应 AvatarNoiseFilter DENOISE 对应 AvatarDenoiseFilter 滤镜对象 AvatarSwirlFilter 对象, 漩涡滤镜 属性 类型 注释 默认值 radius 浮点数 涡旋半径, 值为0时表示图片半径 0.0 angle 浮点数 涡旋角度 3.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarBulgeFilter 对象, 膨胀收缩滤镜 属性 类型 注释 默认值 radius 浮点数 膨胀半径, 值为0时表示图片半径 0.0 strength 浮点数 膨胀强度 [-1, 1], 负数时产生收缩效果 0.5 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarBlurFilter 对象, 模糊滤镜 属性 类型 注释 默认值 radius 浮点数 模糊半径 10.0 AvatarContrastFilter 对象, 亮度对比度滤镜 属性 类型 注释 默认值 brightness 浮点数 亮度 0.0 contrast 浮点数 对比度 0.0 AvatarHSBFilter 对象, 相对HSB (色相, 饱和度, 亮度) 滤镜 属性 类型 注释 默认值 hue 浮点数 色相 0.0 saturation 浮点数 饱和度 0.0 brightness 浮点数 亮度 0.0 AvatarHalftoneFilter 对象, 半色调滤镜 (模仿彩色印刷的CMYK色彩) 属性 类型 注释 默认值 angle 浮点数 角度 0.0 radius 浮点数 半径 4.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarDotScreenFilter 对象, 单色点阵滤镜 (模仿黑白印刷品) 属性 类型 注释 默认值 angle 浮点数 角度 0.0 radius 浮点数 半径 4.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarNoiseFilter 对象, 噪声滤镜 属性 类型 注释 默认值 amount 浮点数 噪声强度 0.25 AvatarDenoiseFilter 对象, 降噪滤镜 属性 类型 注释 默认值 exponent 短整数 指数 20 文字

如果你想在图片上添加文字，可以编辑 text

{ "text": [ { "text": "Petpet!", // 文字内容 "color": "#66ccff", // 颜色, 默认为#191919 "pos": [100, 100], // 坐标 "size": 24 // 字号, 默认为12 }, { "text": "发送者: $from, 接收者: $to", // 支持变量 "pos": [20, 150], // 坐标 "position": ["CENTER", "BOTTOM"], //坐标计算基准([x, y]) "font": "宋体", // 字体, 默认为黑体 "strokeColor": "#ffffff", // 描边颜色 "strokeSize": 2 // 描边宽度 }, { "text": "$txt1[我]超市$txt2[你]!", // 支持关键词变量 "pos": [0,200,300], // 第三个值为文本最大宽度 "align": "CENTER", // 对齐方式, 默认为LEFT "wrap": "ZOOM", // 显示设置, 默认为NONE "style": "BOLD" // 字体样式, 默认为PLAIN } ] } 属性 类型 注释 默认值 text 字符串 文本内容 必须 pos 数组 文本的坐标信息 必须 color 字符串 文本颜色 #191919 size 整数 文本字号 12 angle 整数 头像的初始角度 0 origin 旋转原点枚举 文字的旋转原点 DEFAULT position 数组 文本坐标计算基准 [LEFT, TOP] font 字符串 字体 黑体 strokeColor 字符串 文本描边颜色 null strokeSize 整数 文本描边宽度 0 align 字符串 文本对齐方式 LEFT wrap 字符串 文本显示设置 NONE style 字符串 字体样式 PLAIN greedy 布尔值 是否贪婪匹配多余的关键词 false

变量

$from : 发送者, 会被替换为发送者昵称 $to : 接收者, 被戳或At的对象 $group : 群名称 $txt(i)[(xxx)] : 文本变量, 可用于生成meme图, i为关键词索引, xxx为默认值; 例: $txt1[我]超市$txt2[你] 指令为 pet [key] 我 你

font

在data/fonts目录下的字体文件会注册到环境中

align

LEFT: 左对齐, 文本基线是标准的字母基线 RIGHT: 右对齐, 文本基线是标准的字母基线 CENTER: 居中对齐, 文本基线在文本块的中间

wrap

NONE: 不换行 BREAK: 自动换行, 超过最大宽度的文本会显示在下一行 ZOOM: 自动缩放, 缩放字体大小以填充最大宽度

使用BREAK或ZOOM时, maxWidth 默认为 200

style

PLAIN: 默认 BOLD: 粗体 ITALIC: 斜体 BOLD_ITALIC: 粗体与斜体

position

LEFT: 左定位(默认) RIGHT: 右定位 TOP: 上定位(默认) BOTTOM: 下定位 CENTER: 居中定位 background

程序支持动态创建画布

{ "background": { "size": ["avatar0Width*2","avatar0Height"], //支持变量运算 "color": "#f0f0f0" } }

坐标变量

avatar(i)Width i号头像(i为定义头像时的顺序, 从0开始)处理后的宽度 avatar(i)Height i号头像处理后的高度 text(i)Width i号文本渲染后的宽度 text(i)Height i号文本渲染后的高度 MessageHook

本特性仅适用于 Mirai 插件, 消息注入, 插件会检查将要发送的消息 解析后注入图片, 可配合各类消息回复插件使用

<pet></pet> 标签中的JSON会被解析, 请求格式参考 WebServer.POST

用例:

这段文字之后的标签会变成一张图片发送<pet>{ "key": "petpet", "to": { "qq": 2544193782 }, "textList": [ "text1" ] }</pet>消息的顺序会被正确处理, 支持多张图片

不同于 POST 请求格式, 你可以用 "qq" 令程序自动获取头像和昵称, 也可以自定义"name" "avatar"
(更推荐自定义的做法, 程序可能在某些情况下无法推断出正确的"name")

被"hidden": true隐藏的模板会正常调用

此功能默认禁用, 需在配置文件中启用messageHook: true

WebServer

程序可作为http服务器 / API单独运行, 被其它项目/语言使用

java -jar petpet.jar

启动时会生成 config.json:

{ "port": 2333, // 监听端口 "webServerThreadPoolSize": 10, // HTTP服务器线程池容量 "dataPath": "data/xmmt.dituon.petpet", // PetData路径 "preview": false, // 启用动态预览 (启动时生成所有模板预览) "antialias": true, // 启用抗锯齿, 详见上文 "resampling": true, // 启用重采样, 详见上文 "gifMaxSize": [200, 200, 32], // GIF缩放阈值, 详见上文 "gifEncoder": "ANIMATED_LIB", // GIF编码器, 详见上文 "gifQuality": 5, // GIF质量, 详见上文 "threadPoolSize": 0, // GIF编码器线程池容量, 详见上文 "headless": true // 使用headless模式 }

程序使用com.sun.net.httpserver实现http服务器

PetServer API

访问 127.0.0.1:2333/petpet 以获取 PetDataList

GET

使用 GET 传递参数, 例如 127.0.0.1:2333/petpet?key=petpet&toAvatar=$avatarUrl
127.0.0.1:2333/petpet?key=osu&textList=hso!

结构
<details>
<summary>展开/收起</summary>

key (str): 对应PetData,例如kiss rub fromAvatar toAvatar groupAvatar botAvatar (url): 头像URL地址, encodeURIComponent(rawUrl) randomAvatarList (url[]): 随机头像列表, 使用,分割多个url fromName toName groupName (str): 昵称, 有默认值 textList (str): 根据空格分割此字符串, 作为额外数据
</details> POST

使用 POST 传递参数, 例如 127.0.0.1:2333/petpet

{ "key": "petpet", "to": { "name":"d2n", "avatar":"https://q1.qlogo.cn/g?b=qq&nk=2544193782&s=640" }, "randomAvatarList": [ "url" ], "textList": [ "text" ] }

其中, key为必须项, 其它可以省略

form-data

可直接将图片二进制文件上传至服务器进行处理

类似于 GET数据结构, 使用 multipart/form-data

可参考example-script中的代码实现请求

语言 示例 javascript post.js get.js python example.py php example.php WebUI

启动WebServer后即可使用WebUI

启用preview配置项以加载WebUI模板预览 (可选, 默认关闭)

修改 server-config.json preview: true 常见问题

戳一戳无法触发?

检查 Mirai 登录协议, 仅 ANDORID_PHONE 可以收到 戳一戳 消息

没有生成配置文件?

Mirai 2.11.0 提供了新的 JavaAutoSaveConfig 方法, 请更新Mirai版本至 2.11.0 (不是2.11.0-M1), 旧版本不支持自定义配置项

Could not initialize class java.awt.Toolkit?

对于无输入输出设备的服务器 需要启用headless

自动更新下载速度慢 / 无法连接远程资源?

修改Petpet.yml中repositoryUrl的值为'https://ghproxy.com/https://raw.githubusercontent.com/Dituon/petpet/main'(高速镜像)

自动更新后 读取data.json出错?

自动更新时网络出错导致, 删除出错的文件 重新获取即可

其它错误? 问题?

若此文档无法解决您的问题, 欢迎提交issue

性能 & 兼容性

程序使用底层java.awt类合成图片, 渲染时使用多线程, 静态图片渲染时间一般不会超过1ms

对GIF编码器的分析, 转换, 映射部分进行多线程优化, 速度极快

Android JVM没有实现java.awt, 推荐使用JDK 11+版本

分享你的作品 (模板)

如果你想分享自定义的 Petpet, 欢迎Pr

二次开发

程序提供超多实用API 拓展性极强, 附有互动式开发实例, 欢迎初学者学习!

互动式开发实例 参见test.moe.dituon.petpet.example.HelloPetpet

在别的项目二次开发: mirai-simplepetpet-plugin

后话

如果此插件和您预期的一样正常工作，请给我一个 star

欢迎提交任何请求

交流群: 828350277

更新啦~(≧▽≦)/~
版本v1.1
插件地址: ChineseChess

这是一个用java写的中国象棋插件

效果展示
功能介绍
如何使用
项目地址

效果展示
红黑方视角
1.黑方"士6进5"行棋完毕，出现黑方走子提示。当前该红方行棋，所以棋盘是红方视角。
1.jpg

2.红方"炮8进7"行棋完毕，出现红方走子提示。当前该黑方行棋，所以棋盘是黑方视角。
2.jpg

棋盘和棋子风格
3.支持棋盘风格，棋子风格的切换（需要对应素材）。目前上传了几款棋盘风格，可以在imgae/map/文件夹下查看

3.1 花时舞者-神里凌华
3.jpg

3.2 清凉夏日-猫羽雫
4.jpg

注：双方的棋盘和棋盘风格是独立的，棋子和棋盘也可以任意搭配

别急，看看下面再走啊

功能介绍
目前完成了基本的中国象棋功能，需通过标准命令（棋谱命令）行棋

双人棋和四人棋（联棋），多人棋
5.jpg

盲棋
开启盲棋功能则不发送图片，改为发送文字提示，盲棋功能可随时关闭

7.jpg

其他功能：悔棋，认输，换人，掀棋盘等
注：考虑到难度与性能问题，暂时没有绝杀判断，需要吃掉对方的将帅或者认输才能判定输赢

插件地址: ChineseChess

克隆: git clone https://github.com/BigCherryBall/ChineseChess.git

项目地址
https://github.com/Kloping/Mirai_Plugins_Auto_Reply
下载地址
https://github.com/Kloping/Mirai_Plugins_Auto_Reply/releases

29b9b171-8b00-45d4-a21c-3d48862c122f-06b710c4-adb1-4338-b0cd-bdd896edaa06-image.png

目前已实现的功能

定时消息发送 网页管理 cron 定时消息 消息分段发送 指定id触发(开关)

更详细内容请阅读 https://github.com/cssxsh/meme-helper#readme

v1.1.4+ 版本已解决兼容性问题，不再需要额外配置
termux 和 windows 7 请看
https://github.com/cssxsh/mirai-skia-plugin/issues/2

插件权限ID xyz.cssxsh.mirai.plugin.meme-helper:*，使用前授予权限

插件依赖于 Mirai Skia Plugin (必要)
插件依赖于 Mirai Hibernate Plugin (不必要)

目前插件开发处于实验性阶段

基本功能 PornHub

PornHub Login 生成

示例: #ph Git Hub
pornhub

PetPet

摸摸头生成

可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
示例: #pet @群主, #pet 123456
petpet

Dear

狂亲表情包生成

可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
示例: #dear @群主, #dear 123456
dear

5000choyen

5000choyen 表情包生成

示例: #choyen 我想吃 肯德基疯狂星期四套餐
5000choyen

zzkia

诺基亚短信 表情包生成

示例: #pinyin 无内鬼，来点色图
zzkia

游戏王

游戏王 表情包生成
可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
可以使用 xxx=yyy, 指定属性，可选属性有：

卡片名称: name 怪兽属性: attr = dark, divine, earth, fire, light, spell, trap, water, wind 怪兽等级: level 怪兽种族: race 怪兽攻击: atk 怪兽防御: def 卡片版权：copyright

示例:

#spell @Him188 Welcome PR 你可以PR

spell

#trap @Him188 Useless PR 这个还是由我们自己实现

trap

#monster @LaoLittle 援交JD 五元一次

monster

随机表情包

随机表情包一张（通过 Mirai Hibernate Plugin 插件 从消息中收集得到）

示例: #群友表情

Emoji合成

Google Emoji Kitchen，两个 emoji 合成 一个

示例: 😍+🥵
u1f60d_u1f975.png

cssxsh created this issue in cssxsh/mirai-skia-plugin closed skiko 兼容性问题 #2

maimai-bot

项目地址 下载

开箱即用的 maimai 机器人插件，安装进 MCL 后无需复杂操作或手动下载庞大的资源包，可直接使用。

目前已支持的功能：

b40 / b50 查询 随机歌曲 谱面详情 按名称 / 别名 / 定数查歌 分数线 猜歌 牌子 / 等级进度 info 随机推分金曲 / 随机推分列表

KeywordRemind 关键词提醒插件

可在QQ群内根据关键词提醒事项并@参与人

食用方法

运行 Mirai Console 生成plugins文件夹;

下载 KeywordRemind 将 KeywordRemind-1.0.0.mirai2.jar 放置在plugins文件夹;

使用 指令 或 手动添加 提醒词

效果

e3ebd219-1a2e-4a45-b34d-c99389e655dc-xg.png

指令 指令 描述 /<KeywordCommand keyword> <add 添加> [keyword] [reply] [at] 为攻略添加提醒词 /<KeywordCommand keyword> <remove 删除> [keyword] 删除一个提醒词 /<KeywordCommand keyword> <list 列表> 查看发送人定义的提醒词 /keyword add 吃了吗 来恰饭 1234567,876532 添加吃了吗作为提醒词,来恰饭为提示词,并添加一个或多个提醒用户（使用,分割） /keyword remove 吃了吗 删除提醒词吃了吗 /KeywordCommand or /keyword 查看已定义的提醒词

例: /keyword add 吃了吗 来恰饭 1234567,876532 指令为添加吃了吗作为提醒词,当添加者输入吃了吗时机器人回复来恰饭并@1234567,@876532

注意： 在聊天环境执行指令需先安装 chat-command 并为自己添加管理员权限 安装chat-command后,在控制台或私聊机器人输入/perm permit m123456.* net.msktmi.keyword-remind:* 允许群 123456 中任意群成员 执行插件 net.msktmi.keyword-remind 的任意指令 chat-command权限文档 使用/keyword add添加提醒词时会覆盖同名提醒词 手动添加 可在 Mirai/config/net.msktmi.keyword-remind/KeywordRemindConfig.yml 中添加关键词,触发词以及提醒人; 用户: - 关键词: -- reply: 回复内容 -- at: --- 12345678 --- XXX(QQ号) 例: 1226594277: - 吃了吗: -- reply: 来恰饭 -- at: --- 12345678 --- 87654321 其他 兼容mirai-console 2.14.0 碰到奇怪bug可以联系我：1226594277(qq)

项目地址：Molly-Mirai
Release：release

接入茉莉云机器人，茉莉云机器人为免费聊天机器人
可前往 茉莉云官网 注册使用

将本插件放入mirai下的plugins目录内，启动一次mirai-console以生成配置文件，然后关闭mirai-console并前往修改Molly配置文件 ( 位于./config/Molly/MollyConfig.yml )

输入你自己的Api-Key和Api-Secret，开启mirai-console

在群聊内@机器人即可使用
私聊直接聊天即可

设置项：
api_key和api_secret
上文已解释
name 机器人昵称（推荐与茉莉云机器人昵称一致）
replyTimes 呼唤机器人后机器人持续回复的次数
doQuoteReply 机器人回复消息是否引用回复

效果如图

1637912140537.jpg

yPlug功能简介

地址：https://github.com/296711867/mirai-console-QQ-Robot-yPlugin

小y助手：一个自用的机器人插件，集成了一些小功能，执行一些简单的命令

功能名称 发送类型 配置名称 功能命令 新闻图片 图片 NewsImg 新闻 更多新闻 图片 Anews 更多 笑话 文字 LaughTalk 笑话 一言语句 文字 OneTalk 一言 舔狗日记 文字 DogTalk 舔狗 毒鸡汤 文字 SoupTalk 鸡汤 猫咪图片 图片 CatImg 猫咪 修狗图片 图片 DogImg 修狗 古风图片 图片 AncientImg 古风 摸鱼日历 图片 CalendarImg 摸鱼 美女图片 图片 GirlImage 美女 二次元图片 图片 PixivImg 二次元 功能列表 文字 Help 功能 使用说明 安装插件

去release界面下载jar包，然后放置到plugins文件下即可**（最好先简单的配置一下yPluginConfig.yml）**

下载地址：https://github.com/296711867/mirai-console-QQ-Robot-yPlugin/releases/tag/release1.0.1

==注意== : mirai-compose因为mirai版本可能过旧，无法使用此插件，推荐使用mcl

配置文件

创建配置文件

可以先在/config/yPlug.yplug的目录中，创建一个）

说明

为了避免打扰群友与好友的考虑，插件默认不对任何群启用功能(除非你的群正好命中了配置文件里默认生成的示例群号)

==注意==

如果想使命令生效：

需向groupList配置属性下添加对应的群号

需向friendList配置属性下添加对应的好友QQ号

配置文件结构（里面有详细的注释，可以按照自己的喜好，自行修改）

# 开放群组 groupList: - 123456789 - 987654321 # 开放好友 friendList: - 1234567 - 7654321 # 图片存储路径 imageStorage: './data/image/yPlug/' # 所有功能（true:开，false:关） commandMap: NewsImg: true # 新闻图片 Anews: true # 更多新闻 LaughTalk: true # 笑话 OneTalk: true # 一言 DogTalk: true # 舔狗日记 SoupTalk: true # 毒鸡汤 CatImg: true # 猫咪图鉴 DogImg: true # 修狗图片 AncientImg: true # 古风图片 CalendarImg: true # 摸鱼日历 CourseImage: true # 课程图片 GirlImage: true # 美女图片 PixivImg: true # 二次元图片 Author: true # 作者信息 Help: true # 功能列表 # 获取图片的冷却时间 getRandImageCD: 10000 # 群发新闻任务 # Open:（true为开，false为关闭） # Cron:（cron表达式:设置定时任务【请自行百度】默认:'0 20 8 * * ?' ---每天早上8点20群发新闻） # Zone:（时区设置:根据你所在的位置，可自行更换） groupNewsJob: Open: 'true' Cron: '0 20 8 * * ?' Zone: 'Asia/Shanghai' # 群发摸鱼人日历 （每天中午12点群发日历） groupCanlendarJob: Open: 'true' Cron: '0 0 12 * * ?' Zone: 'Asia/Shanghai'

mirai-console-drift-bottle

地址：GitHub

简单的漂流瓶插件，基本照抄了Dice!项目的漂流瓶功能

可以在私聊或者群聊中丢出包含任意消息的漂流瓶, 其他人通过捡起漂流瓶即可看到相应的消息

也可以通过跳海来查看海里有多少物品

具体使用文档放在了 wiki 页面 和 二楼

GitHub top language
GitHub
GitHub all releases
visitors

下图是功能演示
example.png

HuYanSession2——一款全功能自定义回复插件和小群管

上面的download是下载,release是查看所有版本!
gitee好久没更新了...
如果上面加载不出来可以点这里下载

迭代

相较于壶言1，壶言2实现了：

支持多个机器人 更便捷的指令并且中英双支持 更全面的群管理 更多词条参数识别

比如$at(qq)将会被转换为@该人

更全面的权限系统

权限可以下发到某一条聊天命令！

更更规整的代码 这条才是重点!

方便后续的拓展

更新进度及以发现问题->点这里

使用 前置依赖

Hibernate 前置插件，ORM 数据库框架，群/好友消息记录 下载适配版本

Mirai Hibernate Plugin

感谢大佬提供的轮子 @cssxsh

将下载好的jar文件添加到mcl的plugin文件夹，运行mcl即可，启动成功后在console控制台输入

/hy owner <QQ>

添加主人即可

如果聊天命令没有起作用请重启mcl！

如果你对mcl有一定的了解，那么你可以尝试用以下的方法来安装壶言2

你需要先删除plugin中的壶言2和前置的 jar，
再执行以下命令：

# 前置 mcl --update-package xyz.cssxsh.mirai:mirai-hibernate-plugin --channel maven-stable --type plugin # 只安装正式版 mcl --update-package cn.chahuyun:HuYanSession --channel maven-stable --type plugin # 升级 mcl update # 一个重启小插件(壶言重启) !重启 自定义回复

权限id：session

参数

所有自定义回复都会携带作用域和匹配方式参数！
支持更简洁的输入且都是可选！默认为精准和全局！

[]和()指数学中的域，在本插件表示可填写和必填写；
|为或，表示两边都可以用；

以下所有指令均适用于此表示方法!

[精准|1] 精准匹配 [模糊|2] 模糊匹配 [头部|3] 头部匹配 [结尾|4] 结尾匹配 [全局|0] 全局匹配 [当前|-1] 当前群匹配 [群组(id)|gr(id)] 指定群组匹配

具体参数含义可以去壶言1查看

一对一回复(会话)

权限id：sessionx

直接上指令

指令 含义 案例 中文格式 xx (触发内容) (回复内容) [参数] 快速添加关键字回复 参数可多填，以空格隔开 xx 怎么办 凉拌 2 0 学习 怎么办 凉拌 模糊 全局 xx：[触发内容] 查询所有已保存的关键词回复,冒号中英都支持，后续的触发内容填上就是查询对应的那条 xx: 查询 怎么办 -xx：(触发内容) 删除对应的关键词 -xx:怎么办 删除 怎么办 %xx 通过多次消息发送的形式添加对话,便于手机使用 %xx 学习对话 -%xx 由于多次消息形式添加的对话的触发词可能含有空格，因此要用对应的方式删除 -%xx 删除对话 ...

下面的参数
2:模糊匹配 gr1 群组编号1 内触发
52f718ff-4a89-4c6b-85c1-33d91f1252b5-图片.png

学习对话参数：

0 | 全局 修改触发作用域为这个机器人的所有群 1 | 精准 只有发的消息跟触发词相同，才能触发回复，不填写参数默认 2 | 模糊 发送消息包含触发词即可触发。 3 | 头部 发送消息的开头为触发词即可触发 4 | 结尾 发送消息的结尾为触发词即可触发 5 | 正则 以正则匹配触发消息，仅限%xx学习功能 -1 | 当前 修改触发作用域为当期这个群，不填写参数默认 gr(id) | 群组(id) 修改作用域为对应的群组id，()不是指令，只是说明这个id必须填写，群组的使用方式在下方

所有参数都在聊天指令的结尾以(空格)(参数)添加，无序。

对话和多词条支持的动态消息：

欢迎词支持的动态消息:

动态消息类型 动态消息参数 含义 案例 匹配结果 at this @(at)触发这条消息的人 $at(this) @放空 qq @群里的这个人，会固定@这个人 $at(572490972) @放空 message this 这个人触发这条消息的内容 $message(this) 不会写插件怎么办？ user name 获取这个人的名称 $user(name) 放空 id 获取这个人的qq $user(id) 572490972 avatar 获取这个人的头像 $user(avatar) [图片] title 获取这个人的头衔，优先获取特殊头衔 $user(title) 才不是放空了~ info 详细信息?? $user(info) time now 获取当前时间，默认格式yyyy-MM-dd HH:mm:ss $time(now) 2022-8-28 02:15:15 (时间格式) 按照指定的时间格式进行现在的时间输出 $time(HH:mm:ss) 02:16:20 正则消息回流(仅限一对一回复)

请以%xx学习，学习内容为(你的正则1)，与之对应的回复内容为$mate(1)，
参数为5，也就是正则匹配，1对应第一个括号匹配的内容。

案例：

...

dc4d0a7e-490f-4a22-951d-aca3449a1d67-图片.png

与之类似的，你只需要更改括号中正则，就可以达到你想要的东西。

一对多回复(多词条)

权限id：sessiondct
指令:

指令 含义 案例 中文格式 %dct 添加多词条 %dct 添加多词条 dct: 查询所有多词条 %dct 查询多词条 -dct:(id) [id] 删除多词条，id通过查询得到，第一个id是对应的多次条id，第二个id是对应回复语句id，如果填写，就是删除这个多次回复语句下的这条回复，支持空格隔开一次删除多条 -dct：5 删除：2 34 44 23

在添加多词条消息的途中，
发送

!!! | ！！！ 结束添加，不进行保存，直接结束这次操作 !! | ！！ 在循环添加回复内容时，停止添加，退出进行多词条消息的保存 ! | ！ 删除上一条添加的内容

添加多词条参数：

1 | 精准 只有发的消息跟触发词相同，才能触发回复，不填写参数默认 2 | 模糊 发送消息包含触发词即可触发。 3 | 头部 发送消息的开头为触发词即可触发 4 | 结尾 发送消息的结尾为触发词即可触发 lx | 轮询 多个词条回复的顺序为轮询，就是一条一条发送去,不填写参数默认 sj | 随机 修改回复顺序为随机,就是触发后随机从多词条中取一条拿来回复 0 | 全局 修改触发作用域为这个机器人的所有群 gr(id) | 群组(id) 修改作用域为对应的群组id，()不是指令，只是说明这个id必须填写

单个多词条回复语句也支持动态消息，具体支持看上面的对话动态消息支持

群组

权限id：list
用于设定特定几个群的群组系统，用于一些东西只在这几个群中触发，其他插件有个相反的功能叫群黑名单，我这个是正向的，只在那些群触发。

指令：

指令 含义 案例 中文格式 +gr:(id) (群号) 添加多个群为一个群组，群号支持多个 +gr：1 780594692 添加群组：1 780594692 390444068 gr:[id] 查询所有群组信息，id填写后只查询对应的id所属群组信息 gr： 查询群组：1 -gr:(id) [群号] 删除这个群组里面的某个群号，支持多个群号 -gr:1 删除群组：1 390444068 780594692 ...

13e391e9-4c58-4a3c-a0c7-e2413cae2fb2-图片.png
d96e3d66-ac42-405f-bcbe-a4a0d1080245-图片.png

与之类似，你只需要更换你的正则匹配就可以

定时器

权限id：ds

定时任务是指，按照指定的时间频率发送对应的消息，时间频率是cron表达式，不懂的人可以花5分钟了解一下，基本能满足任何时间频率
cron输入格式$cron(* * * * * ?)

定时管理

指令:

指令 含义 案例 中文格式 %ds 添加定时任务，具体根据提示进行添加 %ds 添加定时器 | 添加定时任务 -ds(id) 删除定时任务，id查询获得 -ds：1 删除定时器：1 | 删除定时任务：1

在添加回复消息的途中，
发送

!!! | ！！！ 结束添加，不进行保存，直接结束这次操作 !! | ！！ 在循环添加回复内容时，停止添加，退出进行定时任务的保存 ! | ！ 删除上一条添加的内容

定时任务的参数：

hf | 回复 定时器触发后只回复一条消息，不填参数默认 lx | 轮询 定时器的回复内容将成为多词条的样式，并且回复词条顺序为轮询，与随机冲突！ sj | 随机 定时器的回复内容将成为多词条的样式，并且回复词条顺序为随机，与轮询冲突！ -1 | 当前 作用域-当前这个群 默认 0 | 全局 作用域-全部群 gr(id) | 群组(id) 作用域-指定群组 定时器操作

权限id：dscz

指令 含义 案例 中文格式 ds: 查询定时任务 ds： 查询定时器 | 查询定时任务 %ds:(id) 切换定时任务的状态，如果已经开启，则切换为关闭，id查询获取 %ds:1 切换定时器:1 | 切换定时任务：1 群管理

权限id：group 此权限不是指令权限

对于几个检测群的功能，需要先将对于群添加为检测群

/hy agroup (群号) #添加 /hy dgroup (群号) #删除

依然支持在config文件手动添加

特殊头衔

当你的机器人是群主时才可以使用,拥有admin、group权限的用户也可以用于使用。

指令：

指令 含义 案例 中文格式 %@(user) (内容) 给这个人修改特殊头衔 %@放空 才不是放空了~ 设置头衔@放空 才不是放空了~

是群主才行哦~

群欢迎词

权限id：grouphyc
当有人申请的时候，拥有管理员权限的机器人并且加入了检测的群
机器人会给出提示
在配置文件中有是否启用开关

...

997f2332-8b54-483b-89ae-b583d2955591-图片.png

指令：

指令 含义 案例 中文格式 开门 id|all 同意这个人的进群申请 开门 1 开门 all 同意 id|all 同意这个人的进群申请 同意 1 同意 all 关门 id|all 关门这个人的进群申请 关门 1 关门 all 拒绝 id|all 拒绝这个人的进群申请 拒绝 1 拒绝 all

id是进群时所提示的门牌号

欢迎词功能不需要检测群支持！
欢迎词指令：

指令 含义 案例 中文格式 %hyc 添加欢迎词 %hyc 添加欢迎词 hyc： 查询欢迎词词 hyc: 查询欢迎词 -hyc:(id) [id] 删除欢迎，id查询获得，第二个id是对应的欢迎词集合中的某条欢迎词，不支持多条删除 -hyc：2 删除欢迎词：1 15

参数:

lx | 轮询 欢迎词将以轮询的方式逐条发送，默认 sj | 随机 欢迎词将随机发送 0 | 全局 作用域：全局 gr(id) | 群组(id) 作用域：群组

欢迎词支持的动态消息:

动态消息类型 动态消息参数 含义 案例 匹配结果 at this @(at)这个进群的人 $at(this) @放空 that 这个要请他的人，如果没有邀请的人则会at同意他进来的那个人 $at(that) @放空 qq @群里的这个人，会固定@这个人 $at(572490972) @放空 message apply 获取这个人进群申请的消息 $message(apply) 这个人什么都没说... user name 获取这个人进群时的名称 $user(name) 放空 id 获取这个人的qq $user(id) 572490972 avatar 获取这个人的头像 $user(avatar) [图片] time 所有支持动态消息的都支持时间，具体用法在文档前面的对话 禁言

权限id：groupjy

此指令只有在你的机器人是管理员或群主才能触发

指令：

指令 含义 案例 中文格式 @某人(禁言时间) 在机器人有权限的情况下，对你@的这个人进行指定时间的禁言 @放空 3m `` @某人 0s 解除禁言 @放空 ``

时间频率：

s 秒 m 分钟 h 小时 d 天 违禁词

不需要检测群支持。
此指令只有在你的机器人是管理员或群主才能起作用。

指令：

指令 含义 案例 中文格式 +wjc:(内容) [param] 添加违禁词，内容是触发内容，param是参数，具体可以查看下方 +wjc:色图 ch 2m 添加违禁词：色图 % jy -wjc:(id) 删除违禁词，id查询获得 -wjc：2 删除违禁词：2 wjc： 查询所有违禁词 wjc： 查询违禁词 参数的意义 ch 违禁词默认撤回，当输入ch后，wjc将不撤回消息 jy 违禁词默认禁言，当输入jy后，wjc将不禁言 3s 修改禁言时间,具体时间格式查看禁言 % 重写回复语句,支持动态消息，具体支持动态消息查看下方 [gr1 | 0 ] 群组或全局，默认当前群 1,2,3,4 匹配方式，跟关键词回复的匹配同理 hmd3 开启触发3次后就会踢出群聊，数字可自选

hmd参数输入后，将会开启小黑屋功能，不会提示！当某个人触发这个wjc到达次数，直接踢出本群，可以和下面的自动添加黑名单配合！

违禁词回复消息支持动态消息：

动态消息类型 动态消息参数 含义 案例 匹配结果 at this @(at)触发这条消息的人 $at(this) @放空 qq @群里的这个人，会固定@这个人 $at(572490972) @放空 message this 这个人触发这条消息的内容 $message(this) 不会写插件怎么办？ jyString 这条违禁词的禁言时间中文 $message(jyString) 禁言2分钟 prohibitString 同上 null 不发送消息 $message(null) user name 获取这个人的名称 $user(name) 放空 id 获取这个人的qq $user(id) 572490972 avatar 获取这个人的头像 $user(avatar) [图片] title 获取这个人的头衔，优先获取特殊头衔 $user(title) 才不是放空了~ info 详细信息?? $user(info) time now 获取当前时间，默认格式yyyy-MM-dd HH:mm:ss $time(now) 2022-8-28 02:15:15 (时间格式) 按照指定的时间格式进行现在的时间输出 $time(HH:mm:ss) 02:16:20 黑名单

权限id：grouphmd

不需要检测群支持。
此指令只有在你的机器人是管理员或群主才能触发。
支持作用域！！设置为全局时，该用户将被你的bot封禁！

指令 含义 案例 中文格式 +hmd:@(user) [param] 添加黑名单，参数看下方 +hmd:@放空 jy 添加黑名单:@放空 % hmd: 查询黑名单 hmd: 查询黑名单 -hmd:(id) 删除黑名单,id查询获得 -hmd:3 删除黑名单:2

参数：

t 默认检测到就踢出，携带参数不踢出 jy 默认禁言(优先踢出),携带参数不禁言 ch 默认撤回该用户的消息，携带不提出 0 | gr(id) 作用域不携带参数默认当前群 % 重写封禁理由

此功能需要检测群支持！
在配置文件blacklist有退群自动添加黑名单开关！
里面还有重写封禁理由！

撤回消息

权限id：groupch

用于撤回上面的群消息，机器人是管理员和群主才能使用

指令：

指令 含义 案例 中文格式 !recall 撤回上面这条消息 !recall 撤回 ！recall (number) 撤回前面几条消息，不包含这条消息 ！recall 5 撤回 5 !recall 1-5 撤回上面1到5条，从第0条算起，包含这条消息 !recall 1-5 撤回 25-55

具体用法试一试就明白，撤回多条消息时，权限可能会有冲突。

...

60f41127-46fe-4a31-939c-e9183e78b6b6-图片.png
046a35d8-0050-4089-b0ba-5c5a2179ea7f-图片.png
消息被群友顶上去了，我仍然能撤回!
9d55a500-e3c0-48a3-87b0-af373243d522-图片.png

踢人

权限id：grouptr

此指令只有在你的机器人是管理员或群主才能触发

指令 含义 案例 中文格式 tr@(user) [hmd] 踢人 tr@放空 踢人@放空

参数：

hmd qq的踢人有个禁止此用户再次加群，输入后将禁止此用户再次加群 权限系统

权限id：admin

指令：

指令 含义 案例 中文格式 +@(user) (权限id) 赋予这个群的这个人的某个权限,权限id可在文档查看 +@放空 admin 添加@放空 all -@(user) 移除这个权限 -@放空 all 删除@放空 group ！power [param] 查询权限列表，参数如下 !power all 权限列表 all

参数：

不填默认当前群 @某人 查看指定人在本群的权限 all 查询所有权限或添加所有权限或删除所有权限

查询可以输入对应的群号 或者 qq号 来查询指定区域的权限信息
也可以直接 all 查询全部
然后通过 上一页 和 下一页 来进行翻译阅读

多机器人互冲

对于同时加载多个bot的使用者
容易存在一条指令两个bot触发，因此，加了一个‘暂停功能’

指令：

指令 含义 案例 中文格式 ！pause @(bot) 你发的下一条消息，这个机器人将会忽略(包括触发) ！pause@乌拉 !pause @(bot) 5 忽略下5条消息，消息数量自定 ！pause @乌拉 5

不带参数，默认忽略你的下一条消息
也可以自定义忽略下几条消息，这个记录是写在内存的，如果不小心输入多了（9999999999），重启就行。

插件指令 指令 含义 案例 /hy aGroup 添加一个监测群 /hy aGroup 390444068 /hy dGroup 删除一个监测群 /hy dGroup 390444068 /hy v 查询当前插件版本 /hy v /hy transfer 转移一个所属bot的数据到另一个bot /hy transfer 2061954151 3630254205 规划和已知BUG

任何意见都可以提!

以后的规划将不在此处更新，具体更新查看下面

规划：

实现消息的excel导入和导出(在1添加导出功能)

bug：

交流

壶言系列插件交流群 不是云的茶壶云(390444068)
有任何疑问或者建议都可以来群里提！

更新进度及以发现问题->点这里

最新的插件动态也会在群里说明！

WifeYouWant

项目地址：https://github.com/MrXiaoM/WifeYouWant

「你想要的插件」系列作品

本插件移植自 椛椛 ᴮᴼᵀ

...

名场面
WifeYouWant.png

特性 每天可以从群友里随机抽一次老婆 (渣男!) 不想要的可以换 (渣男!!) 可设置只能抽和自己性别相反的人，也可以无视性别 可以设置能抽到自己 可以设置能 NTR (重复抽到群友) 安装

到 Releases 下载插件并放入 plugins 文件夹进行安装

2.11 或以上下载 WifeYouWant-*.mirai2.jar

2.11 以下下载 WifeYouWant-legacy-*.mirai.jar
安装完毕后，编辑配置文件作出你想要的修改。在控制台执行 /wuw reload 重载配置即可~

配置文件内有详细的注释，详见 源码

用法

随机挑选一位群友，在明天之前，无论怎么抽都是那位群友

抽老婆

抛弃老婆，重新抽一位群友

换老婆

关键词可在配置文件中修改

捐助

前往 爱发电 捐助我。

...

来自群组: SkyNet1748