Repolode
studioigor

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. 1

    Отправьте запрос на установку своему агенту (Claude Code или Codex)

  2. 2

    Для Claude Code используйте папку claude/, а для Codex — папку codex/

  3. 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 обновляется ежедневно.

Похожие проекты

Навык Codex/Claude и Python CLI, который превращает одно исходное изображение в готовые для игры 2D-атласы спрайтов или прозрачные циклические анимации.

3,9 тыс.+732 за неделю405PythonApache-2.0Обновлён 3 часа назад

Превращает одну иллюстрацию в анимированный 2D-аватар на сетке, который моргает, говорит и покачивается; риг готовит coding agent, а настройка выполняется в локальном редакторе.

1,9 тыс.+153 за неделю202TypeScriptMITАктивно поддерживаетсяОбновлён позавчера