Как выложить игру в Яндекс Игры в 2026 году: пошаговая инструкция

Выложить свою игру в Яндекс Игры можно бесплатно. Для публикации понадобится готовая браузерная сборка, подключённый SDK Яндекс Игр и аккаунт разработчика. Затем игру нужно упаковать в ZIP, загрузить в Консоль, заполнить карточку, протестировать и отправить на модерацию.

На словах всё просто. На практике именно перед первой публикацией появляется десяток вопросов: где должен лежать index.html, обязателен ли SDK, что писать в описании, сколько контента должно быть в игре, почему не работает Game Ready и из-за чего модерация может вернуть проект.

Ниже разберём весь путь по порядку — от папки с готовой HTML5-игрой до статуса «Опубликовано».

Что нужно, чтобы выложить свою игру в Яндекс Игры

Для первой публикации не нужен собственный сервер и не обязательно использовать большой игровой движок. Подойдёт обычная браузерная игра на HTML, JavaScript и Canvas, проект на Phaser или web-сборка другого движка.

Главное — чтобы результат запускался как веб-приложение и соответствовал требованиям платформы.

Самый важный момент: не нужно сначала строить идеальную инфраструктуру. Если твоя игра уже работает в браузере, значительная часть пути пройдена.

Сколько стоит публикация игры в Яндекс Играх

Размещение браузерной игры на платформе бесплатное. Сам Яндекс предоставляет хостинг для загружаемой web-сборки, поэтому для обычной одиночной HTML5-игры отдельный сервер не нужен.

Сервер появляется уже тогда, когда его требует сама архитектура проекта: например, для мультиплеера, собственных аккаунтов, общего состояния игрового мира или сложной серверной логики.

Шаг 1. Подготовьте игру к публикации

Я бы начал не с Консоли, а с самой сборки. Значительная часть проблем на модерации возникает ещё до загрузки: неправильная структура архива, ошибки JavaScript, проблемы с управлением, слишком маленькое количество контента или игра, которая работает только на компьютере разработчика.

Игра должна запускаться в браузере

Если проект сделан на HTML, CSS, JavaScript, Canvas или Phaser, скорее всего, он уже находится в нужном формате.

Минимальная структура может выглядеть так:

my-game/

├── index.html
├── game.js
├── style.css
└── assets/
├── images/
└── audio/

Если используется Unity, Godot, Construct, GDevelop или другой движок, понадобится именно его web-export, а не desktop-сборка для Windows.

index.html должен находиться в корне архива

Это простая, но важная техническая деталь. После распаковки ZIP платформа должна сразу видеть index.html.

Неправильно:

game.zip

└── my-game/
├── index.html
├── game.js
└── assets/

Правильно:

game.zip

├── index.html
├── game.js
├── style.css
└── assets/

Размер распакованной игры — не более 100 МБ

По актуальным требованиям Яндекс Игр суммарный размер файлов после распаковки архива не должен превышать 100 МБ.

Обрати внимание именно на формулировку «после распаковки». ZIP на диске может занимать меньше места благодаря сжатию, но платформа смотрит на содержимое игры.

Если проект внезапно вырос до сотен мегабайт, сначала стоит проверить ассеты:

• слишком большие PNG;
• несжатые аудиофайлы;
• неиспользуемые изображения;
• дубли ресурсов;
• тяжёлые шрифты;
• ассеты, которые остались от старых версий проекта.

Не используйте кириллицу и пробелы в именах файлов

В названиях файлов и каталогов внутри архива не должно быть пробелов и русских символов.

Вместо:

assets/

├── главный герой.png
└── музыка уровень 1.mp3

лучше:

assets/

├── main-character.png
└── level-1-music.mp3

Проверьте игру на всех заявленных устройствах

Если в карточке указано, что игра работает на компьютерах и смартфонах, модерация может проверить оба варианта.

Поэтому недостаточно уменьшить Canvas и считать мобильную версию готовой. Нужно отдельно проверить:

• touch-управление;
• размер кнопок;
• читаемость текста;
• портретную и альбомную ориентацию;
• поведение при изменении размера экрана;
• производительность на слабом устройстве.

