Руководство по интеграции

Перенеси свою игру в Combos — из студийного проекта или из проекта, созданного с Codex, Claude Code или Cursor. Порядок работы: подготовить браузерную сборку → проверить локально → загрузить через Combos CLI → сыграть онлайн → обновить.

Выбери маршрут

Веб-сборка уже работает? Начни с подготовки и публикации и обновлений.
Сборки ещё нет? Пройди H5, Unity или Roblox, затем публикуй.
Для повторения готового проекта есть три полных примера со скриншотами, исходниками и результатами проверок.
При проблемах открой устранение неполадок.

Версии и результаты

Оригинал проверен 2026-10-08 с Combos CLI v1.14.2. Примеры выполнялись в macOS 15.3, Node.js 25.7.0 и Unity 6.3 LTS 6000.3.25f1. Результаты ниже относятся к тем запускам. Пути, настройки и патчи примеров не являются общими требованиями. Успешная загрузка, опубликованная версия и реальная играбельность проверяются отдельно.

Перед началом

Combos размещает игры, работающие в браузере. Загружай полный статический сайт, обычно из папки dist. Название папки может отличаться — указывай настоящий путь. Инструмент разработки не меняет итоговый формат.

Подготовь нужные файлы

Проект	Что подготовить
Готовая H5-игра	`index.html` и все связанные файлы
HTML + JavaScript	HTML, JS, CSS и ассеты; компиляция не нужна
Vite / Webpack	Статический результат команды сборки проекта
Unity	Полный нативный экспорт WebGL
Roblox	Ассеты и механики, адаптированные или заново реализованные в браузерном движке

Для установки Combos CLI не нужны Node.js, плагин Unity или SDK. Vite нужна своя среда Node.js, а Unity — официальный Web Build Support.

Разберись с расположением файлов


my-game/
├── source/
├── dist/
│   ├── index.html
│   └── assets/
├── cover.png
└── combos.json

В корне проекта лежат редактируемые исходники. ./dist отсчитывается от текущего каталога терминала. Храни cover.png и созданный combos.json в корне. Последний связывает проект с опубликованной игрой, но не является исходным кодом.

Открой весь проект и его терминал в Codex либо используй системный терминал. Замени путь в кавычках; сохрани кавычки, если есть пробелы. Убедись, что в указанной папке есть dist и cover.png, или сначала подготовь их.


cd "/path/to/project"
pwd
ls


Set-Location "C:\path\to\project"
Get-Location
Get-ChildItem

Локальная и облачная среда

Codex и Cursor создают файлы в выбранном рабочем пространстве. Перед публикацией попроси агента указать полный путь, команду сборки, выходную папку, адрес предпросмотра и результат проверки основной механики.

В облаке можно собрать и загрузить игру там, где установлен CLI, либо скачать проект и работать локально. Облачный 127.0.0.1 — не твой компьютер: используй предпросмотр инструмента или локальный сервер после скачивания. Локальный адрес доступен только при работающем сервере; ссылка Combos работает независимо.

Как читать примеры

Запускай команды в указанной среде и каталоге. Подставляй свои пути, названия, обложки и устройства. Коммит и патч BoatAttack, координаты Ball Game относятся только к этим примерам. Фрагменты Lua/JavaScript объясняют реализацию: это не команды терминала и не универсальные конвертеры.

Публикация и обновление

1. Установи CLI и войди

Попроси агента установить Combos CLI и его skill по официальной инструкции , проверить установку и помочь со входом. Можно начать со страницы CLI .


combos --version
combos account status
combos account login

Выполняй combos account login только без активного входа и заверши авторизацию в браузере. Перед загрузкой проверь версию и аккаунт. combos update --check проверяет обновления, combos update устанавливает их.

2. Подготовь сборку и обложку

