# 安裝

選擇正確的用戶端 JAR 檔、安裝、首次設定與語言

Source: https://socketsvc.vercel.app/zh-TW/client/installation
## 選擇 JAR 檔 [#choosing-a-jar]

每種 Minecraft 版本與載入器的組合都有各自的 JAR 檔。請挑選和遊戲版本、載入器**完全相符**的那一個，而且 SocketSVC 用戶端 JAR 檔**只能裝一個**。[下載頁面](/download)會依目前已發布的版本替你挑好，用戶端、伺服器和代理伺服器都一樣。

| 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` 檔案，這些都不是完整的建置產物。

## 安裝 [#installing]

<Steps>
<Step>

### 安裝載入器與相依模組 [#install-the-loader-and-dependencies]

安裝與 Minecraft 版本對應的載入器，並使用上表列出的 Java 版本。Fabric/Quilt 還需要 **Fabric API**。可搭配的選用模組：

| 選用模組 | 用途 |
| --- | --- |
| Mod Menu（Fabric） | 從 Mod Menu 開啟 SocketSVC 設定 |
| Flashback（Fabric） | 把語音錄進 Flashback 重播，並在設定中新增 Flashback 分頁 |

RNNoise 原生函式庫已經內建，也不再需要 Cloth Config。

</Step>
<Step>

### 加入 SocketSVC 用戶端 JAR 檔 [#add-the-socketsvc-client-jar]

把與 Minecraft 版本、載入器相符的 SocketSVC 用戶端 JAR 檔放進 `mods/`。SocketSVC 用戶端 JAR 檔只能裝一個。

</Step>
<Step>

### 加入執行 SocketSVC 的伺服器 [#join-a-server-running-socketsvc]

伺服器必須裝有 SocketSVC 的伺服器版本（Paper 外掛或伺服器模組，請參閱[架設伺服器](/server)）。加入伺服器時，用戶端會自動索取一次性的連線授權並連上語音，基本流程完全不用手動設定。

</Step>
<Step>

### 完成首次設定 [#finish-first-run-setup]

第一次交握時會開啟「歡迎使用語音」對話框，讓你選擇語音模式（「自動偵測」或「按鍵說話」），以及麥克風和輸出裝置。

- 首次設定會立即連線，但在按下「開始使用」關閉對話框之前，**不會傳送麥克風音訊**。
- 如果按 <kbd>Esc</kbd> 關閉，會捨棄正在修改的內容並套用預設值（系統預設裝置、「自動偵測」、麥克風與語音音量 100%），讓語音馬上開始運作。
- 之後可以用 `/ssvc setup` 重新開啟；這個指令只會套用設定，不會重新連線。

</Step>
</Steps>

<Callout title="把單人世界開放到區域網路">
  把世界開放到區域網路時（原版的「在區域網路上開放」或 Essential Mod 的世界主機功能），主機的用戶端會自動啟動內建的語音伺服器。其他玩家只要用 SocketSVC 用戶端加入，不必另外安裝伺服器外掛或模組就能交談。訪客需要準備什麼、和正式伺服器有何不同，以及如何關閉這項功能，請參閱[區域網路與單人遊戲](/client/lan)。
</Callout>

## 升級 [#upgrading]

- 已儲存的設定會保留。如果先前把迴音消除存成關閉，請到「進階設定」開啟；新的設定預設使用自動迴音延遲。
- **用戶端和伺服器**都更新後，才能取得已連線玩家清單。舊版伺服器仍然能傳送語音，但無法提供這份清單；名牌上的停止接收語音圖示同樣需要用戶端和伺服器都支援。
- `/ssvc reconnect` 需要伺服器也更新到新版。
- 原有的按鍵綁定會保留；升級後若想改用新的預設按鍵，請到 Minecraft 的「控制」設定手動變更或重設。

## 與其他語音模組並用 [#running-alongside-other-voice-mods]

Simple Voice Chat 或 Plasmo Voice 都可以和 SocketSVC 同時安裝，並以 SocketSVC 為主：平常顯示的是 SocketSVC 的 HUD 與按鍵；只有在另一個模組已連上的伺服器，SocketSVC 才會隱藏 HUD 圖示、停用自己的按鍵。另一個模組沒連上時，它的按鍵會關掉，HUD 圖示也不會顯示。標題畫面每次啟動會出現一次「偵測到其他語音聊天模組」通知說明這件事，按「不再提醒」可永久關閉。細節以及兩者都裝在同一台伺服器時的限制，請參閱[相容性](/client/compatibility#running-alongside-another-voice-chat-mod)。

## 用戶端語言 [#client-languages]

用戶端直接跟隨 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 會逐一查找每個鍵值，所以就算翻譯不完整，也絕不會顯示原始鍵值。

設定、提示文字、旁白標籤、按鍵綁定名稱、用戶端指令回覆，以及連線與處理訊息都已翻譯。玩家與裝置名稱不會翻譯；伺服器管理訊息與診斷記錄則維持英文。