Делаем первую игру

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

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

Выбор идеи

Хорошая первая игра выглядит так:

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

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

Плохие идеи для первой игры: платформер с уровнями, что-либо с сохранением сложного прогресса, многопользовательская игра, всё со словом «ролевая».

Два пути: с готовым файлом и без

Дальше всё зависит от того, есть ли у вас файл инструкций.

Если файл есть

Файл инструкций для Claude Code — это готовый набор правил, шаблонов и проверок, собранный специально под разработку игр для Яндекс Игр. В нём уже описано то, что иначе вы будете объяснять нейросети сами и по частям: структура проекта, правила работы с SDK, порядок инициализации, ограничения архива, список причин отказа модерации и чек-лист перед отправкой.

Пользоваться им просто: положите файл в папку проекта и напишите Claude Code:

Прочти файл INSTRUCTIONS.md целиком и дальше работай строго по нему.
Если моя просьба будет противоречить этому файлу — скажи мне об этом,
а не выполняй молча.

Всё. Дальше можно ставить задачи по игре, не повторяя правила платформы: они уже учтены. Вторая фраза в запросе важна не меньше первой — она превращает файл из пожелания в правило, которое нельзя тихо нарушить.

Если файла нет

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

Порядок такой:

1. Начните с CLAUDE.md из предыдущей главы — там уже есть основа.
2. Каждый раз, когда получаете не то, что хотели, не ограничивайтесь исправлением. Спросите себя: «какое правило я не сформулировал?» — и допишите его в CLAUDE.md.
3. Раз в несколько дней перечитывайте файл и убирайте из него противоречия.

Через две-три игры у вас будет собственный свод правил. Разница между путями не в результате, а в том, сколько ошибок вы соберёте по дороге.

Порядок работы

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

Слой 1. Каркас. Пустая страница, которая открывается и занимает весь экран.

Слой 2. Механика. Самое главное действие игры — и больше ничего. Никаких меню, очков и красоты.

Слой 3. Правила. Победа, поражение, очки, конец раунда.

Слой 4. Оболочка. Стартовый экран, кнопка «Играть», экран результата, звук.

Слой 5. Платформа. Подключение SDK, реакция на паузу, сохранение результата.

Слой 6. Отделка. Внешний вид, анимации, мелочи.

Между слоями сохраняйтесь: git add -A и git commit -m "что сделано". Сломается — вернётесь.

Как ставить задачу

Плохо:

Сделай игру три в ряд

Хорошо:

Сделай поле 6 на 6 клеток по центру экрана. В каждой клетке — круг
одного из четырёх цветов, цвета расставлены случайно.
Клик по кругу выделяет его, клик по соседнему меняет их местами.
Пока ничего больше: ни очков, ни проверки совпадений.
Поле должно занимать не больше 80% высоты экрана на телефоне.

Разница в трёх вещах: сказано, что именно сделать, сказано, чего не делать, и названо ограничение, которое иначе всплывёт позже.

Дальше — по одному шагу:

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

Проверка на каждом шаге

В браузере. Откройте index.html двойным щелчком. Работает — идём дальше.

В консоли браузера. Нажмите F12, вкладка Console. Красных сообщений быть не должно. Ошибки в консоли — одна из причин отказа модерации, и лучше замечать их сразу, а не в конце.

На телефоне. Уменьшите окно браузера до узкого — так вы увидите примерно то же, что увидит игрок с телефона. Большинство игроков на Яндекс Играх именно с телефонов, поэтому если игра неудобна на узком экране, всё остальное неважно.

Найденное описывайте точно:

На узком экране нижний ряд клеток уходит за границу и до него
не дотянуться. На широком всё в порядке.

Подключение SDK

Когда игра играется, добавляем платформу. Это отдельный шаг, и торопиться с ним не надо.

Подключи Yandex Games SDK: скрипт /sdk.js в head, инициализация
через YaGames.init(). Когда игра загрузилась и в неё можно играть —
вызови ysdk.features.LoadingAPI.ready().
Подпишись на события game_api_pause и game_api_resume: на паузе
останавливай игровой цикл и выключай звук, на возобновлении возвращай.

Важная особенность: локально SDK не работает. Если открыть index.html двойным щелчком, рядом нет платформы, с которой скрипт должен связаться, и в консоли будет ошибка. Это нормально и не означает, что вы что-то сделали не так. Проверить работу SDK можно только после загрузки в Консоль — там есть режим черновика и отладочная панель.

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

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

Сборка архива

Когда готово, собираем то, что загрузим в Консоль.

Требования жёсткие и простые:

Самая частая ошибка новичка — заархивировать саму папку. Тогда внутри архива получается my-game/index.html, а платформа ищет index.html в корне и архив не принимает. Выделяйте содержимое папки, а не папку.

Попросить собрать можно и Claude Code:

Проверь проект перед сборкой: index.html в корне, в именах файлов
нет пробелов и кириллицы, в консоли нет ошибок. Потом собери
архив game.zip из содержимого папки, без папки верхнего уровня.

Типичные ошибки первой игры

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

При долгом нажатии выделяется текст или выскакивает меню браузера. Это прямая причина отказа модерации — и, кстати, ровно та, по которой чаще всего заворачивают. Скажите: «запрети выделение текста и контекстное меню внутри игрового поля».

Музыка играет поверх рекламы. Значит, не обработаны события паузы.

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

Игра «зависает» после сворачивания вкладки. Игровой цикл нужно останавливать, когда вкладка неактивна.

Короткий чек-лист

• Идея маленькая: одна механика, раунд меньше минуты
• Игра построена слоями, между слоями есть сохранения в git
• Открывается в браузере, в консоли нет красных ошибок
• Удобна на узком экране
• Подключён SDK, игра работает и без него
• Нет выделения текста и контекстного меню внутри игры
• Прогресс сохраняется
• Собран ZIP с index.html в корне, латиница в именах, меньше 100 МБ

Что дальше

Игра есть, архив собран. Прежде чем идти в Консоль, покажу инструмент, который сильно облегчает работу с файлами, — расширение Claude Code для редактора кода.