Если мобильной версии пока нет, лучше честно не заявлять мобильные устройства, чем отправлять на проверку сломанную адаптацию.

Игра должна выглядеть законченной

На модерацию стоит отправлять продукт, в который уже можно нормально играть. Заглушки, сломанные кнопки, незаконченные экраны, отсутствие нужных текстур и механики, которые блокируют прохождение, могут стать причиной отказа.

Самый простой тест: открыть игру в новой вкладке и представить, что ты впервые увидел её и вообще не знаешь, что хотел сделать разработчик.

Понятно ли, куда нажимать? Есть ли цель? Можно ли проиграть или победить? Работает ли перезапуск? Можно ли случайно попасть в состояние, из которого игра уже не продолжается?

В игре должно быть достаточно контента или реиграбельности

Это особенно важно для маленьких учебных проектов. По требованиям платформы пользователь должен иметь возможность провести в игре хотя бы около десяти минут.

Но это не означает, что обязательно делать десятиминутную сюжетную кампанию. Яндекс учитывает и реиграбельность.

Например, короткая партия может быть нормальной, если каждый новый запуск отличается и у игрока есть причина попробовать снова: улучшить рекорд, получить другой уровень, столкнуться с новой комбинацией объектов или пройти игру эффективнее.

Шаг 2. Подключите SDK Яндекс Игр

SDK Яндекс Игр нужен не только для рекламы или сохранений. Его корректное подключение является обязательным требованием для публикации.

Через SDK игра может взаимодействовать с платформой: получать информацию об окружении, работать с рекламой, данными игрока, покупками и другими возможностями.

Подключаем SDK

Скрипт SDK должен быть загружен до вызова YaGames.init().

<!-- Yandex Games SDK -->

<script async src="/sdk.js" onload="initSDK()"></script>

<script>
async function initSDK() {
const ysdk = await YaGames.init();

// Игра подключена к платформе.

}
</script>

В реальном проекте удобнее встроить инициализацию в существующую точку запуска игры и сохранить объект ysdk, если он понадобится другим системам.

Сообщаем платформе, когда игра действительно готова

После загрузки всех необходимых ресурсов и появления возможности начать игру нужно вызвать Game Ready:

const ysdk = await YaGames.init();

// Загружаем необходимые ресурсы игры.
// Показываем главное меню.
// Всё готово для действий пользователя.

ysdk.features.LoadingAPI?.ready();

Важно вызвать метод не просто сразу после создания объекта SDK, а именно тогда, когда пользователь уже действительно может взаимодействовать с игрой и перед ним больше нет внутреннего экрана загрузки.

Это один из пунктов, который удобно проверять через debug-панель.

Размечаем начало и остановку геймплея

SDK также умеет получать информацию о том, когда пользователь непосредственно играет, а когда игровой процесс остановлен.

// Игрок начал или продолжил играть.

ysdk.features.GameplayAPI?.start();

// Например, игрок открыл меню,
// закончил уровень или игра поставлена на паузу.
ysdk.features.GameplayAPI?.stop();

Вызовы должны соответствовать реальному состоянию игры. Например, во время показа полноэкранной рекламы игровой процесс и звук тоже должны быть поставлены на паузу.

Что ещё даёт SDK

По мере развития проекта через SDK можно подключить:

• авторизацию через Яндекс ID;
• данные игрока;
• сохранения;
• рекламу;
• rewarded-рекламу;
• инап-покупки;
• язык и параметры окружения;
• другие возможности платформы.

Для первой публикации не обязательно использовать каждую функцию SDK. Главное — корректно встроить обязательные части и не добавлять ненужную сложность заранее.

Шаг 3. Создайте аккаунт разработчика

Следующий этап — Консоль Яндекс Игр. Через неё создаются черновики, загружаются сборки, заполняются карточки, запускается тестирование и отправляются обновления.

Лучше сразу использовать Яндекс ID, к которому у тебя будет постоянный доступ. Игра привязывается к аккаунту разработчика, с которого был создан её черновик, поэтому случайный временный аккаунт здесь не лучший выбор.

