---
title: "Игра показывает белый экран на klyo games: как это исправить"
description: "Белый или чёрный экран в предпросмотре значит, что не хватает файла, путь указан неверно или скрипт заблокирован. Найди причину в студии и исправь её."
url: https://games.klyo.pl/ru/support/white-screen/
canonical: https://games.klyo.pl/ru/support/white-screen/
type: instrukcja
language: ru
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-11-10
llms: https://games.klyo.pl/llms.txt
---

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

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

- 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, он читает ту же диагностику, недостающие файлы и ошибки браузера и может исправить файлы в черновой версии, которую ты потом сам проверишь и выпустишь.

## Похожие инструкции

- [Как опубликовать HTML5-игру на klyo games](https://games.klyo.pl/ru/support/publish-html5-game/)
- [Как выпустить новую версию игры и вернуться к предыдущей](https://games.klyo.pl/ru/support/release-new-version/)
- [Как добавить таблицу рекордов в игру на HTML5](https://games.klyo.pl/ru/support/add-leaderboard/)
- [ИИ-ассистент играет в твою игру: как дать ему доступ](https://games.klyo.pl/ru/support/assistant-plays-your-game/)
- [Все инструкции](https://games.klyo.pl/ru/support/)

Всё ещё не работает? Напиши на [kontakt@klyo.pl](mailto:kontakt@klyo.pl) и пришли ссылку на игру. Ответит человек в течение двух рабочих дней.

---

Źródło: https://games.klyo.pl/ru/support/white-screen/ · Autor: klyo, polska firma technologiczna (Łódź, klienci w całej Polsce) · Kontakt: kontakt@klyo.pl · Indeks dla modeli językowych: https://games.klyo.pl/llms.txt