Dein Spiel
Spiel zeigt einen weißen Bildschirm: so behebst du es
Klicke in der Studio-Vorschau auf „Zeigen, was passiert ist“. Du siehst die Dateien, die das Spiel angefordert, aber nicht bekommen hat, und die Fehler, die es ausgelöst hat. Meist sind Großbuchstaben in Dateinamen, absolute Pfade oder Skripte von fremden Servern schuld.
Bevor du loslegst
- Das Spiel ist im Studio unter dev.klyo.pl hochgeladen. Ein Paket, das noch auf seine Beschreibung wartet, reicht.
- Die Originaldateien auf deinem Computer, damit du sie korrigieren und erneut hochladen kannst.
Schritt für Schritt
Diagnose öffnen
Klicke in der Vorschau auf Zeigen, was passiert ist. Du siehst fehlende Dateien und Browserfehler in der Reihenfolge, in der sie aufgetreten sind. Dieselbe Liste bekommt dein KI-Assistent über das Diagnose-Tool.
Dateinamen Buchstabe für Buchstabe prüfen
Unser Server unterscheidet Groß- und Kleinschreibung: Player.png und player.png sind zwei verschiedene Dateien. Ein Spiel, das unter Windows oder macOS läuft, findet hier womöglich Dateien nicht. Die Namen im Code müssen also exakt mit den Dateien übereinstimmen.
Relative Pfade verwenden
Lade Dateien als assets/hero.png, nicht als /assets/hero.png, C:\ oder file:///. Lege die index.html ins Hauptverzeichnis des ZIP-Archivs, nicht in einen Unterordner.
Alle Dateien ins Paket packen
Ein Spiel auf klyo lädt seine eigenen Dateien. Eine Bibliothek, Schrift oder ein Skript von einem fremden Server wird eventuell nicht geladen, und Code, der Daten außerhalb von klyo sendet, besteht die Prüfung nicht. Pack solche Dateien ins ZIP.
Spiele aus Engines als ZIP exportieren
GameMaker, Unity und Godot erzeugen manche Dateinamen erst, während das Spiel läuft. Übernimmst du so ein Spiel von einer Adresse, fehlen deshalb womöglich Dateien. Exportiere das Spiel in deiner Engine als ZIP und lade den ganzen Ordner hoch.
Testen, bevor du erneut hochlädst
Führe auf deinem Computer
node klyo-test.mjs http://localhost:8080/ my-game ./klyo-testaus. Das Tool misst das Spiel so wie wir bei der Veröffentlichung, mit denselben Grenzwerten, und zeigt, was ein Spieler sehen würde.
Wenn etwas nicht klappt
Der Bildschirm bleibt lange leer
Das erste Bild sollte innerhalb von 20 Sekunden erscheinen, und der erste Download auf dem Handy sollte unter 20 MB bleiben. Lade große Dateien später, wenn das Menü schon zu sehen ist.
Kein Ton
Browser geben den Ton erst nach dem ersten Tippen oder Klick frei. Setze die Audiowiedergabe in einer Geste des Spielers fort, auch wenn das Spiel auf dem iPhone aus dem Hintergrund zurückkommt.
Nichts davon erklärt das Problem
Klicke im Studio auf Sprich mit uns und schick uns die Adresse des Spiels mit einem Screenshot. Ein Mensch liest deine Nachricht.
Häufige Fragen
Warum läuft das Spiel bei mir, aber nicht auf klyo?
Meist wegen Großbuchstaben in Dateinamen, absoluter Pfade oder Dateien von fremden Servern. Dein Computer verzeiht das, ein Webserver nicht.
Findet mein KI-Assistent die Ursache?
Ja. Über den MCP-Server von klyo verbunden, liest er dieselbe Diagnose mit fehlenden Dateien und Browserfehlern und kann die Dateien in einer Arbeitsversion korrigieren, die du anschließend selbst prüfst und veröffentlichst.