После создания аккаунта разработчика можно переходить к добавлению первой игры.

Шаг 4. Добавьте новую игру в Консоли

В Консоли разработчика создаётся новый черновик игры. После этого у проекта появляется собственный ID и набор полей для настройки.

Важно: если какая-то другая игра уже была опубликована через конкретный черновик, нельзя позже заменить её полностью новым проектом. Новые версии должны сохранять основную концепцию исходной игры.

Для новой игры создавай новый черновик.

Шаг 5. Заполните карточку игры

Черновик состоит из технических параметров и материалов, которые увидит пользователь каталога.

Среди основных полей есть:

• архив игры;
• поддерживаемые платформы;
• ориентация;
• языки;
• возрастной рейтинг;
• категории;
• название;
• описание;
• текст «Как играть»;
• иконка;
• обложка;
• скриншоты и другие промоматериалы.

Название

Название должно соответствовать самой игре и одинаково использоваться в интерфейсе и материалах для соответствующего языка.

Не стоит превращать название в список поисковых запросов. Это прежде всего название продукта, который пользователь должен запомнить.

Описание

Хорошее описание быстро отвечает на три вопроса:

1. Что это за игра?
2. Что в ней нужно делать?
3. Почему стоит попробовать именно её?

Например, вместо:

Крутая и увлекательная игра для всех любителей интересных игр.

лучше:

Проведи кота через постоянно меняющийся лабиринт, собирай ключи и найди выход раньше, чем закончится время. Каждый новый забег генерирует другой маршрут.

Второй вариант сообщает человеку конкретную механику.

Как играть

Этот текст должен соответствовать реальному управлению. Если на компьютере используются WASD, а на смартфоне — экранные кнопки, это лучше описать прямо.

Не заставляй пользователя гадать, каким образом разработчик предполагал управлять персонажем.

Категории и метаданные

Выбирай категории по реальному основному геймплею. Если это лабиринт с элементами головоломки, не стоит указывать «гонки» только потому, что кажется, будто там больше трафика.

Описание, жанр и сама игра должны соответствовать друг другу.

Как подготовить иконку, обложку и скриншоты

Карточка игры — первое, что увидит пользователь до запуска. Поэтому промоматериалы — это не формальность для прохождения модерации, а часть самого продукта.

Иконка

Для основной иконки документация Яндекс Игр сейчас указывает размер 512 × 512 пикселей и PNG.

Хорошая иконка обычно строится вокруг одного узнаваемого объекта: персонажа, машины, головоломки или основной механики. На маленьком размере десять персонажей, огромный логотип и пять строк текста превратятся в кашу.

Обложка

Для основной обложки используется изображение 800 × 470 пикселей в PNG.

Важный нюанс требований: в качестве иконки или обложки нельзя просто использовать скриншот из игры.

Обложка должна представлять игру как самостоятельный промоматериал: показывать её ключевую идею, персонажа или механику и при этом хорошо смотреться в каталоге.

Скриншоты

А вот скриншоты, наоборот, должны демонстрировать реальный геймплей. По требованиям платформы основную часть изображения должен занимать именно настоящий игровой процесс.

Я бы выбрал несколько кадров, которые показывают разные состояния игры:

• основную механику;
• интересный игровой момент;
• другой уровень или окружение;
• особенность, которая отличает проект от остальных.

Шаг 6. Загрузите ZIP-архив игры

Когда черновик создан, загрузите подготовленный ZIP в соответствующее поле.

Ещё раз проверь три вещи:

• распакованные файлы весят не больше 100 МБ;
• index.html лежит в корне;
• в названиях файлов и папок нет пробелов и кириллицы.

После загрузки не спеши нажимать кнопку модерации. Сначала открой именно загруженную платформой версию игры.

Локальная версия и сборка после загрузки — не всегда одно и то же. Например, ошибка в относительном пути может никак не проявляться на dev-сервере, но сломать изображения уже после публикации.

Шаг 7. Протестируйте игру в Консоли

