FAQ Beneos - ÉCRAN NOIR / ERREUR "!"

Si vous rencontrez un écran noir sur une carte ou un grand triangle avec un point d'exclamation dans Foundry VTT, cela indique qu'un asset (fichier image, vidéo ou token) n'a pas pu être chargé.

Quelle en est la cause ?

Ce problème survient lorsque Foundry VTT ne parvient pas à trouver ou à accéder à un fichier au chemin indiqué. Dans la plupart des cas, le problème ne vient pas de la scène elle-même, mais d'un asset manquant ou inaccessible sur le serveur.

• Le fichier référencé a été supprimé manuellement

• Le contenu n'a pas été entièrement installé

• Le téléchargement a été interrompu ou corrompu

• Le chemin du fichier existe, mais le serveur ne peut pas accéder au fichier ou le servir

Vous pouvez souvent le confirmer en ouvrant la console du navigateur (F12) et en recherchant des erreurs comme :

404 (Not Found)

Comment le résoudre (étape par étape)

1. Supprimez le contenu concerné
   Retirez la scène, la tuile ou le token défectueux de votre navigateur de scènes ou de votre répertoire d'acteurs.

2. Retéléchargez le contenu
   Réinstallez le contenu via Beneos Cloud ou Moulinette.
   Seul le contenu manquant sera téléchargé à nouveau.

3. Rechargez votre monde
   Après la réinstallation, rechargez Foundry VTT pour vous assurer que toutes les références sont actualisées.

Si le problème persiste

Si le même asset échoue de façon répétée, la cause est généralement liée à la qualité du téléchargement, et non à sa vitesse.

• Connexion instable
  Les gros fichiers ZIP (en particulier ceux contenant des assets animés comme les fichiers WebM) sont sensibles aux erreurs de transmission. Même une petite corruption de données peut rendre des fichiers entiers inutilisables.

• Problèmes de Wi-Fi
  Les connexions sans fil sont plus sujettes à la perte de paquets et à l'instabilité.

Action recommandée :

• Utilisez une connexion filaire LAN plutôt que le Wi-Fi

• Retéléchargez le contenu concerné

Toujours défaillant sur la même scène ?

Si exactement la même scène échoue systématiquement après plusieurs téléchargements propres, il est possible, dans de rares cas, que le problème vienne de notre packaging.

Dans ce cas :

• Signalez-nous le problème

• Indiquez le nom de la scène concernée

Nous l'examinerons et le corrigerons si nécessaire.

---

Pour les serveurs auto-hébergés (VPS, Linux, AWS, etc.)

Si vous exécutez Foundry VTT sur votre propre infrastructure, les problèmes de chargement des assets sont souvent dus à la configuration du serveur ou du réseau, et non au contenu lui-même.

Les sources de problèmes typiques sont notamment :

• Limites du reverse proxy (nginx / Apache)

• Délais d'expiration (timeouts) sur les téléchargements longs

• Requêtes HTTP range bloquées (nécessaires pour les gros fichiers multimédias)

• Mauvaise configuration TLS / HTTP2

• Règles de pare-feu ou de limitation de débit

Les gros assets animés (comme les fichiers WebM) nécessitent :

• La prise en charge des connexions persistantes

• La prise en charge du contenu partiel (HTTP 206)

• Aucune interruption prématurée des téléchargements longs

• Aucune mise en cache ou réécriture agressive des gros fichiers binaires

Nous ne pouvons pas fournir ici une configuration serveur complète ni une liste de vérification, mais assurez-vous que votre serveur est capable de télécharger, stocker et extraire des fichiers individuels d'une taille allant jusqu'à 4 Go. Les formats suivants sont utilisés dans nos sorties : WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Dépannage recommandé :

• Testez directement l'URL de l'asset défaillant sur le serveur à l'aide de curl

• Vérifiez les journaux du serveur pour repérer les connexions rejetées ou interrompues

• Examinez la configuration du proxy concernant les limites de taille et les délais d'expiration

Si l'asset échoue lorsqu'il est accédé directement depuis votre serveur, le problème se situe dans votre infrastructure et doit y être résolu.