koishi-plugin-skinsprite

基于 Skinsprite Studio 一键生成Q版Minecraft立绘网站编写的立绘生成插件

安装与依赖

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

canvas 服务推荐安装 koishi-plugin-canvas 提供——插件使用它完成立绘的背景合成与尺寸缩放。

使用方法

在 Koishi 中调用命令：

skinsprite [玩家名]

玩家名省略时使用配置页中的默认玩家名，执行后返回生成的 Q 版立绘图片。

指令选项

| 选项 | 说明 | 取值 | | --- | --- | --- | | -m <model> | 皮肤模型 | auto（自动检测，默认）/ wide（4px 臂，Steve 型）/ slim（3px 臂，Alex 型） | | -p <pose> | 姿势 | standing（站立，默认）/ both-up（双手举起）/ both-legs-up（双腿抬起）/ one-up（单手举起）/ crouching（蹲下）/ head-only（仅头部） | | -v <view> | 视角 | right（朝右，默认）/ left（朝左） | | -l <layer> | 头部第二层 | outer（立体，默认）/ flat（平面）/ off（不显示） | | -o <outline> | 描边宽度 | 0（无，默认）/ 1（细）/ 2（粗），颜色固定 #121114 | | -s <shading> | 阴影强度 | 0-100 整数（默认 100；0 为完全平面化） | | -S <size> | 输出尺寸 | 图片最长边像素（1-8192，默认 800；透明背景时内容等比缩放） | | -b <bg> | 背景 | transparent（透明，默认）/ solid（纯色）/ circle（圆形） | | -c <color> | 背景颜色 | #RRGGBB（默认 #F8F7F2，仅纯色/圆形背景生效） |

示例：

skinsprite Steve -p head-only -o 2 -b circle -c #ffe4f1   # 圆形头像 + 粗描边
skinsprite Alex -m slim -p both-up -s 50                  # 瘦臂模型 + 举手姿势 + 半强度阴影

配置项

基础设置

| 配置 | 默认 | 说明 | | --- | --- | --- | | 默认玩家名称 | — | 指令未提供玩家名时使用（3-16 位字母/数字/下划线） | | 接入 API 服务 | 关闭 | 开启后调用远程服务渲染立绘；关闭时使用内置本地渲染器（离线可用） | | API 服务列表 | 内置 sss.1m3.jp 一条 | 可编辑表格：每行含 是否启用 / API 基础地址 / 路由；按顺序尝试，全部失败后提示不可用（仅开启"接入 API 服务"时显示） |

渲染设置

| 配置 | 默认 | 说明 | | --- | --- | --- | | 默认皮肤模型 | auto | 指令 -m 未指定时使用 | | 默认姿势 | standing | 指令 -p 未指定时使用 | | 默认视角 | right | 指令 -v 未指定时使用 | | 默认帽子层 | outer | 指令 -l 未指定时使用 | | 默认描边 | 0 | 指令 -o 未指定时使用 | | 默认阴影 | 100 | 指令 -s 未指定时使用 | | 默认图片最长边尺寸 | 800 | 指令 -S 未指定时使用 | | 默认背景模式 | transparent | 指令 -b/-c 未指定时使用 | | 使用自定义皮肤API | 关闭 | 开启后经自定义皮肤API获取皮肤（关闭时使用Mojang官方接口） | | 自定义皮肤API列表 | 内置 minotar 一条 | 可编辑表格：每行含 是否启用 / API地址（直链皮肤图，支持 [UUID] / [USER_NAME] 占位符）/ User-Agent；按顺序尝试，全部失败后回退 Mojang 官方接口（仅自定义皮肤API开启时显示） |

两种渲染模式

• 内置本地渲染器：完全在 Koishi 进程内渲染，无需访问第三方渲染服务。
• 接入 API 服务：调用 SkinSprite Studio 的渲染接口出图，与网站效果完全一致。

两种模式下皮肤获取均通过 Mojang 官方接口完成，这一步始终需要网络。

注意事项

• 本地渲染基于对 sss.1m3.jp 服务端的复刻，躯干区域可能存在部分差异
• 远程模式依赖第三方站点 sss.1m3.jp（SkinSprite Studio，作者 @mcthnk），请勿高频滥用；该服务更新时渲染效果可能随之变化

致谢

• 本插件的立绘效果来自 SkinSprite Studio —— 衷心感谢作者 @mcthnk（マイクラ思考）制作的优秀服务
• "接入 API 服务"模式直接调用 SkinSprite Studio 的公开渲染接口；内置本地渲染器亦基于对其服务端渲染效果的复刻实现
• 如果本插件对你有用，也请前往原网站体验并支持原作者