Beneos Battlemaps

Beneos FAQ - TELA PRETA / ERRO "!"

Se você encontrar uma tela preta em um mapa ou um grande triângulo com um ponto de exclamação no Foundry VTT, isso indica que um asset (arquivo de imagem, vídeo ou token) não pôde ser carregado.

O que causa isso?

Esse problema ocorre quando o Foundry VTT não consegue encontrar ou acessar um arquivo no caminho especificado. Na maioria dos casos, o problema não é a cena em si, mas um asset ausente ou inacessível no servidor.

O arquivo referenciado foi excluído manualmente
O conteúdo não foi totalmente instalado
O download foi interrompido ou corrompido
O caminho do arquivo existe, mas o servidor não consegue acessar ou servir o arquivo

Muitas vezes você pode confirmar isso abrindo o console do navegador (F12) e procurando por erros como:

404 (Not Found)

Como corrigir (passo a passo)

Exclua o conteúdo afetado
Remova a cena, o tile ou o token quebrado do seu navegador de cenas ou do diretório de Actors.
Baixe o conteúdo novamente
Instale o conteúdo de novo pela Beneos Cloud ou pela Moulinette.
Apenas o conteúdo ausente será baixado novamente.
Recarregue seu mundo
Após reinstalar, recarregue o Foundry VTT para garantir que todas as referências sejam atualizadas.

Se o problema persistir

Se o mesmo asset falhar repetidamente, a causa costuma estar relacionada à qualidade do download, não à velocidade do download.

Conexão instável
Arquivos ZIP grandes (especialmente os que contêm assets animados como arquivos WebM) são sensíveis a erros de transmissão. Mesmo uma pequena corrupção de dados pode inutilizar arquivos inteiros.
Problemas de Wi-Fi
Conexões sem fio são mais propensas a perda de pacotes e instabilidade.

Ação recomendada:

Use uma conexão LAN com fio em vez de Wi-Fi
Baixe novamente o conteúdo afetado

Ainda quebrado na mesma cena?

Se exatamente a mesma cena falhar de forma consistente após vários downloads limpos, há uma pequena chance de que o problema tenha origem no nosso empacotamento.

Nesse caso:

Relate o problema para nós
Inclua o nome da cena afetada

Vamos investigar e corrigir se necessário.

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

Se você está executando o Foundry VTT na sua própria infraestrutura, os problemas de carregamento de assets costumam ser causados pela configuração do servidor ou da rede, não pelo conteúdo em si.

Áreas de problema típicas incluem:

Limites de proxy reverso (nginx / Apache)
Timeouts em downloads longos
Requisições HTTP range bloqueadas (necessárias para arquivos de mídia grandes)
Configuração incorreta de TLS / HTTP2
Regras de firewall ou de limitação de taxa

Assets animados grandes (como arquivos WebM) exigem:

Suporte a conexões persistentes
Suporte a conteúdo parcial (HTTP 206)
Sem encerramento prematuro de downloads longos
Sem cache agressivo ou reescrita de arquivos binários grandes

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

Solução de problemas recomendada:

Teste a URL do asset com falha diretamente no servidor usando curl
Verifique os logs do servidor em busca de conexões rejeitadas ou interrompidas
Revise a configuração do proxy quanto a limites de tamanho e timeouts

Se o asset falhar quando acessado diretamente do seu servidor, o problema está na sua infraestrutura e deve ser resolvido lá.