Положи index.html в корень полного результата сборки и создай cover.png из настоящего скриншота игры. HTML/JS уже может быть готовым результатом. Для Vite, Webpack и Unity загружай сгенерированные файлы, без node_modules, Library и всего проекта разработки. Не включай учётные данные, серверные секреты и combos.json в браузерную сборку.

Ограничения: после распаковки всего ≤ 200 MiB, один файл ≤ 100 MiB, не более 2 000 файлов. Отдельного продуктового лимита на ZIP нет; архив BoatAttack в описанном запуске занимал 124,88 MiB.

Игра размещается по вложенному пути. Используй относительные локальные URL, например ./assets/game.js, а в Vite — base: './'. Unity уже создаёт относительные Build/... и StreamingAssets/.... Внешние HTTPS-адреса сохраняй; не заменяй строки массово в проверенном выводе движка.

3. Проверь именно итоговую сборку

При установленном Python выполни нужную команду из корня, оставь сервер работать и открой http://127.0.0.1:8000/.


python3 -m http.server 8000 --bind 127.0.0.1 --directory dist


py -m http.server 8000 --bind 127.0.0.1 --directory dist

Подойдут также Vite preview или Unity Build And Run. Проверяй папку, которую будешь загружать, а не только сервер разработки. Не открывай Unity HTML через file://. Пройди начало, движение/основное действие, завершение и повтор. Проверь Console/Network на ошибки и отсутствующие файлы. Попроси агента разместить ту же сборку по вложенному пути, исправить проблемы и пересобрать перед загрузкой.

4. Создай игру

Замени название и пути. Выбери pc, mobile или pc,mobile, а также landscape либо portrait согласно проверенной поддержке.


combos post create --dir ./dist --title "My Game" --cover ./cover.png --platform pc --screen-orientation landscape
combos post get

При первом создании обязательна обложка, при новой сборке — --platform. Параметры устройства и ориентации не добавляют сенсорное управление и не меняют интерфейс. CLI вернёт ссылку, код поиска Canvas, Post и результат публикации, а в корне появится combos.json.

CLI сам создаёт архив. Для ручного ZIP упакуй всё содержимое dist, чтобы index.html оказался прямо в корне распакованной папки. В macOS/Linux с zip:


cd dist
zip -r ../game-dist.zip .
cd ..

В Windows выдели все файлы и папки внутри dist и создай архив.

5. Проверь публичную ссылку

Останови предпросмотр через Ctrl+C, открой полученную ссылку и сыграй снова. Найди игру в Canvas по пятизначному коду, сохранив начальные нули. Проверь status, revision и submission_is_current. Если отправленная версия ещё не текущая, следуй фактическому ответу CLI и проверь публичную версию.


short_url: https://share.combos.game/p/0875954
game_code: 08759
status: POST_STATUS_PUBLISHED
revision: 2
submission_is_current: true

6. Обнови ту же игру

Сохрани свой combos.json, измени исходники, пересобери и повтори локальные проверки перед обновлением:


combos post update --dir ./dist --platform pc --screen-orientation landscape
combos post get

Убедись в новой ревизии и снова сыграй по той же ссылке. Не создавай новый Post при каждой правке. Если начинаешь с чужих исходников, сначала создай свою игру. Название и обложку можно менять отдельно как метаданные; новый dist всё равно требует platform.

Запрос агенту

Найди проект и проверь вход в CLI. Создай полный статический результат с относительными путями. Запусти предпросмотр, укажи адрес и проверь основную механику. Подготовь обложку из реального скриншота. Создай мою первую игру или обнови игру, связанную с моим combos.json, указав действительно поддерживаемые устройства и ориентацию. Останови локальный сервер, сыграй через Combos и верни ссылку, код Canvas, ревизию и результат публикации. Для Unity используй нативный WebGL без плагина Combos Editor.

Источник: руководство по интеграции с Combos , проверено 2026-10-08 с CLI v1.14.2. Результаты относятся к запускам, описанным в оригинале.