Beneos FAQ - ČERNÁ OBRAZOVKA / CHYBA "!"

Pokud ve Foundry VTT narazíte na mapě na černou obrazovku nebo velký trojúhelník s vykřičníkem, znamená to, že se nepodařilo načíst nějaký asset (soubor obrázku, videa nebo tokenu).

Čím je to způsobeno?

K tomuto problému dochází, když Foundry VTT nemůže najít soubor na zadané cestě nebo k němu přistoupit. Ve většině případů není problémem samotná scéna, ale chybějící nebo nedostupný asset na serveru.

• Odkazovaný soubor byl smazán ručně

• Obsah nebyl plně nainstalován

• Stahování bylo přerušeno nebo poškozeno

• Cesta k souboru existuje, ale server k souboru nemůže přistoupit nebo jej doručit

Často to potvrdíte otevřením konzole prohlížeče (F12) a kontrolou chyb jako:

404 (Not Found)

Jak to opravit (krok za krokem)

1. Smažte postižený obsah
   Odstraňte poškozenou scénu, dlaždici nebo token z prohlížeče scén nebo adresáře aktérů.

2. Stáhněte obsah znovu
   Nainstalujte obsah znovu přes Beneos Cloud nebo Moulinette.
   Znovu se stáhne pouze chybějící obsah.

3. Načtěte svět znovu
   Po přeinstalování znovu načtěte Foundry VTT, aby se všechny odkazy obnovily.

Pokud problém přetrvává

Pokud stejný asset opakovaně selhává, příčina obvykle souvisí s kvalitou stahování, nikoli s rychlostí stahování.

• Nestabilní připojení
  Velké soubory ZIP (zejména ty s animovanými assety, jako jsou soubory WebM) jsou citlivé na chyby přenosu. I malé poškození dat může zničit celé soubory.

• Problémy s Wi-Fi
  Bezdrátová připojení jsou náchylnější ke ztrátě paketů a nestabilitě.

Doporučený postup:

• Použijte kabelové připojení LAN místo Wi-Fi

• Stáhněte postižený obsah znovu

Stále nefunguje stejná scéna?

Pokud přesně stejná scéna opakovaně selhává i po několika čistých staženích, existuje malá šance, že problém pochází z našeho balení.

V takovém případě:

• Nahlaste nám problém

• Uveďte název postižené scény

Prozkoumáme to a v případě potřeby to opravíme.

---

Pro vlastní hostování (VPS, Linux, AWS atd.)

Pokud provozujete Foundry VTT na vlastní infrastruktuře, problémy s načítáním assetů často způsobuje konfigurace serveru nebo sítě, nikoli samotný obsah.

Mezi typické problematické oblasti patří:

• Limity reverzní proxy (nginx / Apache)

• Timeouty u dlouhých stahování

• Blokované HTTP range requesty (nutné pro velké mediální soubory)

• Špatná konfigurace TLS / HTTP2

• Pravidla firewallu nebo omezování rychlosti

Velké animované assety (například soubory WebM) vyžadují:

• Podporu trvalých spojení

• Podporu částečného obsahu (HTTP 206)

• Žádné předčasné ukončování dlouhotrvajících stahování

• Žádné agresivní kešování nebo přepisování velkých binárních souborů

Nemůžeme zde poskytnout kompletní konfiguraci serveru ani kontrolní seznam, ale ujistěte se, že váš server dokáže stahovat, ukládat a rozbalovat jednotlivé soubory o velikosti až 4 GB. V našich vydáních se používají tyto formáty: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Doporučené řešení potíží:

• Otestujte URL selhávajícího assetu přímo na serveru pomocí curl

• Zkontrolujte serverové logy, zda neobsahují odmítnutá nebo přerušená spojení

• Prověřte konfiguraci proxy s ohledem na limity velikosti a timeouty

Pokud asset selže při přímém přístupu z vašeho serveru, problém je ve vaší infrastruktuře a musí být vyřešen tam.