适用于Claude Code的Aseprite像素艺术插件
使用Aseprite，通过Claude Code中的自然语言和命令来创建、动画制作并导出像素艺术。
*由……提供动力/支持 像素-MCP（或根据上下文可译为“像素-MCP模块”、“像素-MCP组件”等，具体译法需结合实际应用场景） - 为Aseprite提供的模型上下文协议服务器。*
特点/功能
自然语言像素艺术创作
- “创建一个64x64像素的Game Boy风格精灵”
- “画一个带有蓝色边框的红色圆圈”
- “制作一个16x16的瓦片（或方块）”
动画支持
- “添加一个4帧的行走循环”
- “创建一个闲置动画”
- “将帧定时设置为100毫秒”
高级技术
- 应用抖动图案
- 优化色彩搭配
- 添加阴影和抗锯齿
- 使用复古游戏机调色板（NES、Game Boy、C64、PICO-8）
游戏就绪导出
- PNG、GIF、精灵表格式
- 适用于Unity、Godot、Phaser的JSON元数据
- 像素完美缩放（2倍、4倍、8倍）
- 多种精灵表布局
它是如何运作的
这个插件使用的是 模型上下文协议（MCP）服务器，用于与Aseprite进行通信。MCP服务器提供了40多种像素艺术操作工具，并且与插件一起打包提供。
快速入门
1. 先决条件
- Aseprite（注：这可能是一个特定软件或工具的名称，直接翻译为中文可能不具有明确意义，因此保留原英文形式） 已安装 v1.3.0+ 版本
- 克劳德·科德 安装好的；已安装的
2. 安装
选项A：通过克劳德·科德（推荐）
在Claude Code中运行：
/plugin然后：
- 选择“添加市场”
- 输入：
willibrandon/pixel-plugin（针对GitHub）或./path/to/local/marketplace（针对本地） - 选择“浏览并安装插件”
- 查找并安装
pixel-plugin
选项B：从命令行
# Add the GitHub marketplace
claude plugin marketplace add willibrandon/pixel-plugin
# Install the plugin
claude plugin install pixel-plugin选项C：本地开发/测试
# Clone the repository
git clone https://github.com/willibrandon/pixel-plugin.git
cd pixel-plugin
# Add as local marketplace (from parent directory)
cd ..
claude plugin marketplace add ./pixel-plugin
# Install from local source
claude plugin install pixel-plugin@pixel-plugin3. 设置
配置Aseprite路径（一次性设置）：
/pixel-setup该命令将自动检测您的Aseprite安装位置。如果未找到，请手动指定路径：
/pixel-setup /Applications/Aseprite.app/Contents/MacOS/aseprite4. 创建你的第一个精灵
# Using slash commands
/pixel-new 64x64 gameboy
"Draw a character sprite"
/pixel-export png character.png
# Or natural language only
"Create a 32x32 Game Boy sprite of a character"
"Export it as character.png"使用
斜杠命令
| 命令 | 描述 | 示例 |
|---|---|---|
/pixel-new [size] [palette] | 创建新精灵 | /pixel-new icon nes |
/pixel-palette [args] | 管理调色板 | /pixel-palette set gameboy |
/pixel-export [file] | 导出精灵图 | /pixel-export gif anim.gif |
/pixel-setup [path] | 配置插件 | /pixel-setup |
/pixel-help [topic] | 获取帮助 | /pixel-help palettes |
自然语言
该插件能够响应自然语言请求：
创作：
"Create a 64x64 RGB sprite"
"Make a 16x16 tile with NES palette"
"Start a new 128x128 canvas"绘画：
"Draw a red circle in the center"
"Fill the background with blue"
"Draw a pixelated tree"动画：
"Add 4 frames for a walk cycle"
"Create a 2-frame idle animation"
"Set all frame durations to 100ms"高级：
"Apply Floyd-Steinberg dithering"
"Reduce to 16 colors"
"Add shading with light from top-left"
"Convert to PICO-8 palette"出口：
"Export as PNG at 4x scale"
"Export as animated GIF at 12 FPS"
"Create a horizontal spritesheet"
"Export with Unity JSON metadata"示例
示例1：Game Boy角色
/pixel-new 48x48 gameboy
"Draw a character sprite - round head, square body, stick limbs"
"Add a 2-frame breathing animation"
/pixel-export gif character-idle.gif fps=2结果： 带有微妙待机动画的Game Boy角色。
示例2：NES图块
/pixel-new tile nes
"Draw a brick wall pattern"
"Apply Bayer dithering for texture"
/pixel-export png brick-tile.png scale=4结果： 复古NES风格砖块瓦片，为适应现代显示屏进行了4倍缩放。
示例3：现代像素艺术
/pixel-new 64x64
"Draw a detailed sword with silver blade and gold hilt"
"Add shading from top-left light source"
"Apply soft antialiasing to edges"
/pixel-export png sword.png scale=2结果： 带有阴影和抗锯齿效果的现代像素艺术。
示例4：游戏中的动画精灵
/pixel-new 32x32 pico8
"Draw a simple character"
"Create an 8-frame run cycle"
"Set frames to 80ms each"
/pixel-export json game-character.json format=unity结果： game-character.png 精灵表（spritesheet）+ game-character.json 已准备好导入Unity。
调色板预设
复古游戏机
nes- 54色NES调色板gameboy- 四色Game Boy绿色gameboy-gray- 4级灰度c64- 16色Commodore 64（康懋达64）cga- 4色IBM CGA（彩色图形适配器）snes256色超级任天堂
现代调色板
pico8- PICO-8 幻想游戏机（16色）sweetie16- GrafxKid的热门16色调色板db16- DawnBringer的16种颜色db32- DawnBringer的32种颜色
通用的
retro16- 通用16色复古风格retro8- 通用8色复古风格grayscale4/8/16- 灰度调色板
导出格式
格式
- PNG（Portable Network Graphics，便携式网络图形） - 单帧或当前帧带透明度
- GIF（图形交换格式） - 带有循环和定时控制的动画GIF
- 精灵表（或精灵图） - 多种布局（水平、垂直、网格、紧密排列）
- JSON（JavaScript对象表示法） - 游戏引擎的元数据（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（发音：/ˈlɪnʊks/，中文常音译为“林纳斯”或直接使用原名“Linux”）：
/usr/bin/aseprite - Windows:
C:\Program Files\Aseprite\Aseprite.exe
“MCP 服务器无响应”
- 验证Aseprite已安装且可访问
- 检查配置：
cat ~/.config/pixel-mcp/config.json - 重新运行设置：
/pixel-setup - 检查二进制文件权限：
chmod +x bin/pixel-mcp
“导出失败”或“文件未找到”
- 确保在导出之前创建精灵（或图像精灵）
- 检查输出路径是否可写
- 验证格式是否受支持（png、gif、sheet、json）
看见 已知问题 以获取更多故障排除信息。
平台支持
- macOS（适用于Intel和Apple Silicon）
- Linux（x86_64 和 ARM64）
- Windows（x86_64）
要求
- Aseprite（注：这是一款像素艺术创作软件的名称，直接翻译为“像素精灵”可能不够准确，但在此处为保持原文形式，仍译为“Aseprite”，实际使用时可根据上下文选择更贴切的译名）版本1.3.0或更高版本
- 克劳德·科德版本1.0.0或更高版本
- 像素-MCP（或根据上下文可译为“像素多通道处理单元”，具体翻译需结合实际应用场景）MCP服务器（捆绑版）- 来源
- 磁盘空间插件和二进制文件约50MB
贡献
欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南/贡献说明文件” 作为指导方针。
- 为仓库创建分支副本
- 创建特性分支（
git checkout -b feature/amazing-feature） - 提交更改（
git commit -m 'Add amazing feature') - 推送到分支（
git push origin feature/amazing-feature） - 打开拉取请求
许可证
这个项目遵循MIT许可协议授权——详见 许可证 文件中详述。