---
title: "Spiel zeigt weißen Bildschirm: so behebst du es"
description: "Weißer oder schwarzer Bildschirm in der Vorschau? Meist: fehlende Datei, falscher Pfad oder blockiertes Skript. Das Studio zeigt dir die Ursache."
url: https://games.klyo.pl/de/support/white-screen/
canonical: https://games.klyo.pl/de/support/white-screen/
type: instrukcja
language: de
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
---

# 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

1. **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.
2. **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.
3. **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.
4. **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.
5. **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.
6. **Testen, bevor du erneut hochlädst**: Führe auf deinem Computer `node klyo-test.mjs http://localhost:8080/ my-game ./klyo-test` aus. 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.

## Passende Anleitungen

- [So veröffentlichst du ein HTML5-Spiel auf klyo games](https://games.klyo.pl/de/support/publish-html5-game/)
- [Neue Spielversion veröffentlichen, alte wiederherstellen](https://games.klyo.pl/de/support/release-new-version/)
- [So fügst du einem HTML5-Spiel eine Bestenliste hinzu](https://games.klyo.pl/de/support/add-leaderboard/)
- [Dein KI-Assistent spielt dein Spiel: so erlaubst du es](https://games.klyo.pl/de/support/assistant-plays-your-game/)
- [Alle Anleitungen](https://games.klyo.pl/de/support/)

Klappt es immer noch nicht? Schreib an [kontakt@klyo.pl](mailto:kontakt@klyo.pl) und gib die Adresse des Spiels an. Ein Mensch antwortet dir innerhalb von zwei Werktagen.

---

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