Это один из самых полезных этапов всего процесса. Проверять нужно не только «открывается ли главный экран».

Проверьте desktop

Пройди основной сценарий игры с самого начала до завершения. Проверь:

• клавиатуру;
• мышь;
• перезапуск;
• паузу;
• изменение размера окна;
• все основные игровые механики.

Проверьте mobile

Если смартфоны заявлены в черновике, обязательно открой реальное мобильное устройство.

Эмуляция в DevTools полезна, но не всегда показывает проблемы с реальными касаниями, производительностью и системным интерфейсом.

Откройте DevTools Console

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

Проверьте потерю фокуса

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

Особенно важно проверять это вместе с рекламными сценариями: во время полноэкранной или rewarded-рекламы игра и её звук не должны продолжать жить своей жизнью за рекламным роликом.

Как пользоваться debug-панелью Яндекс Игр

У платформы есть собственная debug-панель для тестирования черновика. Я бы обязательно запускал её перед первой модерацией.

Она помогает увидеть состояние SDK и проверить сценарии, которые неудобно воспроизводить вручную.

Как включить debug-панель

Её можно открыть непосредственно из Консоли через команду «Открыть с debug-панелью».

Есть и вариант через параметр debug-mode=16 в адресе игры.

Проверяем Game Ready

Панель показывает, инициализирован ли SDK и был ли вызван LoadingAPI.ready().

Если SDK загрузился, но Game Ready так и не вызывается, это сразу видно. Намного удобнее обнаружить проблему здесь, чем получить её уже в результате модерации.

Проверяем локализацию

Debug-инструменты позволяют эмулировать другой язык. Если игра заявлена на нескольких языках, проверь, что интерфейс действительно переключается, а длинные переводы не ломают кнопки и меню.

Проверяем потерю фокуса и игровые состояния

Здесь же удобно проверять поведение игры при паузах, возврате пользователя, загрузке и других событиях платформы.

Шаг 8. Пройдите самопроверку перед модерацией

Перед отправкой Яндекс рекомендует самостоятельно проверить игру по требованиям платформы.

Я бы воспринимал этот этап как маленький pre-release review. Не «кажется, всё работает», а последовательная проверка самых частых точек отказа.

Шаг 9. Отправьте игру на модерацию

Когда черновик заполнен и тестирование закончено, его можно отправлять на модерацию.

После отправки игра получает статус ожидания проверки. По актуальной документации обычная модерация занимает примерно 3–5 рабочих дней.

Это ориентир, а не гарантия точного срока: время может зависеть от нагрузки и конкретного проекта.

Отсроченная публикация

Если не хочется, чтобы игра автоматически появилась в каталоге сразу после успешной проверки, можно заранее использовать отсроченную публикацию.

Тогда после одобрения проект будет ждать твоего решения о релизе.

Что произойдёт после проверки

Возможны два основных сценария.

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

Если найдены нарушения, черновик будет отклонён. Причины можно посмотреть и исправить, после чего новую версию снова отправляют на проверку.

Почему игру могут не принять в Яндекс Игры

Я бы не пытался угадать все возможные причины отказа. Требований много, и они меняются. Но есть несколько типов проблем, которые особенно полезно проверить самостоятельно.

Отдельно учитывай рейтинг после релиза: если он держится на уровне 30 и ниже в течение 3 недель, игру могут снять из публичного каталога. Поэтому после публикации важно не только выпускать обновления, но и быстро исправлять проблемы, которые бьют по оценкам игроков.

SDK подключён неправильно

Одна из очевидных ошибок — вызвать YaGames.init() раньше, чем загрузился /sdk.js, либо начать использовать ysdk раньше окончания инициализации.

Game Ready работает неправильно

Вызвать LoadingAPI.ready() просто «где-нибудь при старте» недостаточно. В этот момент игра должна действительно закончить загрузку и быть готовой к взаимодействию.

Игра выглядит незавершённой

Кнопки, которые ничего не делают, битые картинки, отсутствие важных текстов, тупики в прохождении и заметные технические заглушки создают ощущение сырой версии.

