Чек-лист проверки браузерной 2D-игры перед показом: 10 пунктов

Коротко

Перед показом браузерной 2D-игры хватает 10 проверок примерно на 1 час: от запуска с локального сервера до первого игрока, которому ничего не объясняют. Пункты отвечают на вопрос «можно показывать или нет», а искать причину сбоя — уже работа отладки и профайлера. Часть пунктов автоматизируется: прогон минуты игры в Node.js ловит утечку объектов и подписок до того, как её заметит зритель.

Содержание

  1. Чек-лист: 10 пунктов и критерий «готово»
  2. Пункты 1–2: сервер и чистая загрузка
  3. Пункты 3–4: звук и скрытая вкладка
  4. Пункты 5–7: экраны, управление, сохранение
  5. Пункты 8–9: кадр и перезапуски
  6. Пункт 10: первый игрок без подсказок
  7. Код на JavaScript: автоматическая часть
  8. Практический сценарий: час до показа на джеме
  9. Когда вам это не подойдёт

Чек-лист: 10 пунктов и критерий «готово»

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

№Что проверитьКакГотово, если
1Запуск с сервераpython3 -m http.server 8000 или npx serve в папке игрыигра открывается по http://localhost:8000
2Чистая загрузкаDevTools → Network, флажок Disable cache, перезагрузка0 красных строк в консоли, 0 ответов 404
3Звукпервое нажатие «Играть»звук есть с первого действия
4Скрытая вкладкапереключиться на другую вкладку на 10 секундигра на паузе, звук стих, игрок жив
5Три экрана1280×720, 844×390, 390×844 и поворотHUD на месте, картинка не размыта
6Управлениерусская раскладка, геймпад, касаниевсе действия работают на каждом устройстве
7Сохранениеперезагрузка страницы посреди уровняпрогресс на месте
8Кадр на слабой машинезамедление CPU в 4 разане больше 1% кадров длиннее 16,67 мс
9Перезапуски10 раз «заново» и 1 минута игрычисло объектов и подписок не растёт
10Первый игрок3 человека, 5 минут молчакаждый понял цель без слов

Пункты 1–2: сервер и чистая загрузка

Игру проверяют с локального сервера, потому что страница, открытая как файл, ведёт себя не как на хостинге. По MDN Firefox и Chrome считают локальные файлы непрозрачным источником, и загрузка соседних файлов через fetch из file:// падает с ошибкой CORS; MDN прямо советует для проверки поднять локальный сервер. Обратная ловушка тоже бывает: в одних браузерах с диска что-то работает, а на хостинге — нет.

Чистая загрузка — это первый запуск глазами нового игрока, без файлов в кэше. В DevTools на вкладке Network включите Disable cache и перезагрузите страницу. Готово, если в консоли нет красных строк, а в списке запросов нет ответов 404: чаще всего это файл, названный Hero.png, а в коде — hero.png. Windows и macOS по умолчанию находят такой файл без учёта регистра, а сервер, различающий регистр, — нет; так это описывает и документация itch.io. Как сделать честный экран загрузки, — в статье про загрузку ресурсов.

Пункты 3–4: звук и скрытая вкладка

Звук должен появиться с первого действия игрока, а не при загрузке страницы. По MDN браузеры разрешают автоматическое воспроизведение со звуком, только если пользователь уже взаимодействовал с сайтом (клик, касание, клавиша), звук выключен или сайт в списке разрешённых. Поэтому звук запускают в обработчике кнопки «Играть»; как устроен звуковой движок с шинами и голосами — в статье про Web Audio API.

Скрытая вкладка проверяется так: начните уровень, переключитесь на другую вкладку на 10 секунд и вернитесь. Готово, если игра стоит на паузе, звук стих, а герой не погиб, пока вас не было. Сигнал для паузы — событие visibilitychange и document.hidden; оно же — хороший момент для сохранения.

Пункты 5–7: экраны, управление, сохранение

Три размера окна ловят большинство ошибок раскладки: ноутбук 1280×720, телефон в альбомной ориентации 844×390 и в портретной 390×844. В DevTools это режим эмуляции устройства. Готово, если счётчик очков и кнопки не уехали за край и не спрятались под вырез, пиксель-арт не размыт, а после поворота игра пересчитала размер. Подробно — в статьях про HUD, пиксель-арт и сегодняшней дневной статье про ориентацию экрана.

Управление проверяют в русской раскладке, с геймпадом и касанием. Самая частая ошибка — проверка event.key === 'w': в русской раскладке эта клавиша даёт «ц», и герой стоит. Готово, если каждое действие из меню управления срабатывает на каждом устройстве, которое вы обещаете.

Сохранение проверяют перезагрузкой посреди уровня. Готово, если после F5 прогресс на месте, а в приватном окне игра хотя бы не падает при пустом хранилище.

