Beneos Battlemaps

Beneos FAQ - 검은 화면 / "!" 오류

Foundry VTT에서 맵에 검은 화면이 나타나거나 느낌표가 있는 큰 삼각형이 보인다면, 이는 에셋(이미지, 비디오 또는 토큰 파일)을 불러오지 못했다는 뜻입니다.

원인은 무엇인가요?

이 문제는 Foundry VTT가 지정된 경로에서 파일을 찾거나 접근하지 못할 때 발생합니다. 대부분의 경우 문제는 장면 자체가 아니라, 서버에 없거나 접근할 수 없는 에셋에 있습니다.

참조된 파일이 수동으로 삭제됨
콘텐츠가 완전히 설치되지 않음
다운로드가 중단되거나 손상됨
파일 경로는 존재하지만, 서버가 파일에 접근하거나 제공하지 못함

브라우저 콘솔(F12)을 열어 다음과 같은 오류가 있는지 확인하면 대개 이를 확인할 수 있습니다:

404 (Not Found)

해결 방법 (단계별)

문제가 있는 콘텐츠 삭제
Scene Browser 또는 Actor 디렉터리에서 손상된 장면, 타일 또는 토큰을 제거하세요.
콘텐츠 다시 다운로드
Beneos Cloud 또는 Moulinette를 통해 콘텐츠를 다시 설치하세요.
누락된 콘텐츠만 다시 다운로드됩니다.
월드 다시 불러오기
다시 설치한 후 Foundry VTT를 새로 불러와 모든 참조가 갱신되도록 하세요.

문제가 계속된다면

동일한 에셋이 반복해서 실패한다면, 원인은 대개 다운로드 속도가 아니라 다운로드 품질과 관련이 있습니다.

불안정한 연결
대용량 ZIP 파일(특히 WebM 파일 같은 애니메이션 에셋이 포함된 경우)은 전송 오류에 민감합니다. 작은 데이터 손상만으로도 파일 전체가 깨질 수 있습니다.
Wi-Fi 문제
무선 연결은 패킷 손실과 불안정성이 더 자주 발생합니다.

권장 조치:

Wi-Fi 대신 유선 LAN 연결을 사용하세요
문제가 있는 콘텐츠를 다시 다운로드하세요

같은 장면에서 계속 문제가 발생하나요?

여러 번 깨끗하게 다운로드한 후에도 정확히 같은 장면이 계속 실패한다면, 문제가 저희 패키징에서 비롯되었을 가능성도 조금 있습니다.

그런 경우에는:

저희에게 문제를 알려주세요
문제가 있는 장면의 이름을 함께 적어주세요

저희가 조사하여 필요하다면 수정하겠습니다.

직접 호스팅하는 서버의 경우 (VPS, Linux, AWS 등)

자체 인프라에서 Foundry VTT를 운영하는 경우, 에셋 로딩 문제는 콘텐츠 자체가 아니라 서버 또는 네트워크 설정 때문인 경우가 많습니다.

일반적인 문제 영역은 다음과 같습니다:

리버스 프록시 제한 (nginx / Apache)
긴 다운로드에서의 타임아웃
차단된 HTTP range 요청 (대용량 미디어 파일에 필요함)
TLS / HTTP2 설정 오류
방화벽 또는 속도 제한 규칙

대용량 애니메이션 에셋(예: WebM 파일)에는 다음이 필요합니다:

지속 연결 지원
부분 콘텐츠(HTTP 206) 지원
장시간 실행되는 다운로드의 조기 중단 없음
대용량 바이너리 파일의 과도한 캐싱이나 재작성 없음

여기서 완전한 서버 설정이나 체크리스트를 제공할 수는 없지만, 서버가 최대 4GB 크기의 개별 파일을 다운로드, 저장, 압축 해제할 수 있는지 확인하세요. 저희 릴리스에는 다음 포맷이 사용됩니다: WebM, WebP, SVG, ZIP, OGG Vorbis, JSON, INFO, PNG.

권장 문제 해결:

실패하는 에셋 URL을 서버에서 curl로 직접 테스트하세요
서버 로그에서 거부되거나 중단된 연결이 있는지 확인하세요
프록시 설정에서 크기 제한과 타임아웃을 검토하세요

서버에서 직접 접근했을 때도 에셋이 실패한다면, 문제는 여러분의 인프라에 있으며 그곳에서 해결해야 합니다.