Даже beta-проект должен содержать достаточно игрового контента и не иметь очевидных недоделок, мешающих игре.

Слишком мало контента

Если весь проект заканчивается через три минуты и повторный запуск даёт абсолютно тот же опыт, это нужно исправлять ещё до модерации.

Можно добавить уровни, режимы, случайную генерацию, рекорды, достижения или другой естественный повод продолжать играть.

Проблемы с управлением

Особенно внимательно проверяй мобильное управление. Нельзя считать игру адаптированной под touch только потому, что браузер умеет эмулировать нажатие мышью.

Обложка и промоматериалы нарушают требования

Иконка и обложка не должны быть обычными скриншотами из игры. Скриншоты, наоборот, должны показывать настоящий геймплей.

В медиаматериалах также не стоит имитировать элементы интерфейса самой платформы: рейтинги, бейджи и системные элементы добавляются Яндексом самостоятельно.

Чек-лист перед отправкой игры на модерацию

Если не хочется перечитывать всю статью перед каждым обновлением, сохрани этот список.

Что происходит после прохождения модерации

После успешной модерации игра может появиться в каталоге автоматически либо ждать ручного релиза, если была включена отсроченная публикация.

Но публикация — это не финал разработки. Теперь появляется настоящая пользовательская среда: другие устройства, разные разрешения, неожиданные способы управления и люди, которые не знают ни одного твоего дизайнерского решения.

После релиза стоит следить за поведением пользователей и постепенно улучшать проект.

Как обновлять опубликованную игру

Для обновления создаётся новая версия черновика, загружается изменённый архив и снова запускается модерация.

Пока новая версия проверяется, пользователи продолжают видеть предыдущую опубликованную сборку.

Это удобно: не нужно снимать работающую игру с публикации только потому, что готовится обновление.

Можно ли зарабатывать на игре в Яндекс Играх

Да. Платформа предоставляет инструменты монетизации, включая рекламные форматы и внутриигровые покупки.

Но я бы не начинал первую игру с вопроса «куда поставить десять рекламных блоков». Сначала полезнее добиться нормального игрового цикла:

пользователь запускает игру → понимает механику → продолжает играть → возвращается.

Монетизация имеет смысл только поверх продукта, который человеку вообще хочется открыть второй раз.

Можно ли создать игру через ChatGPT и загрузить её в Яндекс Игры

Да. ChatGPT, Claude и другие модели можно использовать во время разработки: придумать механику, получить первый HTML/JavaScript-каркас, разобрать ошибку, написать функцию или помочь подключить SDK.

Например, путь может выглядеть так:

ChatGPT может написать HTML, CSS и JavaScript

Для маленькой браузерной игры этого иногда достаточно, чтобы очень быстро получить первый прототип.

Например, можно попросить:

Сделай простую браузерную игру на HTML, CSS и JavaScript: игрок должен собирать падающие монеты за 60 секунд. Не используй внешние библиотеки. Раздели код на index.html, style.css и game.js.

После этого код можно сохранить в файлы и открыть в браузере.

Но работающий на первый взгляд прототип ещё не является готовой игрой для каталога.

Сгенерированную игру всё равно нужно тестировать вручную

Нейросеть может оставить ошибку в обработке событий, неправильно поставить паузу, создать сломанный touch-контрол или подключить устаревший пример API.

Поэтому AI-generated проект проходит абсолютно тот же путь:

идея

↓
сгенерированный код
↓
ручное тестирование
↓
доработка
↓
SDK Яндекс Игр
↓
ZIP
↓
тестирование в Консоли
↓
модерация

Важно: интерактивный ИИ внутри самой игры запрещён

В актуальных требованиях Яндекс Игр отдельно указано, что в опубликованных играх запрещён интерактивный искусственный интеллект.

При этом допускается использовать контент, который был сгенерирован с помощью ИИ заранее.

То есть использование ChatGPT как инструмента разработчика — это не то же самое, что встроить в игру живой AI-чат, который генерирует ответы пользователю во время игрового процесса.