Пункты 8–9: кадр и перезапуски

Кадр проверяют на замедленной машине: в панели Performance включите замедление CPU в 4 раза и сыграйте трудный участок. При 60 кадрах в секунду бюджет кадра — 1000 / 60 ≈ 16,67 мс. Наш порог для показа — не больше 1% кадров длиннее бюджета; если больше, причину ищут по методике статьи про просадки FPS, а не на глаз.

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

Пункт 10: первый игрок без подсказок

Последний пункт проверяет не код, а понятность: 3 человека, которые игру не видели, играют 5 минут, а вы молчите. Запишите для каждого, через сколько секунд он понял цель, где застрял и что нажимал зря. Готово, если все трое поняли цель без слов. Если нет — помогает структура уровня, где механика сначала показана безопасно, — она разобрана в утренней статье про кисётэнкэцу.

Код на JavaScript: автоматическая часть

Код прогоняет 1 минуту учебной игры (3600 кадров по 1/60 секунды) с записанным вводом и проверяет 6 признаков: числа конечны, игрок в границах поля, два прогона с одним зерном совпадают, объектов не больше 200, сохранение читается обратно, а после 10 перезапусков подписчик ровно один. Игра содержит две спрятанные ошибки под флагом leak: пули за экраном не удаляются и подписка не снимается при выходе из сцены. Код запускается в Node.js 24 (как модуль .mjs), вывод совпадает с комментарием после кода.

// Генератор случайных чисел с зерном: один и тот же прогон при каждом запуске
function rng(seed) {
  let a = seed >>> 0;
  return () => { a = (a + 0x6d2b79f5) >>> 0; let t = a; t = Math.imul(t ^ (t >>> 15), t | 1); t ^= t + Math.imul(t ^ (t >>> 7), t | 61); return ((t ^ (t >>> 14)) >>> 0) / 4294967296; };
}

// Учебная игра: игрок стреляет вверх, монеты падают сверху. Ошибка спрятана в флаге leak
function createGame({ seed = 1, leak = false } = {}) {
  const rand = rng(seed);
  const W = 320, H = 180;
  const st = { player: { x: 160, y: 160 }, bullets: [], coins: [], score: 0, t: 0 };
  const listeners = [];
  return {
    W, H, st, listeners,
    start() { listeners.push(() => {}); },          // подписка на ввод при входе в сцену
    stop() { if (!leak) listeners.length = 0; },     // утечка: забыли отписаться
    step(dt, input) {
      st.t += dt;
      st.player.x = Math.min(W - 8, Math.max(8, st.player.x + input.dx * 120 * dt));
      if (input.fire) st.bullets.push({ x: st.player.x, y: st.player.y });
      if (rand() < 0.05) st.coins.push({ x: 8 + rand() * (W - 16), y: 0 });
      for (const b of st.bullets) b.y -= 240 * dt;
      for (const c of st.coins) c.y += 60 * dt;
      if (!leak) st.bullets = st.bullets.filter((b) => b.y > -8); // утечка: пули за экраном не удаляются
      st.coins = st.coins.filter((c) => {
        if (Math.abs(c.x - st.player.x) < 10 && Math.abs(c.y - st.player.y) < 10) { st.score += 10; return false; }
        return c.y < H + 8;
      });
    },
    save() { return JSON.stringify({ x: st.player.x, score: st.score }); },
    load(json) { const d = JSON.parse(json); st.player.x = d.x; st.score = d.score; },
  };
}

// Автоматическая часть чек-листа: 5 проверок без браузера
function smoke(make) {
  const dt = 1 / 60, frames = 60 * 60; // 1 минута игры
  const input = (i) => ({ dx: Math.sin(i / 50), fire: i % 10 === 0 });
  const run = (g) => { g.start(); for (let i = 0; i < frames; i++) g.step(dt, input(i)); return g; };
  const a = run(make()), b = run(make());
  const res = {};
  res.finite = [a.st.player.x, a.st.player.y, ...a.st.bullets.map((x) => x.y)].every(Number.isFinite);
  res.bounds = a.st.player.x >= 8 && a.st.player.x <= a.W - 8;
  res.repeat = a.st.score === b.st.score && a.st.coins.length === b.st.coins.length;
  res.objects = a.st.bullets.length + a.st.coins.length <= 200;
  const saved = a.save(); const c = make(); c.load(saved);
  res.saveLoad = c.save() === saved;
  for (let i = 0; i < 10; i++) { a.stop(); a.start(); } // 10 перезапусков сцены
  res.restart = a.listeners.length === 1;
  return { res, score: a.st.score, objects: a.st.bullets.length + a.st.coins.length, listeners: a.listeners.length };
}

