FAQ Beneos - ECRÃ PRETO / ERRO "!"

Se encontrar um ecrã preto num mapa ou um grande triângulo com um ponto de exclamação no Foundry VTT, isso indica que um asset (ficheiro de imagem, vídeo ou token) não pôde ser carregado.

O que causa isto?

Este problema ocorre quando o Foundry VTT não consegue encontrar ou aceder a um ficheiro no caminho indicado. Na maioria dos casos, o problema não é a cena em si, mas um asset em falta ou inacessível no servidor.

• O ficheiro referenciado foi eliminado manualmente

• O conteúdo não foi totalmente instalado

• A transferência foi interrompida ou corrompida

• O caminho do ficheiro existe, mas o servidor não consegue aceder ao ficheiro nem disponibilizá-lo

Muitas vezes pode confirmar isto abrindo a consola do navegador (F12) e verificando erros como:

404 (Not Found)

Como resolver (passo a passo)

1. Elimine o conteúdo afetado
   Remova a cena, o tile ou o token com problemas do seu Scene Browser ou do diretório Actor.

2. Volte a transferir o conteúdo
   Instale o conteúdo novamente através da Beneos Cloud ou da Moulinette.
   Só será transferido de novo o conteúdo em falta.

3. Recarregue o seu mundo
   Depois de reinstalar, recarregue o Foundry VTT para garantir que todas as referências são atualizadas.

Se o problema persistir

Se o mesmo asset falhar repetidamente, a causa está normalmente relacionada com a qualidade da transferência, não com a velocidade.

• Ligação instável
  Os ficheiros ZIP grandes (sobretudo os que contêm assets animados, como ficheiros WebM) são sensíveis a erros de transmissão. Mesmo uma pequena corrupção de dados pode inutilizar ficheiros inteiros.

• Problemas de Wi-Fi
  As ligações sem fios são mais propensas a perda de pacotes e a instabilidade.

Ação recomendada:

• Use uma ligação LAN por cabo em vez de Wi-Fi

• Volte a transferir o conteúdo afetado

Continua com problemas na mesma cena?

Se exatamente a mesma cena falhar de forma consistente após várias transferências limpas, há uma pequena possibilidade de o problema ter origem no nosso empacotamento.

Nesse caso:

• Comunique-nos o problema

• Inclua o nome da cena afetada

Vamos investigar e corrigir se for necessário.

---

Para servidores auto-alojados (VPS, Linux, AWS, etc.)

Se estiver a executar o Foundry VTT na sua própria infraestrutura, os problemas de carregamento de assets são muitas vezes causados pela configuração do servidor ou da rede, e não pelo conteúdo em si.

As áreas problemáticas típicas incluem:

• Limites do proxy inverso (nginx / Apache)

• Timeouts em transferências longas

• Pedidos HTTP range bloqueados (necessários para ficheiros de multimédia grandes)

• Configuração incorreta de TLS / HTTP2

• Regras de firewall ou de limitação de taxa

Os assets animados grandes (como os ficheiros WebM) requerem:

• Suporte para ligações persistentes

• Suporte para conteúdo parcial (HTTP 206)

• Sem terminação prematura de transferências demoradas

• Sem caching agressivo nem reescrita de ficheiros binários grandes

Não podemos fornecer aqui uma configuração de servidor completa nem uma lista de verificação, mas certifique-se de que o seu servidor é capaz de transferir, armazenar e extrair ficheiros individuais até 4 GB de tamanho. Os seguintes formatos são usados nos nossos lançamentos: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

Resolução de problemas recomendada:

• Teste diretamente no servidor o URL do asset que falha, usando curl

• Verifique nos registos do servidor as ligações rejeitadas ou interrompidas

• Reveja a configuração do proxy quanto a limites de tamanho e timeouts

Se o asset falhar quando acedido diretamente a partir do seu servidor, o problema está na sua infraestrutura e tem de ser resolvido aí.