使用Claude Code创建Aseprite像素艺术插件

通过自然语言和Claude Code中的命令，在Aseprite中创建、动画化和导出像素艺术。

由pixel-mcp提供支持——一个用于Aseprite的模型上下文协议服务器。

特性

自然语言像素艺术创作

• "创建一个64x64的Game Boy风格精灵"
• "绘制一个红色圆圈，蓝色轮廓"
• "制作一个16x16的瓷砖"

动画支持

• "添加一个四帧行走循环"
• "创建一个空闲动画"
• "设置帧时长为100毫秒"

高级技巧

• 应用抖动图案
• 优化颜色调色板
• 添加阴影和抗锯齿
• 使用复古游戏机调色板（NES、Game Boy、C64、PICO-8）

游戏就绪导出

• PNG、GIF、精灵表格式
• Unity、Godot、Phaser的JSON元数据
• 像素完美缩放（2x、4x、8x）
• 多种精灵表布局

工作原理

此插件使用pixel-mcp模型上下文协议服务器与Aseprite通信。MCP服务器提供了超过40个工具用于像素艺术操作，并捆绑在插件中。

快速开始

1. 先决条件

• 安装Aseprite v1.3.0+
• 安装Claude Code

2. 安装

选项A：通过Claude Code（推荐）

在Claude Code中运行：

/plugin

然后：

1. 选择“添加市场”
2. 输入：willibrandon/pixel-plugin（对于GitHub）或./path/to/local/marketplace（对于本地）
3. 选择“浏览并安装插件”
4. 查找并安装pixel-plugin

选项B：从命令行

# 添加GitHub市场
claude plugin marketplace add willibrandon/pixel-plugin

# 安装插件
claude plugin install pixel-plugin

选项C：本地开发/测试

# 克隆仓库
git clone https://github.com/willibrandon/pixel-plugin.git
cd pixel-plugin

# 作为本地市场添加（从父目录）
cd ..
claude plugin marketplace add ./pixel-plugin

# 从本地源安装
claude plugin install pixel-plugin@pixel-plugin

3. 配置

配置Aseprite路径（一次性设置）：

/pixel-setup

该命令会自动检测您的Aseprite安装。如果未找到，请手动指定路径：

/pixel-setup /Applications/Aseprite.app/Contents/MacOS/aseprite

4. 创建您的第一个精灵

# 使用斜杠命令
/pixel-new 64x64 gameboy
"绘制一个角色精灵"
/pixel-export png character.png

# 或仅使用自然语言
"创建一个32x32的Game Boy角色精灵"
"将其导出为character.png"

使用方法

斜杠命令

命令	描述	示例
/pixel-new [大小] [调色板]	创建新精灵	/pixel-new icon nes
/pixel-palette <动作> [参数]	管理调色板	/pixel-palette set gameboy
/pixel-export <格式> [文件]	导出精灵	/pixel-export gif anim.gif
/pixel-setup [路径]	配置插件	/pixel-setup
/pixel-help [主题]	获取帮助	/pixel-help palettes

自然语言

插件响应自然语言请求：

创建：

"创建一个64x64的RGB精灵"
"制作一个具有NES调色板的16x16瓷砖"
"开始一个新的128x128画布"

绘制：

"在中心绘制一个红色圆圈"
"用蓝色填充背景"
"绘制一棵像素化的树"

动画：

"添加四个帧的行走循环"
"创建一个两帧的空闲动画"
"将所有帧的持续时间设置为110毫秒"

高级：

"应用Floyd-Steinberg抖动"
"减少到16种颜色"
"从左上角光源添加阴影"
"转换为PICO-8调色板"

导出：

"以4倍缩放导出为PNG"
"以每秒12帧导出为动画GIF"
"创建一个水平精灵表"
"带有Unity JSON元数据导出"

示例

示例1：Game Boy角色

/pixel-new 48x48 gameboy
"绘制一个角色精灵——圆形头部，方形身体，棍状四肢"
"添加一个两帧的呼吸动画"
/pixel-export gif character-idle.gif fps=2

结果： 带有微妙空闲动画的Game Boy角色。

示例2：NES瓷砖

/pixel-new tile nes
"绘制砖墙图案"
"应用Bayer抖动以增加纹理"
/pixel-export png brick-tile.png scale=4

结果： 经典NES风格的砖墙瓷砖，放大4倍以适应现代显示器。

示例3：现代像素艺术

/pixel-new 64x64
"绘制一把细节丰富的剑，银色刀片，金色柄部"
"从左上角光源添加阴影"
"对边缘应用柔和的抗锯齿"
/pixel-export png sword.png scale=2

结果： 带有阴影和抗锯齿的现代像素艺术。

示例4：游戏动画精灵

/pixel-new 32x32 pico8
"绘制一个简单的角色"
"创建一个八帧的跑步循环"
"将每个帧设置为80毫秒"
/pixel-export json game-character.json format=unity

结果： game-character.png精灵表 + game-character.json，准备好导入Unity。

调色板预设

复古游戏机

• nes - 54色NES调色板
• gameboy - 4色Game Boy绿色
• gameboy-gray - 4级灰度
• c64 - 16色Commodore 64
• cga - 4色IBM CGA
• snes - 256色Super Nintendo

现代调色板

• pico8 - PICO-8幻想控制台（16色）
• sweetie16 - GrafxKid的流行16色调色板
• db16 - DawnBringer的16色
• db32 - DawnBringer的32色

通用

• retro16 - 通用16色复古
• retro8 - 通用8色复古
• grayscale4/8/16 - 灰度调色板

导出格式

格式

• PNG - 单帧或当前帧带透明度
• GIF - 动画GIF，带循环和定时控制
• 精灵表 - 多种布局（水平、垂直、网格、打包）
• JSON - 游戏引擎元数据（Aseprite、TexturePacker、Unity、Godot）

精灵表布局

• horizontal - 所有帧排成一行（网页动画）
• vertical - 所有帧排成一列
• grid - 最优行×列（游戏引擎）
• packed - 空间优化（纹理图集）

缩放

• scale=1 - 原始大小
• scale=2 - 2倍像素完美
• scale=4 - 4倍像素完美
• scale=8 - 8倍像素完美

文档

• 技能参考 - 详细的技能文档
• 命令参考 - 斜杠命令文档

故障排除

"未找到Aseprite"错误

运行设置命令：

/pixel-setup /path/to/aseprite

平台特定路径：

• macOS：/Applications/Aseprite.app/Contents/MacOS/aseprite
• Linux：/usr/bin/aseprite
• Windows：C:\Program Files\Aseprite\Aseprite.exe

"MCP服务器无响应"

1. 验证Aseprite已安装且可访问
2. 检查配置：cat ~/.config/pixel-mcp/config.json
3. 重新运行设置：/pixel-setup
4. 检查二进制权限：chmod +x bin/pixel-mcp

"导出失败"或"文件未找到"

• 确保在导出之前已创建精灵
• 检查输出路径是否可写
• 验证格式是否受支持（png、gif、sheet、json）

参见已知问题获取更多故障排除信息。

平台支持

• macOS（Intel和Apple Silicon）
• Linux（x86_64和ARM64）
• Windows（x86_64）

要求

• Aseprite：v1.3.0或更高版本
• Claude Code：v1.0.0或更高版本
• pixel-mcp：MCP服务器（捆绑） - 源码
• 磁盘空间：插件和二进制文件约需50MB

贡献

欢迎贡献！请参阅CONTRIBUTING.md获取指南。

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加精彩功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开拉取请求

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。