# Installation

Choosing the right client JAR, installing, first-run setup and languages

Source: https://socketsvc.vercel.app/client/installation
## Choosing a JAR

Every Minecraft version × loader has its own JAR. Pick the one matching your game's **exact** version and loader, and install **only one** SocketSVC client JAR. [The download page](/download) picks it for you from what is currently published, for the client, server and proxy alike.

| Minecraft | Java | Fabric/Quilt | NeoForge | Forge |
| --- | --- | --- | --- | --- |
| 1.21.11 | 21 | ✓ | ✓ | ✓ |
| 26.1 | 25 | ✓ | ✓ (beta loader) | ✓ |
| 26.1.1 | 25 | ✓ | ✓ (beta loader) | ✓ |
| 26.1.2 | 25 | ✓ | ✓ | ✓ |
| 26.2 | 25 | ✓ | ✓ | ✓ |
| 26.3 | 25 | ✓ | ✓ | ✓ |

This table is the explicitly validated matrix as of 2026-10-18; it does not automatically claim compatibility with future versions. NeoForge 26.1 and 26.1.1 only ever had `-beta` releases (NeoForge moved on to 26.1.2), so those two SocketSVC NeoForge builds are published as beta.

- **Quilt uses the Fabric JAR**: Quilt Loader can run Fabric API mods, and QSL has no 26.x release, so no separate Quilt JAR is built.
- **File name**: `socketsvc-client-<loader>-<client version>+mc<MC>.jar`; the Modrinth version number is `<client version>+mc<MC>-<loader>@client`.
- Do not install `-plain.jar` or `-slim.jar` files; they are not complete artifacts.

## Installing

<Steps>
<Step>

### Install the loader and dependencies

Install the loader for your Minecraft version and use the Java version from the table above. Fabric/Quilt also needs **Fabric API**. Optional integrations:

| Optional mod | Purpose |
| --- | --- |
| Mod Menu (Fabric) | Open SocketSVC settings from Mod Menu |
| Flashback (Fabric) | Record voice into Flashback replays; adds a Flashback tab to the settings |

RNNoise native libraries are bundled. Cloth Config is no longer required.

</Step>
<Step>

### Add the SocketSVC client JAR

Put the SocketSVC client JAR for the same Minecraft version and loader into `mods/`. Install only one SocketSVC client JAR.

</Step>
<Step>

### Join a server running SocketSVC

The server must have the SocketSVC server side installed (Paper plugin or server mod — see [Run a server](/server)). When you join, the client automatically requests a one-time connection token and connects to voice; no manual setup is required for the basic flow.

</Step>
<Step>

### Finish first-run setup

The first handshake opens the "Welcome to voice" dialog, where you choose the voice mode (Voice activated or Push to talk) and your microphone/output devices.

- First-run setup connects immediately but **does not transmit microphone audio** until you close it with "Get started".
- Closing it with <kbd>Esc</kbd> discards whatever you were changing and applies the defaults (system default devices, Voice activated, 100% microphone and voice volume) so voice starts working right away.
- `/ssvc setup` reopens it later; it only applies settings and does not reconnect.

</Step>
</Steps>

<Callout title="Opening a singleplayer world to LAN">
  When you open a world to LAN (vanilla "Open to LAN" or Essential Mod's world hosting), the host's client automatically starts a built-in voice server. Players who join with the SocketSVC client can talk without installing any server side. See [LAN and singleplayer](/client/lan) for what guests need, how it differs from a real server, and how to turn it off.
</Callout>

## Upgrading

- Existing saved settings are preserved. If echo cancellation was previously saved as off, turn it on under Advanced; new configurations default to automatic echo delay.
- Update **both ends** to get the connected-player list. Older servers still carry voice audio but cannot provide that list; the nameplate deafened icon also needs both ends to support it.
- `/ssvc reconnect` requires an updated server.
- Existing key bindings are kept; to pick up new default keys after an upgrade, change or reset the bindings manually in Minecraft's Controls settings.

## Running alongside other voice mods

You can keep Simple Voice Chat or Plasmo Voice installed next to SocketSVC. SocketSVC is the main one: its HUD and keys are what you get, except on a server where the other mod has connected, where SocketSVC hides its HUD icon and ignores its keys. Whenever the other mod isn't connected, its keys are switched off and its HUD icon is hidden. An "Another Voice Chat Mod Detected" notice on the title screen says so once per launch; "Don't warn me again" turns it off permanently. The details, and the limits on servers that run both, are under [Running alongside another voice chat mod](/client/compatibility#running-alongside-another-voice-chat-mod).

## Client languages

The client follows Minecraft's language setting — there is no separate language selector. Ten languages are built in:

| Language | Code |
| --- | --- |
| English | `en_us` |
| 简体中文 (Simplified Chinese) | `zh_cn` |
| 繁體中文 (Traditional Chinese) | `zh_tw` |
| 文言 (Classical Chinese) | `lzh` |
| 日本語 (Japanese) | `ja_jp` |
| 한국어 (Korean) | `ko_kr` |
| Русский (Russian) | `ru_ru` |
| Deutsch (German) | `de_de` |
| Français (French) | `fr_fr` |
| Español (Spanish) | `es_es` |

Any other locale falls back to English, and so does any individual line a translation has not covered — Minecraft resolves each key separately, so a partial translation never shows a raw key.

Settings, tooltips, narration labels, key binding names, client command replies and connection/processing messages are translated. Player and device names stay unchanged; server administration messages and diagnostic logs remain English.