Beneos Battlemaps

Beneos FAQ - SCHWARZER BILDSCHIRM / "!"-FEHLER

Wenn dir bei einer Map ein schwarzer Bildschirm oder ein großes Dreieck mit Ausrufezeichen in Foundry VTT begegnet, bedeutet das, dass ein Asset (Bild-, Video- oder Token-Datei) nicht geladen werden konnte.

Was verursacht das?

Dieses Problem tritt auf, wenn Foundry VTT eine Datei unter dem angegebenen Pfad nicht finden oder darauf zugreifen kann. In den meisten Fällen liegt das Problem nicht an der Szene selbst, sondern an einem fehlenden oder nicht erreichbaren Asset auf dem Server.

Die referenzierte Datei wurde manuell gelöscht
Der Inhalt wurde nicht vollständig installiert
Der Download wurde unterbrochen oder war fehlerhaft
Der Dateipfad existiert, aber der Server kann die Datei nicht abrufen oder ausliefern

Oft kannst du das bestätigen, indem du die Browser-Konsole (F12) öffnest und nach Fehlern wie diesem suchst:

404 (Not Found)

So behebst du es (Schritt für Schritt)

Betroffenen Inhalt löschen
Entferne die defekte Szene, das Tile oder den Token aus deinem Szenen-Browser oder Actor-Verzeichnis.
Inhalt erneut herunterladen
Installiere den Inhalt erneut über Beneos Cloud oder Moulinette.
Nur fehlende Inhalte werden erneut heruntergeladen.
Welt neu laden
Lade Foundry VTT nach der Neuinstallation neu, damit alle Referenzen aktualisiert werden.

Wenn das Problem weiterhin besteht

Wenn dasselbe Asset wiederholt fehlschlägt, liegt die Ursache meist an der Download-Qualität, nicht an der Download-Geschwindigkeit.

Instabile Verbindung
Große ZIP-Dateien (besonders solche mit animierten Assets wie WebM-Dateien) reagieren empfindlich auf Übertragungsfehler. Schon eine kleine Datenbeschädigung kann ganze Dateien unbrauchbar machen.
WLAN-Probleme
Drahtlose Verbindungen sind anfälliger für Paketverluste und Instabilität.

Empfohlene Maßnahme:

Nutze eine kabelgebundene LAN-Verbindung statt WLAN
Lade den betroffenen Inhalt erneut herunter

Immer noch fehlerhaft bei derselben Szene?

Wenn genau dieselbe Szene nach mehreren sauberen Downloads durchgehend fehlschlägt, besteht eine kleine Chance, dass das Problem von unserem Packaging stammt.

In diesem Fall:

Melde uns das Problem
Gib den Namen der betroffenen Szene an

Wir untersuchen es und beheben es bei Bedarf.

Für selbst gehostete Server (VPS, Linux, AWS usw.)

Wenn du Foundry VTT auf deiner eigenen Infrastruktur betreibst, werden Ladeprobleme bei Assets oft durch die Server- oder Netzwerkkonfiguration verursacht, nicht durch den Inhalt selbst.

Typische Problemfelder sind:

Reverse-Proxy-Limits (nginx / Apache)
Timeouts bei langen Downloads
Blockierte HTTP-Range-Requests (für große Mediendateien erforderlich)
TLS-/HTTP2-Fehlkonfiguration
Firewall- oder Rate-Limiting-Regeln

Große animierte Assets (etwa WebM-Dateien) erfordern:

Unterstützung für persistente Verbindungen
Unterstützung für Teilinhalte (HTTP 206)
Kein vorzeitiges Abbrechen langlaufender Downloads
Kein aggressives Caching oder Umschreiben großer Binärdateien

Wir können hier keine vollständige Serverkonfiguration oder Checkliste bereitstellen, aber stelle sicher, dass dein Server einzelne Dateien von bis zu 4 GB Größe herunterladen, speichern und entpacken kann. In unseren Releases kommen folgende Formate zum Einsatz: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Empfohlene Fehlersuche:

Teste die fehlschlagende Asset-URL direkt auf dem Server mit curl
Prüfe die Server-Logs auf abgelehnte oder unterbrochene Verbindungen
Überprüfe die Proxy-Konfiguration auf Größenlimits und Timeouts

Wenn das Asset schon beim direkten Zugriff von deinem Server fehlschlägt, liegt das Problem in deiner Infrastruktur und muss dort behoben werden.