Перейти к содержимому
klyogames

Твоя игра

Игра показывает белый экран: как это исправить

Нажми «Показать, что случилось» в предпросмотре студии. Ты увидишь файлы, которые игра запросила, но не получила, и ошибки, которые она выдала. Чаще всего виноваты заглавные буквы в именах файлов, абсолютные пути или скрипты с чужого сервера.

  • 2 мин чтения
  • Шаги: 6
На этой странице

Прежде чем начать

  • Игра загружена в студию на dev.klyo.pl. Подойдёт и пакет, который ещё ждёт описания.
  • Исходные файлы на твоём компьютере, чтобы исправить их и загрузить заново.

Шаг за шагом

  1. Открой диагностику

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

  2. Проверь имена файлов по буквам

    Наш сервер различает заглавные и строчные буквы: Player.png и player.png здесь два разных файла. Игра, которая работает на Windows или macOS, может не найти тут свои файлы, поэтому имена в коде должны точно совпадать с именами файлов.

  3. Используй относительные пути

    Загружай файлы как assets/hero.png, а не /assets/hero.png, C:\ или file:///. Файл index.html держи в корне ZIP-архива, а не во вложенной папке.

  4. Держи все файлы в пакете игры

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

  5. Игры на движках экспортируй в ZIP

    GameMaker, Unity и Godot собирают часть имён файлов прямо во время игры, поэтому при переносе такой игры по адресу эти файлы могут не найтись. Экспортируй игру в ZIP в своём движке и загрузи всю папку.

  6. Проверь игру перед повторной загрузкой

    На своём компьютере запусти node klyo-test.mjs http://localhost:8080/ my-game ./klyo-test. Скрипт проверяет игру так же, как мы при выпуске, с теми же порогами, и показывает, что увидит игрок.

Если что-то не работает

Экран долго остаётся пустым

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

Нет звука

Браузеры включают звук только после первого касания или клика. Возобновляй звук по действию игрока, в том числе когда игра возвращается из фона на iPhone.

Ничего из списка не подходит

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

Почему игра работает у меня, а на klyo нет?

Обычно из-за заглавных букв в именах файлов, абсолютных путей или файлов с чужого сервера. Локальный компьютер такое прощает, а сервер в интернете нет.

Найдёт ли причину ИИ-ассистент?

Да. Если подключить его через сервер MCP klyo, он читает ту же диагностику, недостающие файлы и ошибки браузера и может исправить файлы в черновой версии, которую ты потом сам проверишь и выпустишь.