Beneos 常見問題 - 黑畫面 / 「!」錯誤

如果你在 Foundry VTT 中遇到地圖出現黑畫面，或一個大的驚嘆號三角形，這表示某個素材（圖片、影片或 token 檔）無法載入。

這是什麼原因造成的？

當 Foundry VTT 無法在指定路徑找到或存取檔案時，就會發生這個問題。多數情況下，問題不在場景本身，而是伺服器上某個遺失或無法存取的素材。

• 被參照的檔案遭手動刪除

• 內容未完整安裝

• 下載中斷或毀損

• 檔案路徑存在，但伺服器無法存取或提供該檔案

你通常可以開啟瀏覽器主控台（F12）並檢查是否有類似錯誤來確認：

404 (Not Found)

如何修復（逐步說明）

1. 刪除受影響的內容
   從你的場景瀏覽器或角色目錄中，移除損壞的場景、圖磚或 token。

2. 重新下載內容
   透過 Beneos Cloud 或 Moulinette 再次安裝內容。
   只有遺失的內容會被重新下載。

3. 重新載入你的世界
   重新安裝後，重新載入 Foundry VTT，確保所有參照都已刷新。

如果問題持續存在

如果同一個素材反覆失敗，原因通常與下載品質有關，而非下載速度。

• 連線不穩定
  大型 ZIP 檔（尤其是包含像 WebM 這類動態素材的檔案）對傳輸錯誤很敏感。即使是小小的資料毀損，也可能讓整個檔案損壞。

• Wi-Fi 問題
  無線連線較容易發生封包遺失與不穩定。

建議做法：

• 使用有線 LAN 連線取代 Wi-Fi

• 重新下載受影響的內容

同一個場景仍然損壞？

如果同一個場景在多次乾淨下載後仍持續失敗，那麼問題有一點點可能出在我們的封裝上。

在這種情況下：

• 向我們回報問題

• 附上受影響場景的名稱

我們會調查，並在必要時修復。

---

自架伺服器（VPS、Linux、AWS 等）

如果你在自己的基礎架構上執行 Foundry VTT，素材載入問題通常是由伺服器或網路設定造成，而非內容本身。

常見的問題點包括：

• 反向代理限制（nginx / Apache）

• 長時間下載時的逾時

• 被封鎖的 HTTP range 請求（大型媒體檔案所需）

• TLS / HTTP2 設定錯誤

• 防火牆或速率限制規則

大型動態素材（例如 WebM 檔）需要：

• 支援持續連線

• 支援部分內容（HTTP 206）

• 不會提前中斷長時間執行的下載

• 不對大型二進位檔案進行過度快取或重寫

我們無法在此提供完整的伺服器設定或檢查清單，但請確保你的伺服器能夠下載、儲存並解壓縮單一大小最高達 4 GB 的檔案。我們的發布內容使用以下格式：WebM、WebP、SVG、ZIP、OGG Vorbis、JSON、INFO、PNG。

建議的疑難排解：

• 在伺服器上使用 curl 直接測試失敗素材的 URL

• 檢查伺服器記錄，找出被拒絕或中斷的連線

• 檢視代理設定的大小限制與逾時

如果直接從你的伺服器存取素材時失敗，那麼問題出在你的基礎架構，必須在那裡解決。