koishi-plugin-dot-chibiko

将 Minecraft 的皮肤 PNG 转换为 2 头身 chibi 角色 GIF 和 PNG，支持 39 种动态 GIF 和 18 种静态图片。

安装与依赖

插件运行依赖 Koishi 的 http 服务（核心内置）与 canvas 图像服务。

canvas 服务推荐安装 koishi-plugin-canvas 提供——插件使用它完成图像绘制、缩放与 PNG 编码，设置页的实时渲染预览也依赖它。

使用方法

在 Koishi 中调用命令：

chibiko [-a 动画名] [玩家名]

通过 Minecraft 玩家ID（Java 版）获取皮肤并渲染为 chibi 角色；指令未提供玩家ID时使用配置页中的默认玩家ID。所有图像均在本地生成，无需上传到服务器。

指令选项

| 选项 | 说明 | 取值 | | --- | --- | --- | | -a <action> | 动画类型 | 见下方动画列表；省略时使用配置页默认动画 | | -b <background> | 背景 | transparent（透明）/ color（纯色，使用配置页背景颜色）/ #RRGGBB（指定颜色） | | -o <outline> | 描边宽度 | 0（无，默认）/ 1（细）/ 2（粗） | | -c <color> | 描边颜色 | #RRGGBB，仅描边为细/粗时生效 | | -s <speed> | GIF 速度 | 0.5 - 2.0 倍速 | | -f <format> | 输出格式 | gif / png；省略时动态动画出 GIF、静态动画出 PNG | | -e <scene> | 场景 | none（无）/ grass（草地和花）/ sakura（樱花）/ bluesky（蓝天）/ nightsky（夜空） | | -m | 黑白模式 | 开关选项，灰度输出 | | -l | 动画列表 | 列出全部可用动画类型 |

示例：

chibiko Steve                       # 使用配置页默认动画
chibiko -a walk Alex                # 走路动画
chibiko -a mine -e grass Steve      # 挖矿 + 草地场景
chibiko -a idle -f png Steve        # 动态动画输出静态图
chibiko -l                          # 列出全部动画类型

动画类型

动图（GIF）- 39 种

| 动画名 | 说明 | | --- | --- | | idle | 待机 | | walk | 走路 | | walkDiag | 斜向走路 | | crouchDiag | 斜向下蹲 | | run | 奔跑 | | wave | 挥手 | | headShakeNo | 摇头拒绝 | | thanks | 鞠躬致谢 | | clap | 拍手 | | nod | 点头收到 | | laugh | 大笑 | | cry | 哭泣 | | angry | 生气 | | shock | 震惊 | | surprised | 惊讶 | | unknown | 不明白 | | ok | OK！ | | ng | NG！ | | circle | 圈号 | | cross | 叉号 | | jump | 跳跃 | | turn | 转身 | | sleep | 睡觉 | | skip | 蹦跳 | | rainUmbrella | 雨中打伞 | | goldenApple | 金苹果 | | rollForward | 前滚翻 | | chickenRide | 骑鸡 | | balloonFloat | 气球飘走 | | happyHeart | 开心 | | jumpHai | 举手跳跃 | | nowLoading | 加载中 | | pleaseWait | 请稍等 | | mine | 挖矿 | | sing | 唱歌 | | weird | 摇摆嗨 | | spin | 滴溜转 | | spinNowLoading | 滴溜转·加载中 | | spinPleaseWait | 滴溜转·请稍等 |

静态图（PNG）- 18 种

| 动画名 | 说明 | | --- | --- | | stand | 站立 | | diag | 斜向站立 | | banzai | 万岁欢呼 | | hai | 举手应答 | | guts | 加油鼓劲 | | head | 仅头部 | | jumpHai | 举手跳跃 | | weird | 摇摆嗨 | | umbrella | 雨中打伞 | | happy | 开心 | | sing | 唱歌 | | mine | 挖矿 | | thanks | 鞠躬致谢 | | clap | 拍手 | | cry | 哭泣 | | angry | 生气 | | nowLoading | 加载中 | | pleaseWait | 请稍等 |

配置项

基础设置

| 配置 | 默认 | 说明 | | --- | --- | --- | | 默认玩家ID | —（必填） | 未提供玩家名时使用（1-16 位字母/数字/下划线） |

皮肤获取

| 配置 | 默认 | 说明 | | --- | --- | --- | | 使用自定义皮肤API | 关闭 | 开启后按下方列表顺序尝试获取皮肤，全部失败时回退 Mojang 官方接口 | | 自定义皮肤API列表 | 1 条 minotar 示例 | 仅开启"使用自定义皮肤API"时显示的表格，每行填写：是否启用 / API地址 / 请求User-Agent |

其中 API 地址必须直接返回皮肤 PNG 图片（不支持返回 JSON 数据的接口），并包含 [UUID] 或 [USER_NAME] 占位符（请求时替换为实际玩家的 UUID / 用户名），例如：

https://minotar.net/skin/[USER_NAME]
https://crafatar.com/skins/[UUID]

默认效果

| 配置 | 默认 | 说明 | | --- | --- | --- | | 默认动画 | idle | 指令 -a 未指定时使用 | | 边框 | 0（无） | 指令 -o 未指定时使用，可选 1（细）/ 2（粗） | | 边框颜色 | #000000 | 仅边框选择"细"或"粗"时显示并生效 | | 背景 | transparent（透明） | 画布底色，与场景独立；可选 color（纯色） | | 背景颜色 | #ffe4f1 | 仅背景选择"纯色"时显示并生效 | | 场景 | none（无） | 可选 grass（草地和花）/ sakura（樱花）/ bluesky（蓝天）/ nightsky（夜空） | | 黑白模式 | 关闭 | 指令 -m 未指定时使用 | | GIF速度倍率 | 1.0 | 指令 -s 未指定时使用，范围 0.5 - 2.0 |

导出

| 配置 | 默认 | 说明 | | --- | --- | --- | | 输出格式 | auto（自动） | 静态动画用 PNG，动态动画用 GIF；指令 -f 可覆盖 | | 输出宽度 | 512 | 像素，高度等比缩放；0 = 原始尺寸不缩放 | | 文件大小上限 | 8 | MB，范围 1 - 20 |

注意事项

• 皮肤获取需要访问网络；图像渲染全部在本地完成，不会上传皮肤
• 64x32 旧版皮肤会自动转换为 64x64 现代格式后再渲染

致谢

• 本插件的动画效果参考了 ドットちび子 —— 衷心感谢原作者制作的优秀服务
• 插件的动画类型与渲染效果均基于对该网站功能的复刻实现，均在本地渲染完成
• 如果本插件对你有用，也请前往原网站体验并支持原作者