常見問題
本頁列出常見的症狀與處理方式。如果仍無法解決，請依本頁最後的方式回報。
啟動與顯示
無法啟動或立即結束
- Windows：請將顯示卡驅動程式更新到最新版本。較舊的 Windows 可能需要 Vulkan 驅動程式。
- macOS：顯示「無法開啟」時，請參閱初始設定中的「macOS 顯示『無法開啟』時」。
- Linux：需要支援 Vulkan 的顯示卡驅動程式。tar.gz 版請從解壓縮後資料夾中的
./bmz-player啟動。
畫面卡頓、動作不流暢
請在 設定 → 影像 中將「畫格延遲」設為「穩定」，或將「目標 FPS」設為屏幕的刷新率。關閉其他應用程式也可能有所改善。
介面不顯示或顯示錯亂
請在 設定 → 外觀 中確認該介面是否顯示了讀取錯誤。如果介面缺少部分資料夾（字型或圖片），將無法正確顯示。請將介面整個資料夾依發布時的結構放置。
歌曲與難度表
歌曲不顯示
- 請在 設定 → 曲庫 中確認已登錄存放歌曲的資料夾。
- 新增歌曲後，請在選曲畫面按 F5，或按「重新掃描曲庫」。
- 請確認每首歌曲都放在一個資料夾中。譜面檔案（.bms 等）與音訊檔案需要在同一資料夾中。
- 請確認選曲畫面中沒有開啟 0（難度）或 1（按鍵數）的篩選。
難度表中沒有歌曲或難度表沒有更新
在選曲畫面選擇難度表資料夾並按 F5，即可重新取得難度表。即使難度表中列出了譜面，沒有該譜面也無法遊玩。選擇尚未擁有的譜面並決定後，會在瀏覽器中開啟取得頁面。
聲音
沒有聲音
- 在 設定 → 音訊 的「輸出裝置」中確認已選擇所用裝置。
- 按「重新整理裝置清單」後重新選擇，再按「套用」。
- 在同一畫面的「音量」中確認主音量等沒有設為 0。
插拔裝置後沒有聲音時，按「套用」也可能恢復。
聲音中斷或有雜音
請增加 設定 → 音訊 中的「緩衝區大小」。
聲音聽起來有延遲
請參閱判定時機與延遲調整。
輸入
鍵盤或控制器沒有反應
- 請在 設定 → 輸入裝置 中確認控制器顯示為已連線。
- 請在 設定 → 按鍵設定 中確認所玩按鍵數（如 7K）的指派。不同按鍵數的指派是分開的。
- 指派旁邊顯示警告圖示時，表示與其他操作指派了相同的按鍵。
轉盤反應不靈敏或轉動過頭
請在 設定 → 輸入裝置 中調整「模擬轉盤」與「模擬輸入靈敏度」。
成績與 IR
成績沒有儲存
自動演奏、重播播放、練習以及轉換了按鍵數的遊玩不儲存成績。輔助功能生效時只儲存 ASSIST 過關紀錄。
看不到匯入的成績或以前的成績
成績依規則與 LN 模式的組合分別儲存。請將 設定 → 遊玩 的「規則」與「LN 模式」改回取得該成績時的設定。
成績沒有送出到 IR
- 請在 設定 → IR 中確認顯示為已登入。
- 未連線期間的成績會在恢復連線後自動送出。
- 傳送失敗的成績可在 設定 → IR →「開啟傳送佇列」中查看，並用「重新傳送」再次傳送。
記錄檔與資料的位置
按 F1 開啟 BMZ 選單，用「開啟目錄」中的按鈕可以開啟各資料夾。
| 按鈕 | 內容 |
|---|---|
| data_dir | 設定、成績、重播、加入的介面 |
| logs_dir | 運作紀錄（記錄檔） |
| cache_dir | 暫存檔案。刪除後會在需要時重新產生 |
| resource_dir | BMZ Player 隨附的檔案。更新時會被覆寫 |
備份 data_dir 可以保護設定與成績。請在結束 BMZ Player 後再進行備份。
回報問題
請在 GitHub Issues 回報。提供以下資訊有助於查明原因：
- 所用作業系統與 BMZ Player 的版本
- 做了什麼操作時發生了什麼
- logs_dir 中的記錄檔
- 如有需要，附上屏幕截圖（按 F12 儲存）