pixel-plugin
Плагин Claude Code для пиксель-арта в Aseprite: спрайты, анимация, ретро-палитры, дизеринг и экспорт для Unity, Godot и Phaser
- 413 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- В плагин вложены готовые бинарники pixel-mcp для пяти сочетаний системы и процессора, и он запускает их на вашем компьютере
- Сервер запускает Aseprite и пишет файлы PNG, GIF и JSON в указанные вами пути
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/pixel-pluginОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- В плагин вложены готовые бинарники pixel-mcp для пяти сочетаний системы и процессора, и он запускает их на вашем компьютере
- Сервер запускает Aseprite и пишет файлы PNG, GIF и JSON в указанные вами пути
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pixel-plugin дает Claude Code рисовать в Aseprite по описанию на обычном языке. Плагин несет четыре скилла (создание, анимация, экспорт и профессиональные приемы), пять команд и MCP-сервер pixel-mcp с более чем сорока инструментами. Готовые бинарники сервера для macOS, Linux и Windows лежат в самом плагине. Запрос вроде «нарисуй спрайт 64 на 64 в стиле Game Boy» создает холст, а дальше агент рисует фигуры, заливает фон, добавляет кадры анимации, задает их длительность и накладывает дизеринг (Флойда—Стейнберга, Байера). К палитрам относятся NES, Game Boy, C64, CGA, SNES, PICO-8, Sweetie 16 и DawnBringer 16 и 32, а также общие наборы из 8 и 16 цветов и градации серого. Затенение и сглаживание граней агент применяет по отдельной просьбе. Экспорт идет в PNG, GIF, спрайт-лист с четырьмя раскладками (горизонтальной, вертикальной, сеткой и плотной упаковкой) и в JSON с метаданными для Unity, Godot, Phaser, TexturePacker и самого Aseprite. Пиксельное масштабирование доступно в 2, 4 и 8 раз. Команды `/pixel-new`, `/pixel-palette`, `/pixel-export`, `/pixel-setup` и `/pixel-help` дают быстрый путь для типовых действий.
Для кого. Для инди-разработчиков игр и художников, которые работают в Aseprite и хотят набросать спрайты, плитки и анимации разговором с агентом, а затем сразу получить файлы для движка.
Подходит, если
- Нужен спрайт или плитка 16 на 16, 32 на 32 или 64 на 64 в ретро-палитре, например NES или Game Boy
- Нужна анимация из нескольких кадров, например цикл ходьбы, и точная длительность каждого кадра
- Нужно сократить число цветов или применить дизеринг, чтобы изображение подошло под ограничения консоли
- Нужен спрайт-лист с JSON-метаданными для Unity, Godot или Phaser
- Нужен быстрый черновик пиксель-арта по описанию на обычном языке
Не подходит, если
- У вас нет Aseprite версии 1.3.0 или новее: плагин управляет установленной программой и не заменяет ее
- Нужна растровая иллюстрация в высоком разрешении: инструменты рассчитаны на пиксельную графику с палитрами
- Нужны векторные форматы или трехмерная графика: поддерживаются PNG, GIF, спрайт-лист и JSON
Пример запроса к агенту
Создай спрайт 32 на 32 в палитре Game Boy: персонаж с круглой головой, добавь двухкадровую анимацию дыхания и экспортируй GIFОграничения
Нужны установленный Aseprite 1.3.0 или новее и Claude Code. Путь к программе задается один раз командой `/pixel-setup`, она сама ищет Aseprite и принимает путь вручную, а настройки хранятся в `~/.config/pixel-mcp/config.json`. Плагин занимает около 50 МБ из-за встроенных бинарников для macOS (Intel и Apple Silicon), Linux (x86-64 и ARM64) и Windows (x86-64).
Автор перечисляет известные ограничения. Размер холста не больше 65535 на 65535 точек, индексированный режим ограничен 256 цветами, а длительность кадра лежит в пределах от 1 до 65535 мс. На macOS автоопределение пути к Aseprite может не сработать при нестандартной установке. Версия из Snap на Linux работает в песочнице и может не получить доступ, лучше обычный пакет. На Windows пути с пробелами в файле настроек нужно записывать с экранированием. Последний коммит в репозитории сделан в октябре 2025 года.
Как отключить. Выполните `claude plugin uninstall pixel-plugin`, затем при желании `claude plugin marketplace remove pixel-plugin`. Файл настроек `~/.config/pixel-mcp/config.json` останется на диске, удалите его вручную.
Частые вопросы
Как поставить pixel-plugin в Claude Code?
Командой `claude plugin marketplace add willibrandon/pixel-plugin` подключите маркетплейс, затем `claude plugin install pixel-plugin`. Первый запуск требует настройки: выполните `/pixel-setup`, и плагин найдет установленный Aseprite.
Какие ретро-палитры есть?
NES на 54 цвета, Game Boy на 4 цвета, Game Boy в серых тонах, C64 на 16 цветов, CGA на 4, SNES на 256, PICO-8, Sweetie 16, DawnBringer 16 и 32, универсальные наборы на 8 и 16 цветов и градации серого на 4, 8 и 16 оттенков.
В каких форматах можно сохранить результат?
PNG, GIF с настройкой повторов и скорости, спрайт-лист с раскладками horizontal, vertical, grid и packed, а также JSON с метаданными для Unity, Godot, Phaser, TexturePacker и Aseprite. Для масштабирования доступны коэффициенты 2, 4 и 8 без размытия.
Что делать, если плагин не находит Aseprite?
Выполните `/pixel-setup` и укажите путь вручную. На macOS это `/Applications/Aseprite.app/Contents/MacOS/aseprite`, на Linux `/usr/bin/aseprite`, на Windows `C:\Program Files\Aseprite\Aseprite.exe`. Затем проверьте файл `~/.config/pixel-mcp/config.json`.
Нужен ли отдельный MCP-сервер?
Нет. Сервер pixel-mcp входит в плагин как готовый бинарник для вашей платформы и запускается плагином. Исходники сервера лежат в отдельном репозитории автора.
Какие команды есть у плагина?
Пять: `/pixel-new [размер] [палитра]` создает спрайт, `/pixel-palette <действие>` управляет палитрой, `/pixel-export <формат> [файл]` сохраняет результат, `/pixel-setup [путь]` настраивает плагин, `/pixel-help [тема]` выдает справку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныAseprite AI Artist — пиксель-арт через агента
Aseprite AI Artist
Плагин и MCP-сервер дают агенту рисовать и анимировать в уже открытом окне Aseprite, каждое действие откатывается одним Ctrl+Z
MCP-сервер дает агенту 123 инструмента Aseprite для пиксель-арта и анимации и снимки, по которым он проверяет рисунок
Библиотека из 244 пиксельных эффектов в виде кода и скилл для Claude Code, который находит, перекрашивает и рисует новые эффекты
Скилл для пиксель-арта: агент описывает рисунок кодом, а pxl собирает PNG, листы спрайтов, GIF и показывает рисование в браузере
Десять скиллов SpriteCook учат агента делать пиксель-арт и игровую графику, анимировать спрайты и выгружать их в Godot
Скиллы для Codex: 2D-спрайты, анимационные листы и слоистые карты для игр из текстового запроса с экспортом в PNG, GIF и Godot
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| pixel-plugin (эта карточка) | нет | 413 | ||
| Aseprite AI Artist — пиксель-арт через агента | нет | 617 | рисует и анимирует в вашем открытом окне Aseprite, а не через отдельный процесс | |
| Aseprite MCP Tools | нет | не нужна | 899 | MCP-сервер со 123 инструментами Aseprite и предпросмотром, без скиллов и команд |
Коротко о README
Описание перечисляет четыре возможности: рисование по тексту, анимацию, продвинутые приемы и экспорт для игровых движков. Затем даны три способа установки плагина, первоначальная настройка, таблицы команд и палитр и четыре сквозных примера с готовым результатом. Завершают текст раздел поиска неисправностей, поддерживаемые платформы и требования.