SocketSVC Docs安裝
選擇正確的用戶端 JAR 檔、安裝、首次設定與語言
選擇 JAR 檔
每種 Minecraft 版本與載入器的組合都有各自的 JAR 檔。請挑選和遊戲版本、載入器完全相符的那一個，而且 SocketSVC 用戶端 JAR 檔只能裝一個。下載頁面會依目前已發布的版本替你挑好，用戶端、伺服器和代理伺服器都一樣。
| Minecraft | Java | Fabric/Quilt | NeoForge | Forge |
|---|---|---|---|---|
| 1.21.11 | 21 | ✓ | ✓ | ✓ |
| 26.1 | 25 | ✓ | ✓（beta 版載入器） | ✓ |
| 26.1.1 | 25 | ✓ | ✓（beta 版載入器） | ✓ |
| 26.1.2 | 25 | ✓ | ✓ | ✓ |
| 26.2 | 25 | ✓ | ✓ | ✓ |
| 26.3 | 25 | ✓ | ✓ | ✓ |
此表列出截至 2026-10-18 明確驗證過的組合，不代表未來的版本會自動相容。NeoForge 26.1 和 26.1.1 一直只有 -beta 版本（NeoForge 已改支援 26.1.2），所以這兩版的 SocketSVC NeoForge 檔案仍以 beta 版發布。
- Quilt 使用 Fabric JAR 檔：Quilt Loader 能執行 Fabric API 模組，而 QSL 沒有 26.x 版本，所以不另外建置 Quilt JAR 檔。
- 檔案名稱：
socketsvc-client-<loader>-<client version>+mc<MC>.jar；Modrinth 上的版本號碼是<client version>+mc<MC>-<loader>@client。 - 請不要安裝
-plain.jar或-slim.jar檔案，這些都不是完整的建置產物。
安裝
安裝載入器與相依模組
安裝與 Minecraft 版本對應的載入器，並使用上表列出的 Java 版本。Fabric/Quilt 還需要 Fabric API。可搭配的選用模組：
| 選用模組 | 用途 |
|---|---|
| Mod Menu（Fabric） | 從 Mod Menu 開啟 SocketSVC 設定 |
| Flashback（Fabric） | 把語音錄進 Flashback 重播，並在設定中新增 Flashback 分頁 |
RNNoise 原生函式庫已經內建，也不再需要 Cloth Config。
加入 SocketSVC 用戶端 JAR 檔
把與 Minecraft 版本、載入器相符的 SocketSVC 用戶端 JAR 檔放進 mods/。SocketSVC 用戶端 JAR 檔只能裝一個。
加入執行 SocketSVC 的伺服器
伺服器必須裝有 SocketSVC 的伺服器版本（Paper 外掛或伺服器模組，請參閱架設伺服器）。加入伺服器時，用戶端會自動索取一次性的連線授權並連上語音，基本流程完全不用手動設定。
完成首次設定
第一次交握時會開啟「歡迎使用語音」對話框，讓你選擇語音模式（「自動偵測」或「按鍵說話」），以及麥克風和輸出裝置。
- 首次設定會立即連線，但在按下「開始使用」關閉對話框之前，不會傳送麥克風音訊。
- 如果按 Esc 關閉，會捨棄正在修改的內容並套用預設值（系統預設裝置、「自動偵測」、麥克風與語音音量 100%），讓語音馬上開始運作。
- 之後可以用
/ssvc setup重新開啟；這個指令只會套用設定，不會重新連線。
把單人世界開放到區域網路
把世界開放到區域網路時（原版的「在區域網路上開放」或 Essential Mod 的世界主機功能），主機的用戶端會自動啟動內建的語音伺服器。其他玩家只要用 SocketSVC 用戶端加入，不必另外安裝伺服器外掛或模組就能交談。訪客需要準備什麼、和正式伺服器有何不同，以及如何關閉這項功能，請參閱區域網路與單人遊戲。
升級
- 已儲存的設定會保留。如果先前把迴音消除存成關閉，請到「進階設定」開啟；新的設定預設使用自動迴音延遲。
- 用戶端和伺服器都更新後，才能取得已連線玩家清單。舊版伺服器仍然能傳送語音，但無法提供這份清單；名牌上的停止接收語音圖示同樣需要用戶端和伺服器都支援。
/ssvc reconnect需要伺服器也更新到新版。- 原有的按鍵綁定會保留；升級後若想改用新的預設按鍵，請到 Minecraft 的「控制」設定手動變更或重設。
與其他語音模組並用
Simple Voice Chat 或 Plasmo Voice 都可以和 SocketSVC 同時安裝，並以 SocketSVC 為主：平常顯示的是 SocketSVC 的 HUD 與按鍵；只有在另一個模組已連上的伺服器，SocketSVC 才會隱藏 HUD 圖示、停用自己的按鍵。另一個模組沒連上時，它的按鍵會關掉，HUD 圖示也不會顯示。標題畫面每次啟動會出現一次「偵測到其他語音聊天模組」通知說明這件事，按「不再提醒」可永久關閉。細節以及兩者都裝在同一台伺服器時的限制，請參閱相容性。
用戶端語言
用戶端直接跟隨 Minecraft 的語言設定，沒有另外的語言選項。內建十種語言：
| 語言 | 代碼 |
|---|---|
| English（英文） | en_us |
| 简体中文（簡體中文） | zh_cn |
| 繁體中文 | zh_tw |
| 文言（文言文） | lzh |
| 日本語（日文） | ja_jp |
| 한국어（韓文） | ko_kr |
| Русский（俄文） | ru_ru |
| Deutsch（德文） | de_de |
| Français（法文） | fr_fr |
| Español（西班牙文） | es_es |
其他語系一律顯示英文，翻譯尚未涵蓋的個別字串也會改用英文。Minecraft 會逐一查找每個鍵值，所以就算翻譯不完整，也絕不會顯示原始鍵值。
設定、提示文字、旁白標籤、按鍵綁定名稱、用戶端指令回覆，以及連線與處理訊息都已翻譯。玩家與裝置名稱不會翻譯；伺服器管理訊息與診斷記錄則維持英文。