Как добавить игру в Яндекс Игры, если она сделана на Phaser

Принцип тот же. Phaser в конечном счёте создаёт браузерную игру, поэтому платформе нужна готовая web-сборка.

Общая последовательность:

Phaser-проект

↓
production build
↓
index.html + JS + assets
↓
SDK Яндекс Игр
↓
тестирование
↓
ZIP
↓
Консоль Яндекс Игр

Важнее конкретного фреймворка то, что лежит внутри финального архива и как эта сборка ведёт себя на платформе.

Можно ли загрузить игру из Unity, Godot, Construct или GDevelop

Можно, если движок позволяет собрать проект для Web.

Здесь меняется процесс получения web-build, но не основная логика публикации:

проект движка

↓
Web export
↓
интеграция SDK
↓
проверка файлов
↓
ZIP
↓
Консоль
↓
модерация

Для популярных движков также существуют готовые способы и плагины интеграции с SDK. Перед публикацией лучше сверяться с актуальной документацией именно для используемого движка.

Частые вопросы

Как выложить свою игру в Яндекс Игры?

Подготовьте браузерную сборку, подключите SDK Яндекс Игр, упакуйте файлы в ZIP с index.html в корне, создайте черновик в Консоли разработчика, заполните карточку, протестируйте игру и отправьте её на модерацию.

Как загрузить игру в Яндекс Игры?

Игра загружается через Консоль разработчика в виде ZIP-архива. В корне архива должен находиться index.html, а распакованная сборка не должна превышать установленный платформой лимит.

Как добавить свою игру в Яндекс Игры?

Создайте аккаунт разработчика, нажмите добавление новой игры в Консоли и заполните появившийся черновик. После загрузки web-сборки и материалов игру можно протестировать и отправить на модерацию.

Нужно ли платить за публикацию?

Нет. Яндекс Игры позиционируются как бесплатная платформа для размещения браузерных игр.

Сколько времени занимает модерация?

В актуальной документации указан обычный срок примерно 3–5 рабочих дней. Фактическое время может отличаться.

Какой максимальный размер игры?

Файлы игры в распакованном виде должны занимать не более 100 МБ.

Обязательно ли подключать SDK Яндекс Игр?

Да. Корректная интеграция SDK является одним из технических требований для прохождения модерации и публикации.

Можно ли выложить игру на чистом HTML и JavaScript?

Да. Игровой движок не обязателен. Если проект запускается как браузерное приложение, соответствует требованиям и интегрирован с SDK, его можно подготовить к публикации.

Можно ли создать игру через ChatGPT и выложить её?

Да. ИИ можно использовать как инструмент во время разработки. Но полученный код нужно самостоятельно протестировать, подключить SDK и привести игру в соответствие требованиям платформы.

Что делать, если игру отклонили?

Посмотрите причины отказа, исправьте указанные проблемы, протестируйте новую сборку и отправьте обновлённый черновик на модерацию ещё раз.

Первый отказ — нормальная часть процесса. Гораздо полезнее рассматривать модерацию как ещё один набор тестов продукта, а не как экзамен, который можно сдать только один раз.

Что делать дальше

Самая сложная часть первой публикации обычно не ZIP, SDK или Консоль. Сложнее дойти до состояния, когда маленькая учебная механика превращается в игру, которую не стыдно дать незнакомому человеку.

Поэтому если своей игры пока нет, не начинай с кабинета разработчика. Сначала сделай очень маленький законченный проект: кликер, головоломку, лабиринт, простую аркаду.

Потом добавь меню, понятное управление, победу, проигрыш и перезапуск. И только после этого пройди путь из этой статьи.

А если сначала хочется разобраться, как вообще устроены современные браузерные игры и на каких технологиях их делают, начни с материала «HTML5-игры: что это, на чём их делают и как создать свою игру» .

Книга по JavaScript для начинающих

«JavaScript с нуля: учимся программировать, создавая игры»

Пошаговый формат с маленькими практическими задачами: от базового синтаксиса до первых игровых механик без перегруза теорией.

Читать книгу на ЛитРес →