---
title: "Гра показує білий екран на klyo games: як це виправити"
description: "Білий чи чорний екран у попередньому перегляді: зазвичай бракує файлу, хибний шлях або заблокований скрипт. Знайди причину в студії й швидко виправ."
url: https://games.klyo.pl/uk/support/white-screen/
canonical: https://games.klyo.pl/uk/support/white-screen/
type: instrukcja
language: uk
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-10-20
llms: https://games.klyo.pl/llms.txt
---

# Гра показує білий екран: як це виправити

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

## Перш ніж почати

- Гру завантажено в студію за адресою 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/uk/support/publish-html5-game/)
- [Як випустити нову версію гри й повернутися до попередньої](https://games.klyo.pl/uk/support/release-new-version/)
- [Як додати таблицю рекордів до гри HTML5](https://games.klyo.pl/uk/support/add-leaderboard/)
- [ШІ-асистент грає в твою гру: як йому дозволити](https://games.klyo.pl/uk/support/assistant-plays-your-game/)
- [Усі інструкції](https://games.klyo.pl/uk/support/)

Досі щось не працює? Напиши на [kontakt@klyo.pl](mailto:kontakt@klyo.pl) і вкажи адресу гри. Відповідає людина, протягом двох робочих днів.

---

Źródło: https://games.klyo.pl/uk/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