Beneos Battlemaps

Preguntas frecuentes de Beneos - PANTALLA NEGRA / ERROR "!"

Si te encuentras con una pantalla negra en un mapa o con un gran triángulo con un signo de exclamación en Foundry VTT, esto indica que no se ha podido cargar un asset (un archivo de imagen, vídeo o token).

¿Cuál es la causa?

Este problema se produce cuando Foundry VTT no encuentra un archivo en la ruta indicada o no puede acceder a él. En la mayoría de los casos, el problema no es la escena en sí, sino un asset que falta o al que no se puede acceder en el servidor.

El archivo referenciado se eliminó manualmente
El contenido no se instaló por completo
La descarga se interrumpió o se corrompió
La ruta del archivo existe, pero el servidor no puede acceder al archivo ni servirlo

A menudo puedes confirmarlo abriendo la consola del navegador (F12) y buscando errores como:

404 (Not Found)

Cómo solucionarlo (paso a paso)

Elimina el contenido afectado
Quita la escena, el tile o el token defectuoso de tu explorador de escenas o del directorio de actores.
Vuelve a descargar el contenido
Instala de nuevo el contenido a través de Beneos Cloud o Moulinette.
Solo se volverá a descargar el contenido que falte.
Recarga tu mundo
Después de reinstalar, recarga Foundry VTT para asegurarte de que todas las referencias se actualizan.

Si el problema persiste

Si el mismo asset falla repetidamente, la causa suele estar relacionada con la calidad de la descarga, no con la velocidad.

Conexión inestable
Los archivos ZIP grandes (sobre todo los que contienen assets animados como archivos WebM) son sensibles a los errores de transmisión. Incluso una pequeña corrupción de datos puede dañar archivos enteros.
Problemas de Wi-Fi
Las conexiones inalámbricas son más propensas a la pérdida de paquetes y a la inestabilidad.

Acción recomendada:

Usa una conexión LAN por cable en lugar de Wi-Fi
Vuelve a descargar el contenido afectado

¿Sigue fallando en la misma escena?

Si exactamente la misma escena falla de forma constante tras varias descargas limpias, existe una pequeña posibilidad de que el problema tenga su origen en nuestro empaquetado.

En ese caso:

Repórtanos el problema
Incluye el nombre de la escena afectada

Lo investigaremos y lo corregiremos si es necesario.

Para servidores autoalojados (VPS, Linux, AWS, etc.)

Si ejecutas Foundry VTT en tu propia infraestructura, los problemas de carga de assets suelen deberse a la configuración del servidor o de la red, no al contenido en sí.

Entre las áreas problemáticas habituales están:

Límites del proxy inverso (nginx / Apache)
Timeouts en descargas largas
Solicitudes de rango HTTP bloqueadas (necesarias para archivos multimedia grandes)
Configuración incorrecta de TLS / HTTP2
Reglas de firewall o de limitación de tasa

Los assets animados grandes (como los archivos WebM) requieren:

Compatibilidad con conexiones persistentes
Compatibilidad con contenido parcial (HTTP 206)
Que no se interrumpan de forma prematura las descargas de larga duración
Que no haya caché agresiva ni reescritura de archivos binarios grandes

No podemos ofrecer aquí una configuración de servidor ni una lista de comprobación completa, pero asegúrate de que tu servidor sea capaz de descargar, almacenar y extraer archivos individuales de hasta 4 GB de tamaño. En nuestros lanzamientos se utilizan los siguientes formatos: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Resolución de problemas recomendada:

Prueba directamente en el servidor la URL del asset que falla usando curl
Revisa los registros del servidor en busca de conexiones rechazadas o interrumpidas
Revisa la configuración del proxy en cuanto a límites de tamaño y timeouts

Si el asset falla al acceder directamente desde tu servidor, el problema está en tu infraestructura y debe resolverse allí.