Installation - SocketSVC Docs
SocketSVC Docs

Installation

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

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 picks it for you from what is currently published, for the client, server and proxy alike.

MinecraftJavaFabric/QuiltNeoForgeForge
1.21.1121✓✓✓
26.125✓✓ (beta loader)✓
26.1.125✓✓ (beta loader)✓
26.1.225✓✓✓
26.225✓✓✓
26.325✓✓✓

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

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 modPurpose
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.

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.

Join a server running SocketSVC

The server must have the SocketSVC server side installed (Paper plugin or server mod — see Run a 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.

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 Esc 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.

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 for what guests need, how it differs from a real server, and how to turn it off.

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 languages

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

LanguageCode
Englishen_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.