Petpet

一个生成摸摸头GIF的 Mirai 插件，灵感/部分数据来自 nonebot-plugin-petpet。

java 编写，支持多线程 ：轻量，高效。

在线编辑器

使用方法

下载最新版本
将插件放入 Mirai/plugins/
下载图片素材
将图片素材放入 Mirai/data/xmmt.dituon.petpet
使用 戳一戳 有 30% 的概率触发; 或发送 pet @xxx

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

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

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

可使用 pet指令获取 keyList

以上配置均可在配置文件中修改

配置文件

首次运行 Petpet 插件时，会生成 Mirai/config/xmmt.dituon.petpet/Petpet.yml 文件

# 触发 petpet 的指令
command: pet
# 使用 戳一戳 的触发概率
probability: 30
# 是否使用抗锯齿
antialias: true
# 禁用列表
disabled: []
# keyCommand前缀
commandHead: ''
# 是否响应机器人发出的戳一戳
respondSelfNudge: false
# 是否使用响应回复
respondReply: true
# 消息缓存池容量
cachePoolSize: 10000
# keyList响应格式
keyListFormat: FORWARD
# 禁用策略
disablePolicy: FULL
# 禁用群聊列表
disabledGroups: []
# 是否使用模糊匹配用户名
fuzzy: false
# 是否使用严格匹配模式
strictCommand: true
# 是否使用消息事件同步锁
synchronized: false
# GIF编码器
gifEncoder: ANIMATED_LIB
# GIF缩放阈值/尺寸
gifMaxSize: 
  - 200
  - 200
  - 32
# GIF质量, 仅适用于ANIMATED_LIB编码器
gifQuality: 90
# 是否使用headless模式
headless: true
# 是否自动从仓库同步PetData
autoUpdate: false
# 用于自动更新的仓库地址
repositoryUrl: 'https://raw.githubusercontent.com/Dituon/petpet/main'
# 是否启用开发模式（支持热重载）
devMode: false
# 触发图片生成后的冷却时长（填入-1则禁用，单位为秒）
coolDown: 10
# 在群聊中触发图片生成后的冷却时长
groupCoolDown: -1
# 触发冷却后的回复消息
inCoolDownMessage: 操作过快，请稍后再试

配置项说明

展开/收起

command: pet

触发petpet指令, 默认为pet

例: pet @xxx pet kiss @xxx

仅发送pet时会返回keyList

probability: 30

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

antialias: true

画布抗锯齿, 默认为true

disabled: []

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

keyCommandHead: ''

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

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

respondReply: true

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

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

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

例 : [回复[图片]]kiss(等价于 kiss [图片])

cachePoolSize: 10000

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

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

respondSelfNudge: false

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

keyListFormat: FORWARD

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

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

disablePolicy: FULL

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

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

fuzzy: false

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

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

strictCommand: true

严格匹配指令, 默认为true

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

例 : (配置项为false时): kiss 田所(响应) kiss田所(响应)

synchronized: false

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

~~人话: 多机器人对于同一条指令只有一个会响应~~

gifEncoder: ANIMATED_LIB

GIF编码器, 默认为ANIMATED_LIB

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

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

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

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

SQUAREUP_LIB: 基于int[][]数组, 编码时不使用awt库, Gif压缩比低;

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

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: 90

Gif编码质量(1-100), 默认为90

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

仅适用于ANIMATED_LIB编码器

headless: true

启用headless模式, 默认为true

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

autoUpdate: true

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

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

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

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

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

devMode: false

开发模式, 启用后任何人都能使用pet reload指令热重载PetData

- **coolDown**: `10`

成功触发指令后对该用户的冷却时间，单位为秒，设置为-1可禁用冷却

- **coolDown**: `-1`

成功触发指令后对该群聊的冷却时间，单位为秒，设置为-1可禁用冷却

- **inCoolDownMessage**: `操作过快，请稍后再试`

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

修改后重启 Mirai 以重新加载

权限管理

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

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

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

图片预览

图片按key排序(见data/xmmt.dituon.petpet/)

展开/收起

