Twoja gra
Gra pokazuje białe okno: jak to naprawić
Naciśnij „Pokaż, co się stało” w podglądzie studia. Zobaczysz pliki, o które gra prosiła i których nie dostała, oraz błędy, które rzuciła. Najczęściej winne są wielkie litery w nazwach plików, ścieżki bezwzględne albo skrypty z cudzego serwera.
Zanim zaczniesz
- Gra jest wgrana do studia pod adresem dev.klyo.pl; wystarczy paczka, która czeka jeszcze na opis.
- Oryginalne pliki na twoim komputerze, żeby je poprawić i wgrać ponownie.
Krok po kroku
Otwórz diagnozę
W podglądzie naciśnij Pokaż, co się stało. Zobaczysz brakujące pliki i błędy z przeglądarki w kolejności, w jakiej wystąpiły. Tę samą listę dostaje twój asystent AI z narzędzia diagnozy.
Sprawdź nazwy plików litera po literze
Nasz serwer rozróżnia wielkie litery: Player.png i player.png to dwa różne pliki. Gra działająca na Windowsie albo macOS może tu nie znaleźć plików, więc nazwy w kodzie muszą dokładnie zgadzać się z plikami.
Używaj ścieżek względnych
Wczytuj pliki jako assets/hero.png, a nie /assets/hero.png, C:\ czy file:///. Plik index.html trzymaj w głównym katalogu ZIP-a, nie w podfolderze.
Trzymaj wszystko w paczce
Gra na klyo wczytuje własne pliki. Biblioteka, krój pisma albo skrypt z cudzego serwera może się nie wczytać, a kod wysyłający dane poza klyo nie przechodzi sprawdzenia. Wrzuć taki plik do ZIP-a.
Gry z silników eksportuj do ZIP-a
GameMaker, Unity i Godot tworzą część nazw plików w trakcie działania gry, więc przeniesienie takiej gry z adresu może ich nie znaleźć. Wyeksportuj grę do ZIP-a w swoim silniku i wgraj cały folder.
Przetestuj, zanim wgrasz ponownie
Na swoim komputerze uruchom
node klyo-test.mjs http://localhost:8080/ moja-gra ./klyo-test. Mierzy grę tak jak my przy wydaniu, z tymi samymi progami, i pokazuje, co zobaczy gracz.
Jeśli coś nie działa
Ekran długo zostaje pusty
Pierwsza klatka powinna pojawić się w 20 sekund, a pierwsze pobranie na telefonie zmieścić się w 20 MB. Duże pliki wczytuj później, gdy menu jest już na ekranie.
Nie ma dźwięku
Przeglądarki włączają dźwięk dopiero po pierwszym dotknięciu albo kliknięciu. Wznawiaj dźwięk w geście gracza, także po powrocie gry z tła na iPhonie.
Nic z listy tego nie wyjaśnia
Naciśnij Porozmawiaj z nami w studiu i wyślij adres gry ze zrzutem ekranu. Przeczyta to człowiek.
Częste pytania
Dlaczego gra działa u mnie, a na klyo nie?
Zwykle przez wielkie litery w nazwach plików, ścieżki bezwzględne albo pliki z cudzego serwera. Komputer lokalny to wybacza, serwer w sieci już nie.
Czy asystent AI znajdzie przyczynę?
Tak. Podłączony przez serwer MCP klyo czyta tę samą diagnozę, brakujące pliki i błędy z przeglądarki, i może poprawić pliki w wersji roboczej, którą potem sam sprawdzasz i wydajesz.