Beneos Battlemaps

Beneos FAQ - CZARNY EKRAN / BŁĄD "!"

Jeśli napotkasz czarny ekran na mapie lub duży trójkąt z wykrzyknikiem w Foundry VTT, oznacza to, że nie udało się wczytać zasobu (pliku obrazu, wideo lub tokena).

Co to powoduje?

Ten problem pojawia się, gdy Foundry VTT nie może znaleźć pliku pod wskazaną ścieżką ani uzyskać do niego dostępu. W większości przypadków problemem nie jest sama scena, lecz brakujący lub niedostępny zasób na serwerze.

Wskazany plik został usunięty ręcznie
Zawartość nie została w pełni zainstalowana
Pobieranie zostało przerwane lub uszkodzone
Ścieżka pliku istnieje, ale serwer nie może uzyskać dostępu do pliku ani go udostępnić

Często możesz to potwierdzić, otwierając konsolę przeglądarki (F12) i sprawdzając błędy takie jak:

404 (Not Found)

Jak to naprawić (krok po kroku)

Usuń problematyczną zawartość
Usuń zepsutą scenę, kafelek lub token z przeglądarki scen albo katalogu aktorów.
Pobierz zawartość ponownie
Zainstaluj zawartość jeszcze raz przez Beneos Cloud lub Moulinette.
Ponownie pobrana zostanie tylko brakująca zawartość.
Przeładuj swój świat
Po ponownej instalacji przeładuj Foundry VTT, aby odświeżyć wszystkie odwołania.

Jeśli problem nadal występuje

Jeśli ten sam zasób wciąż zawodzi, przyczyna zwykle wiąże się z jakością pobierania, a nie jego szybkością.

Niestabilne połączenie
Duże pliki ZIP (zwłaszcza zawierające animowane zasoby, jak pliki WebM) są wrażliwe na błędy transmisji. Nawet niewielkie uszkodzenie danych może zepsuć całe pliki.
Problemy z Wi-Fi
Połączenia bezprzewodowe są bardziej podatne na utratę pakietów i niestabilność.

Zalecane działanie:

Użyj przewodowego połączenia LAN zamiast Wi-Fi
Pobierz ponownie problematyczną zawartość

Nadal zepsute na tej samej scenie?

Jeśli dokładnie ta sama scena wciąż zawodzi po kilku czystych pobraniach, istnieje niewielka szansa, że problem leży po stronie naszego pakowania.

W takim przypadku:

Zgłoś nam problem
Podaj nazwę problematycznej sceny

Zbadamy to i naprawimy, jeśli będzie taka potrzeba.

Dla serwerów hostowanych samodzielnie (VPS, Linux, AWS itp.)

Jeśli uruchamiasz Foundry VTT na własnej infrastrukturze, problemy z wczytywaniem zasobów często wynikają z konfiguracji serwera lub sieci, a nie z samej zawartości.

Typowe obszary problemów to:

Limity reverse proxy (nginx / Apache)
Przekroczenia czasu (timeouty) przy długich pobraniach
Zablokowane żądania zakresu HTTP (wymagane dla dużych plików multimedialnych)
Błędna konfiguracja TLS / HTTP2
Reguły zapory lub ograniczania przepustowości

Duże animowane zasoby (takie jak pliki WebM) wymagają:

Obsługi trwałych połączeń
Obsługi częściowej zawartości (HTTP 206)
Braku przedwczesnego przerywania długotrwałych pobrań
Braku agresywnego cache'owania lub przepisywania dużych plików binarnych

Nie możemy tu podać kompletnej konfiguracji serwera ani listy kontrolnej, ale upewnij się, że Twój serwer potrafi pobierać, przechowywać i rozpakowywać pojedyncze pliki o rozmiarze do 4 GB. W naszych wydaniach używane są następujące formaty: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Zalecane rozwiązywanie problemów:

Przetestuj problematyczny adres URL zasobu bezpośrednio na serwerze za pomocą curl
Sprawdź logi serwera pod kątem odrzuconych lub przerwanych połączeń
Przejrzyj konfigurację proxy pod kątem limitów rozmiaru i przekroczeń czasu

Jeśli zasób zawodzi przy dostępie bezpośrednio z Twojego serwera, problem leży w Twojej infrastrukturze i tam trzeba go rozwiązać.