准备四张 PNG
同一角色、同一画布、同一对齐基准，分别绘制待机、左右输入和庆祝动作。
给每一次按键，一个新伙伴
画四张图。
做一个会动的主题。
从透明 PNG 到 Steam 创意工坊，这份手册带你完成 Key Clover 角色主题的制作、检查、发布与更新。
COMBO× 128
COINS2,048
✦✦
GH
{ } theme.json
☁ idle.png
G left_type.png
H right_type.png
✦ celebrate.png
01
五分钟看懂流程
从画布到工坊
生成 theme.json
使用下方生成器填写名称、作者和版本，下载配置文件并放进主题文件夹。
在 Key Clover 发布
打开“主题”，选择“发布本地主题”，选中整个文件夹。应用会先校验再上传。
完成 Steam 页面
首次发布后接受 Steam Workshop 法律协议，并在自动打开的页面补充截图或说明。
02
角色演出表
四种动作，各有职责
IDLE
idle.png待机
没有输入时的常驻姿态。轮廓要清楚，适合长时间停留。
KEY G
left_type.png左侧输入
按下键盘左半区时出现。动作可以向左偏，但角色中心不要跳动。
KEY H
right_type.png右侧输入
按下键盘右半区时出现。建议与左侧动作形成清楚的镜像节奏。
LEVEL UP!
celebrate.png庆祝
触发奖励时短暂出现。可以更夸张，但仍需保持相同画布与锚点。
固定脚底锚点
将四张图叠成图层检查：画布大小一致，脚底或主体中心落在同一位置。这样切换动作时不会“瞬移”。
03
准确的技术边界
文件与图片规范
| 项目 | 程序要求 | 创作建议 |
|---|---|---|
| 格式 | PNG | 透明背景、RGB/RGBA |
| 画布 | 四张保持一致 | 1254 × 1254 px |
| 单张资源 | > 8 B，≤ 12 MB | 尽量控制在 1–3 MB |
| 预览图 | < 1 MB | 正方形、主体清楚；可直接使用 idle.png |
| theme.json | ≤ 64 KB | UTF-8 |
| 文件路径 | 只允许文件夹内相对路径 | 使用小写英文文件名 |
04
不用手写 JSON
生成主题配置
查看全部字段说明
schemaVersion必须为数字 1。
name必填；上传到 Steam 时最多使用前 128 个字符。
description可选；上传到 Steam 时最多使用前 8,000 个字符。
author可选；主题内署名。
version可选；更新日志会引用此值。
workshopId可选；填写已有作品 ID 会更新它，而不是新建作品。
preview可选；默认为 preview.png，找不到时回退到 idle.png。
images可选映射；省略时使用四个标准文件名。
05
发布与后续更新
交给 Key Clover 上传
- 01
启动 Steam 与 Key Clover
保持 Steam 客户端已登录。打开 Key Clover 的“主题”窗口。
- 02
选择主题文件夹
点击“发布本地主题”，选择包含 theme.json 的最外层文件夹，而不是某一张图片。
- 03
等待验证与上传
Key Clover 会验证路径、PNG 签名和大小，并创建或更新 Community 类型的公开 Workshop 作品。
- 04
完成 Steam 页面
应用会自动订阅、下载并打开作品页。首次发布请按 Steam 提示接受 Workshop 法律协议。
↻
更新作品，不要重复创建
把作品页面 URL 末尾的数字写进 workshopId，提高 version，然后再次发布同一个文件夹。
https://steamcommunity.com/sharedfiles/filedetails/?id=3772534632
06
发布前最后一分钟
排错清单
Windows
文件名大小写也要严格一致；避免保留名、反斜杠和超长路径。主题包只放实际要上传的文件。
macOS
不要依赖 Finder 的大小写容错。发布前用与 Windows 完全相同的英文文件名。
提示“Invalid theme asset”怎么办？
确认文件存在、是实际 PNG 而非改了扩展名的图片，并且大于 8 字节且不超过 12 MB。
提示预览图超过 1 MB 怎么办？
压缩 preview.png，或删除 preview 字段让程序回退到已压缩的 idle.png。限制是严格小于 1 MB。
上传成功但别人看不到怎么办？
打开作品页，确认已接受 Steam Workshop 法律协议，并检查作品的可见性与内容审核状态。