key	预览
acclaim 喝彩欢呼
bible 圣经典中典
breakdown 惊吓击穿
carte 佩可莉姆菜单单页
hold_sign 唐可可举牌应援
kurumi 胡桃放大
monad 唐可可拍单页
point_tv 康纳电视
remake 泥头车创重开
reward 伊蕾娜赏金报酬
watch_tv 汤姆电视
certificate 喜报
anyasuki 阿尼亚喜欢
bite 啃咬
breast 胸凶
cast 丢
center_symmetry 中心对称左上对称
coupon 陪睡
cover_face 挡
crawl 爬
decent_kiss 抱歉
distracted 注意力
dont_touch 不要靠近
down_symmetry 对称下对称上下对称
eat 吃
fencing 击剑 🤺
garbage 垃圾桶垃圾探头
hammer 锤
interview 采访
jiujiu 么么
keep_away 远离
kiss 亲热吻
knock 敲打
left_down_symmetry 中心对称左下对称
leg 蹭
like 永远喜欢
loading 加载加载中
make_friend 加好友
marry 结婚
nano 纳米科技
need 需要
osu
painter 画
pat 拍
perfect 完美
petpet 摸摸头
play 玩顶
police 警察
pound 捣
pr 舔屏
punch 打拳
record 唱片
right_down_symmetry 中心对称右下对称
right_symmetry 对称右对称左右对称
right_up_symmetry 中心对称右上对称
roll 滚推
rub 舔 prpr
safe_sense 安全感
suck 吸
support 精神支柱
symmetry 对称左对称左右对称
tear 撕
thinkwhat 想
throw 扔
thump 锤
tightly 黏
twist 抱
up_symmetry 对称上对称上下对称
wallpaper 瑞克壁纸
worship 膜拜
yoasobi 群青

..more&more

自定义

在线编辑器

data.json

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

data.json 标准如下 (以 thump/data.json 为例)

{
  "type": "GIF", // 图片类型(enum)
  "avatar": [{ //头像(objArr), 参考下文
      "type": "TO",
      "pos": [
        [65, 128, 77, 72], [67, 128, 73, 72], [54, 139, 94, 61], [57, 135, 86, 65]
      ],
      "round": true,
      "avatarOnTop": false
    }],
  "text": [], //文字(objArr), 参考下文
  "inRandomList": false, //在随机列表中(bolean)
  "delay": 50 //帧间延时(ms/int), 默认为65
}

图片类型枚举

type

GIF 动图
IMG 静态图片

坐标

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

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

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

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

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

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

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

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

仿射变换/图像变形

坐标格式枚举posType

ZOOM 缩放(见上文)
DEFORM 变形

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

目前仿射变换仅支持单帧

头像

3.0版本后提供了更灵活的头像构造方法, 与之前的版本有很大差别

"avatar": [
    {
      "type": "FROM", //头像类型枚举(enum), 非空
      "pos": [[92, 64, 40, 40], [135, 40, 40, 40], [84, 105, 40, 40]], // 坐标
      "round": true, // 值为true时, 头像裁切为圆形, 默认为false
      "avatarOnTop": true // 值为true时, 头像图层在背景之上, 默认为true
      "angle": 90, // 初始角度
    },
    {
      "type": "TO", 
      "pos": [[5, 8], [60, 90], [50, 90], [50, 0], [60, 120]],
      "posType": "DEFORM", // 图像变形 坐标格式, 默认为ZOOM
      "antialias": true, // 抗锯齿, 对头像单独使用抗锯齿算法, 默认为false
      "rotate": false // 值为true时, GIF类型的头像会旋转, 默认为false
    },
    {
      "type": "GROUP", 
      "pos": [[182, 64, "width/2", "height*1.5^2"], [225, 40, "40", 40], [174, 105, 40, "height+width"]], // 支持变量运算
      "crop": [0, 0, 50, 100], // 图片裁切坐标[x1, y1, x2, y2], 可简写为 [50, 100]
      "cropType": "PERCENT", // 裁切格式, 默认为NONE
      "style": [ // 风格化
        "MIRROR",
        "GRAY"
      ]
    }
  ]

