ws2tcp
by MooreFoss
ws2tcp lets a Minecraft client reach a server through a WebSocket address, which ws2tcp connects to via a local proxy on port 25565.
What it does
Players can connect to Minecraft servers over WebSocket. The client opens a local proxy on port 25565 that forwards traffic to the WebSocket address the player enters, and the mod reads the saved proxy settings automatically when a server is chosen. A local proxy entry is also added to the server list so the connection can be picked like any other server.
The mod suits situations where direct access to a server is blocked, such as cloud gaming setups or networks that need CDN or NAT traversal. It is a client-side tool and does not change anything on the server, so a server owner does not need to install it.
ws2tcp is built for Fabric only, with a build for Minecraft 1.21.4 and Fabric Loader 0.16.12 or above. It is released under the Apache License 2.0 and is open source, with public source code, an issue tracker and a wiki.
Key features
WebSocket server connections
Players reach a Minecraft server through a WebSocket address instead of a direct connection.
Local port proxy
The mod listens on local port 25565 and forwards the game traffic to the chosen WebSocket address.
Automatic proxy setup
Saved proxy configuration is read automatically, and a local proxy entry is added to the server list.
Simple graphical interface
A basic screen for entering the WebSocket address, with English and Simplified Chinese language support.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Cloud gaming
Players who play through a cloud gaming service can reach a server over WebSocket without opening direct ports.
Restricted networks
Connections that must pass through a CDN or a NAT setup can use the WebSocket route instead.
Who it’s for: Players who need to reach a Minecraft server through a WebSocket proxy, for example when cloud gaming or CDN and NAT traversal is involved. The mod is only needed on the player's own client.
How it compares
MineSocket is a Fabric mod that is server-side only, released under the MIT License, open source, and built for 1.21 – 1.21.8, so it runs on the other end of a connection rather than the player's client. FabricProxyPlus is server-side only, not open source, released under All rights reserved, and covers 1.21.6 – 1.21.8. ChatSocket is client-side only, open source under the CC0 1.0 Universal license, and targets 1.21.5 alone.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| ws2tcp | Fabric | 1.21.4 | Client-side only | 2025-07-10 |
| MineSocket | Fabric | 1.21 – 1.21.8 | Server-side only | 2025-03-27 |
| FabricProxyPlus | Fabric | 1.21.6 – 1.21.8 | Server-side only | 2025-08-04 |
| ChatSocket | Fabric | 1.21.5 | Client-side only | 2025-05-16 |
Questions
Which Minecraft version does ws2tcp support?
Does the server need ws2tcp installed?
Which loader does ws2tcp need?
In the catalog
ws2tcp is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 17,979 mods support Minecraft 1.21.4.
Similar mods
What the author says
ws2tcp is a Fabric-based Minecraft client mod that allows players to connect to Minecraft servers via the WebSocket protocol. This mod is useful for scenarios where you need to access servers through a WebSocket proxy, such as cloud gaming, CDN, or NAT traversal. Feel free to submit issues or pull requests if you…
Official listing
- Modrinth page
- modrinth.com/mod/ws2tcp
- Owner
- MooreFoss
- Published
- 2025-07-10
- Updated on Modrinth
- 2025-07-10
- Facts verified
- 2026-10-15