BetterPeakVoiceFix

Version: v1.1.3 | Build target: PEAK 2.4.c (multiplayer checks pending) | 👉中文說明和更新日誌

本機語音狀態恢復 / Local voice state recovery

• 自動恢復遠端玩家失效的語音狀態引用，默認開啓；面板關閉時仍每 0.5 秒檢測。只更新引用，不主動修改靜音、屏蔽或通信權限。
• 異常顯示在玩家第二行，不需要 Pro 模式；簡易面板也會列出受影響玩家及第二行提示。恢復後顯示“語音狀態已恢復”8 秒，這不代表已確認收到音頻。
• 不依賴 CrossplayStutterFix（CSF），也不要求主機或隊友安裝。裝有 CSF 時仍使用同一套按需恢復邏輯，不替換它的補丁；共存效果待實機驗證。
• 修復範圍僅爲本機語音組件的失效引用，不修復整個角色註冊表，不處理網絡斷流，也不保證所有失聲問題都能恢復。配置中關閉自動恢復後，仍保留異常提示。
• Restores invalid remote-player voice state references locally every 0.5 seconds, even with the overlay hidden. Enabled by default; does not explicitly change mute, block or communication permission flags.
• Status appears on the player's second line without Pro mode, and affected players also appear in the simple overlay. A restoration notice lasts 8 seconds; it does not confirm incoming audio.
• No CSF, host or peer installation is required. With CSF installed, the same recovery runs only when needed and does not replace CSF patches. In-game coexistence checks are pending. This repairs voice references, not the whole character registry or network failures.
• Mod Overview

• Based on the PEAK VOICE FIX from @chuxia,supports switching between Chinese and English. It includes optimized reconnection logic and additional monitoring features. Press the J to view the voice status of all players in the room. If you experience voice issues, use ALT+K to manually disconnect and reconnect (this can only be done once if the connection is stuck for over 20 seconds).
• For the host's voice server broadcast to work, both the host and clients must have the mod ​installed​. If only one party has the mod, its functionality will be limited to viewing the team's voice status and manual reconnection.
• I have made some optimizations to the text in version 0.3.5. The previous expressions like "MY IP" could indeed lead people to mistakenly believe that their IP would be exposed.
• To facilitate maintenance, the Chinese and English versions will be combined and re-released. You can select the language in the configuration options and it will take effect upon restart.
• UI

A. Simple Overlay UI (Default: On)

A small status bar displayed on the screen (default: right side).

• Local Voice: Displays current connection status (e.g., Connected 🟢).
• Voice Connection Count: Format is n/N.
• Automatically hides when everyone is perfectly connected with no misalignment (Configurable).
• Displays notifications when a player's status changes.

B. Detailed Information Panel (Toggle with J)

This is the core window of the mod, containing three sections of information.

① Top: Connection Status & IP

• Local (Voice) Server IP: The voice server address you are currently connected to.
• Host (Voice) Server IP: The voice server address the room host is connected to.
• [Sync] 🟢: You and the host are on the same channel; you can hear each other.
• [Abnormal] 🔴: You are on a different channel from the host (Status: "Isolated"). Reconnection is required.

② Middle: Player List Status (Key Feature)

Each row represents a player in the game. The mod assigns different status tags via an intelligent algorithm:

| Status Tag | Color | Trigger Condition & Meaning |

|:--- |:--- |:--- |

| [Connected] | Green 🟢 | Perfect State. ID matches, and voice is in the room. |

| [Misaligned] | Pale Green 🟢 | v0.3.4 Core Feature. The player appears disconnected, but a "Nameless Ghost" occupies a voice slot. Meaning: Their voice is likely working, but the ID is stuck. Do NOT ask them to reconnect. |

| [Connecting] | Yellow 🟡 | Player just joined (first 25s) or is verifying. Please wait patiently for it to turn green. |

| [Disconnected] | Red 🔴 | Joined over 25s ago, and there is no corresponding ghost in the voice room. Meaning: Completely failed to connect; cannot hear or speak. Needs to press Alt + K. |

| [Isolated] | Yellow 🟡 | Local client connected to the wrong voice server. Different servers cannot communicate with each other. |

③ Top/Bottom: Smart Statistics Bar