在IMG中, 当rotate = true时, 头像会随机旋转角度, angle为最大值(angle = 0时, 随机范围为0-359)

头像类型枚举 type

FROM 发送者头像
TO 接收者头像, 或构造的图片
GROUP 群头像
BOT 机器人头像

裁切格式枚举 cropType

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

风格化枚举 style

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

坐标变量

width 原图宽度
height 原图高度

文字

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

"text": [ // 这是一个数组, 可以添加很多文字
    {
      "text": "Petpet!", // 文字内容
      "color": "#66ccff", // 颜色, 默认为#191919
      "pos": [100, 100], // 坐标, 默认为 [2,14]
      "size": 24 // 字号, 默认为12
    },
    {
      "text": "发送者: $from, 接收者: $to", // 支持变量
      "color": [0,0,0,255], // 颜色可以使用RGB或RGBA的格式
      "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": "BLOD", // 字体样式, 默认为PLAIN
      "greedy": true // 贪婪匹配模式, 会匹配多余的关键词
    }
  ]

变量

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

需要更多变量请提交 Issue

font

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

align

LEFT: 左对齐
RIGHT: 右对齐
CENTER: 居中对齐

wrap

NONE: 不换行
BREAK: 自动换行
ZOOM: 自动缩放

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

style

PLAIN: 默认
BLOD: 粗体
ITALIC: 斜体

position

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

`background`

4.0版本后, 支持动态创建画布

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

坐标变量

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

`WebServer`

除了作为Mirai插件, Petpet 也可以作为http服务器单独运行, 可被其它项目/语言使用

java -jar petpet.jar

启动时会生成 config.json:

{
  "port": 2333, //监听端口
  "threadPoolSize": 10, //线程池容量
  "dataPath": "data/xmmt.dituon.petpet", //PetData路径
  "gifMaxSize": [200, 200, 32], //Gif缩放阈值, 详见上文
  "gifEncoder": "ANIMATED_LIB", //Gif编码器, 详见上文
  "headless": true //使用headless模式
}

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

`PetServer API`

访问 127.0.0.1:2333/petpet 以获取 PetDataList

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

结构

展开/收起

key(str): 对应PetData,例如kiss rub
fromAvatar toAvatar groupAvatar botAvatar(url): 头像URL地址
fromName toName groupName(str): 昵称, 有默认值
textList(str): 根据空格分割此字符串, 作为额外数据

更多示例请参考example-script

常见问题

戳一戳无法触发?

检查 Mirai 登录协议, 仅 ANDORID_PHONE 可以收到戳一戳消息
没有生成配置文件?

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

图片素材应位于 Mirai/data/xmmt.dituon.petpet 目录下, 请检查路径
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

依赖share包二次开发

方式1. 在本项目内二次开发（非mirai插件形式）：见xmmt.dituon.example.SimpleUsage
方式2. 在别的项目二次开发：mirai-simplepetpet-plugin

后话

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

欢迎提交任何请求

交流群: 534814022

Name		Name	Last commit message	Last commit date
Latest commit History 350 Commits
config/xmmt.dituon.petpet		config/xmmt.dituon.petpet
data/xmmt.dituon.petpet		data/xmmt.dituon.petpet
editor		editor
example-data		example-data
example-script		example-script
gradle/wrapper		gradle/wrapper
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
build.gradle		build.gradle
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
index.json		index.json
jitpack.yml		jitpack.yml
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Petpet

使用方法

配置文件

配置项说明

权限管理

图片预览

自定义

data.json

图片类型枚举

坐标

仿射变换/图像变形

头像

文字

`background`

`WebServer`

`PetServer API`

常见问题

性能 & 兼容性

分享你的作品

依赖share包二次开发

后话

About

Releases

Packages

Languages

License

Suli1337/petpet

Folders and files

Latest commit

History

Repository files navigation

Petpet

使用方法

配置文件

配置项说明

权限管理

图片预览

自定义

data.json

图片类型枚举

坐标

仿射变换/图像变形

头像

文字

background

WebServer

PetServer API

常见问题

性能 & 兼容性

分享你的作品

依赖share包二次开发

后话

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

`background`

`WebServer`

`PetServer API`

Packages