const report = (name, r) => console.log(name, Object.entries(r.res).filter(([, v]) => !v).map(([k]) => k).join(',') || 'PASS', r.score, r.objects, r.listeners);
report('с ошибками:', smoke(() => createGame({ seed: 42, leak: true })));
report('исправлено:', smoke(() => createGame({ seed: 42 })));

Ожидаемый вывод программы (имя прогона, проваленные проверки, очки, объекты на сцене, подписчики):

с ошибками: objects,restart 200 363 11
исправлено: PASS 200 7 1

С ошибками прогон провалил две проверки: на сцене 363 объекта вместо 7 и 11 подписчиков вместо 1 — по подписчику на каждый перезапуск. Очки совпали, то есть игра «работает», и без счёта объектов ошибку легко не заметить. Чтобы подключить прогон к своей игре, нужно отделить логику от отрисовки: функция step(dt, input) не должна трогать canvas и document.

Практический сценарий: час до показа на джеме

Возьмём джем: через час показ, игра — аркада со сбором монет, проверяющий — один автор. Распределение времени:

  1. 5 минут — автоматика. Прогон smoke из кода выше. Провалы чинятся первыми: утечка объектов к концу показа превратится в просадку кадра.
  2. 10 минут — пункты 1–2. Локальный сервер, Disable cache, консоль и 404.
  3. 10 минут — пункты 3–4. Звук по первому нажатию, вкладка на 10 секунд.
  4. 15 минут — пункты 5–7. Три размера окна, русская раскладка и геймпад, F5 посреди уровня.
  5. 5 минут — пункт 8. Замедление CPU в 4 раза на самом насыщенном участке.
  6. 15 минут — пункт 10. Три соседа по столу, по 5 минут каждый, вы молчите и записываете.

Если на всё не хватает времени, порядок важности такой: 2, 10, 3, 4. Ошибка в консоли или игрок, не понявший цель, видны зрителю сразу; кадр при замедлении CPU — нет.

Когда вам это не подойдёт

Этот чек-лист рассчитан на показ небольшой браузерной игры, а не на выпуск продукта:

  • Выпуск в магазин или на площадку с модерацией. Там свои требования: возрастная маркировка, политика данных, размеры обложек. Список нужно расширять под площадку.
  • Сетевая игра. Задержка сети, обрыв соединения и два игрока в одной комнате требуют отдельных проверок с сервером.
  • Логика не отделена от отрисовки. Автоматическая часть тогда не запустится в Node.js; сначала вынесите step и save в модуль без canvas и document или проверяйте пункт 9 руками в панели Memory.
  • Нужна статистика, а не впечатление. Три игрока покажут грубые ошибки понятности; чтобы сравнить два варианта уровня, нужны десятки прохождений и запись времени.

Мы разрабатываем J2DRU — браузерный 2D игровой движок, где логика собирается из событий, условий и действий, а проект можно углублять на TypeScript. Движок в разработке и публично пока не открыт, заявку можно оставить на странице раннего доступа (подача заявки не гарантирует приглашение).

Источники (проверено: 09.11.2026): MDN — Reason: CORS request not HTTP (локальные файлы — непрозрачный источник в Firefox и Chrome, совет поднять локальный сервер); MDN — Autoplay guide for media and Web Audio APIs (условия автоматического воспроизведения); MDN — Document: visibilitychange event; itch.io — Uploading HTML5 games (раздел Common Pitfalls: регистр имён файлов на сервере и в Windows и macOS). Пороги в таблице (1% кадров, 3 игрока, 5 минут, 200 объектов), учебная игра и вывод — наш ориентир и наш прогон в Node.js 24.

Читайте также:

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

Почему игра работает с диска, а у друга по ссылке — нет, или наоборот?

Страница, открытая как файл (file://), по правилам браузера не может загружать соседние файлы через fetch: Firefox и Chrome считают локальные файлы непрозрачным источником, и запрос падает с ошибкой CORS. Проверяйте игру через локальный сервер — тогда условия ближе к хостингу.

Почему в игре нет звука до первого нажатия?

Браузеры блокируют автоматическое воспроизведение звука, пока пользователь не взаимодействовал со страницей. Звук нужно запускать в обработчике первого нажатия или клика — например, кнопки «Играть».

Можно ли проверить игру автоматически без браузера?

Логику — да: если игра отделена от отрисовки, её можно прогнать в Node.js с записанным вводом и зерном случайности и проверить, что числа конечны, объекты не копятся, сохранение читается, а перезапуск не плодит подписки. Звук, экран и ощущения проверяются только руками.

Сколько людей нужно для первой проверки?

Для показа хватит 3 человек, которые игру не видели. Главное — молча наблюдать первые 5 минут и записывать, где игрок застрял, а не объяснять правила.