FAQ Beneos - SCHERMO NERO / ERRORE "!"

Se incontri uno schermo nero su una mappa o un grande triangolo con un punto esclamativo in Foundry VTT, significa che un asset (file immagine, video o token) non è stato caricato.

Quali sono le cause?

Questo problema si verifica quando Foundry VTT non riesce a trovare o ad accedere a un file nel percorso specificato. Nella maggior parte dei casi il problema non è la scena in sé, ma un asset mancante o inaccessibile sul server.

• Il file a cui si fa riferimento è stato eliminato manualmente

• Il contenuto non è stato installato completamente

• Il download è stato interrotto o si è corrotto

• Il percorso del file esiste, ma il server non riesce ad accedere al file o a servirlo

Spesso puoi confermarlo aprendo la console del browser (F12) e cercando errori come:

404 (Not Found)

Come risolverlo (passo dopo passo)

1. Elimina il contenuto interessato
   Rimuovi la scena, la tile o il token danneggiato dal tuo Scene Browser o dalla directory degli Actor.

2. Scarica di nuovo il contenuto
   Reinstalla il contenuto tramite Beneos Cloud o Moulinette.
   Verrà scaricato di nuovo solo il contenuto mancante.

3. Ricarica il tuo mondo
   Dopo la reinstallazione, ricarica Foundry VTT per assicurarti che tutti i riferimenti siano aggiornati.

Se il problema persiste

Se lo stesso asset continua a fallire, la causa è di solito legata alla qualità del download, non alla velocità.

• Connessione instabile
  I file ZIP di grandi dimensioni (soprattutto quelli che contengono asset animati come i file WebM) sono sensibili agli errori di trasmissione. Anche una piccola corruzione dei dati può rovinare interi file.

• Problemi Wi-Fi
  Le connessioni wireless sono più soggette a perdita di pacchetti e instabilità.

Azione consigliata:

• Usa una connessione LAN cablata invece del Wi-Fi

• Scarica di nuovo il contenuto interessato

Ancora problemi sulla stessa scena?

Se esattamente la stessa scena continua a fallire dopo diversi download puliti, c'è una piccola possibilità che il problema derivi dal nostro packaging.

In tal caso:

• Segnalaci il problema

• Indica il nome della scena interessata

Indagheremo e lo correggeremo se necessario.

---

Per server self-hosted (VPS, Linux, AWS, ecc.)

Se esegui Foundry VTT sulla tua infrastruttura, i problemi di caricamento degli asset sono spesso causati dalla configurazione del server o della rete, non dal contenuto in sé.

Le aree problematiche tipiche includono:

• Limiti del reverse proxy (nginx / Apache)

• Timeout sui download lunghi

• Richieste HTTP range bloccate (necessarie per file multimediali di grandi dimensioni)

• Configurazione errata di TLS / HTTP2

• Regole di firewall o rate-limiting

Gli asset animati di grandi dimensioni (come i file WebM) richiedono:

• Supporto per connessioni persistenti

• Supporto per contenuti parziali (HTTP 206)

• Nessuna interruzione prematura dei download di lunga durata

• Nessun caching aggressivo o riscrittura dei file binari di grandi dimensioni

Non possiamo fornire qui una configurazione del server completa o una checklist, ma assicurati che il tuo server sia in grado di scaricare, archiviare ed estrarre singoli file fino a 4 GB di dimensione. Nelle nostre release vengono utilizzati i seguenti formati: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Risoluzione dei problemi consigliata:

• Testa direttamente sul server l'URL dell'asset che fallisce usando curl

• Controlla i log del server per connessioni rifiutate o interrotte

• Rivedi la configurazione del proxy per limiti di dimensione e timeout

Se l'asset fallisce quando vi si accede direttamente dal tuo server, il problema è nella tua infrastruttura e deve essere risolto lì.