Навык Codex/Claude и Python CLI, который превращает одно исходное изображение в готовые для игры 2D-атласы спрайтов или прозрачные циклические анимации.
studioigor/ref2game
Навык для Claude Code и Codex, который превращает одно референсное изображение в игровой прототип 2D-игры для браузера.
- Звёзды
- 296
- Форки
- 41
- Открытые issues
- 2
- Последний коммит
- 23 дня назад
Что это?
ref2game превращает скриншот, ключевой арт или концепт-изображение в игровой прототип 2D-игры для браузера. AI генерирует графику по частям в стиле референса, а движение, освещение, частицы, камеру и HUD реализует код в небольшом движке на WebGL2. Страница обновляется в реальном времени, пока работает агент.
Проект поставляется в двух вариантах одного навыка: папка claude/ предназначена для Claude Code, а codex/ — для Codex. В обоих вариантах используются общий движок, риги, автоматические проверки и обработка референсов. Спрайты собираются из вырезанных частей ригов с двухкостными конечностями, поэтому циклы ходьбы и движения животных задаются суставами, а не перемещением целого изображения.
Процесс начинается с нескольких вопросов о настройке, затем создаётся первый кадр и сравнивается с референсом, а в итоге получается статическая игровая сборка с текстурами, манифестом и исходниками. Каждый обнаруженный дефект исправляется и покрывается автоматической проверкой, а фоновые критики оценивают графику, движение и соответствие результату.
Ключевые возможности
- 01Создаёт графику по частям в стиле референса, а движок отвечает за движение и эффекты.
- 02Собирает персонажей из вырезанных частей ригов с двухкостными конечностями и измерением движений на уровне суставов.
- 03Включает автоматические проверки движений, например скольжения стопы и длины шага.
- 04Перезагружает страницу в браузере при каждом изменении, сохраняя состояние игры.
- 05Создаёт статическую игровую сборку с текстурами, манифестом и исходниками.
Сценарии использования
- Превращение скриншота игровой концепции в интерактивный прототип для презентации или плейтеста.
- Эксперименты с жанрами 2D-игр, например платформерами или шутерами с видом сверху, на основе одного изображения.
- Прототипирование анимированных спрайтов по концепт-арту без ручной сборки рига.
- Экспорт небольшой браузерной игры по итогам работы с агентом.
Быстрый старт
- 1
Отправьте запрос на установку своему агенту (Claude Code или Codex)
- 2
Для Claude Code используйте папку claude/, а для Codex — папку codex/
- 3
В Claude Code отправьте /ref2game, а в Codex — $ref2game, приложив референсное изображение
Что важно знать
- Требуется Claude Code или Codex; работает только в macOS или Linux.
- Необходимы Python 3.9+ и Node.js 18+; Playwright с Chromium устанавливается при первом запуске.
- Для видео в качестве референсов и рендеринга видео требуется ffmpeg.
- Генерация изображений в версии для Claude Code зависит от выбранного вами API или инструмента для работы с изображениями и оплачивается вами.
В подборках
Темы
Частые вопросы
- Что такое ref2game?
- Навык для Claude Code и Codex, который превращает одно референсное изображение в игровой прототип 2D-игры для браузера. ref2game превращает скриншот, ключевой арт или концепт-изображение в игровой прототип 2D-игры для браузера. AI генерирует графику по частям в стиле референса, а движение, освещение, частицы, камеру и HUD реализует код в небольшом движке на WebGL2. Страница обновляется в реальном времени, пока работает агент.
- ref2game можно использовать бесплатно? Какая у него лицензия?
- ref2game распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- ref2game всё ещё поддерживается?
- Активно поддерживается. Последний коммит в ref2game — 15 окт. 2026 г..
- Для чего можно использовать ref2game?
- Превращение скриншота игровой концепции в интерактивный прототип для презентации или плейтеста. Эксперименты с жанрами 2D-игр, например платформерами или шутерами с видом сверху, на основе одного изображения. Прототипирование анимированных спрайтов по концепт-арту без ручной сборки рига. Экспорт небольшой браузерной игры по итогам работы с агентом.
- Как установить ref2game?
- Отправьте запрос на установку своему агенту (Claude Code или Codex) Для Claude Code используйте папку claude/, а для Codex — папку codex/ В Claude Code отправьте /ref2game, а в Codex — $ref2game, приложив референсное изображение
- Где скачать ref2game?
- Исходный код и инструкции по установке — на GitHub: https://github.com/studioigor/ref2game
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Генератор, с помощью которого Claude Code или Codex автономно создаёт полноценные игры на Godot, Bevy, Babylon.js или three.js, включая ресурсы и подтверждающие записи.
Навыки для агентов, которые помогают создавать автономные HTML-каркасы, интерактивные прототипы, планы и диаграммы.
Плагин для рабочих процессов coding-агентов: от мозгового штурма и макетов до согласования спецификации, разработки по TDD и визуальной проверки результата.
Превращает одну иллюстрацию в анимированный 2D-аватар на сетке, который моргает, говорит и покачивается; риг готовит coding agent, а настройка выполняется в локальном редакторе.
Восемь навыков для агентов, которые помогают создавать, анимировать и проверять сайты с 3D-графикой и прокруткой на three.js.