AI导哈

像素艺术生成插件

通过自然语言命令在Claude Code中创建、动画化和导出像素艺术的Aseprite插件，适用于游戏开发和数字艺术创作。

  • by willibrandon
  • Shell
  • 本地部署
  • 397 星标
  • 更新于
在 GitHub 查看 willibrandon/pixel-plugin

使用说明

适用于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（或“像素多通道光电二极管”，具体翻译取决于上下文，MCP在此处可能指Multi-Anode Photomultiplier Tube，即多阳极光电倍增管，但结合“pixel”一词，也可能指一种像素级的多通道光电探测器或类似技术） 模型上下文协议（MCP）服务器，用于与Aseprite进行通信。MCP服务器提供了40多种像素艺术操作工具，并且与插件一起打包提供。

快速入门

1. 先决条件

2. 安装

选项A：通过克劳德·科德（推荐）

在Claude Code中运行：

/plugin

然后：

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

3. 设置

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

/pixel-setup

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

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

4. 创建你的第一个精灵

# 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 <action> [args] 管理调色板 /pixel-palette set gameboy
/pixel-export <format> [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（彩色图形适配器）
  • snes 256色超级任天堂

现代调色板

  • 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 服务器无响应”

  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（注：这是一款像素艺术创作软件的名称，直接翻译为“像素精灵”可能不够准确，但在此处为保持原文形式，仍译为“Aseprite”，实际使用时可根据上下文选择更贴切的译名）**版本1.3.0或更高版本
  • 克劳德·科德版本1.0.0或更高版本
  • **像素-MCP（或根据上下文可译为“像素多通道处理单元”，具体翻译需结合实际应用场景）**MCP服务器（捆绑版）- 来源
  • 磁盘空间插件和二进制文件约50MB

贡献

欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南/贡献说明文件” 作为指导方针。

  1. 为仓库创建分支副本
  2. 创建特性分支（git checkout -b feature/amazing-feature）
  3. 提交更改（git commit -m 'Add amazing feature')
  4. 推送到分支（git push origin feature/amazing-feature）
  5. 打开拉取请求

许可证

这个项目遵循MIT许可协议授权——详见 许可证 文件中详述。

相关 MCP