Minecraft mod that allows Open to LAN multiplayer to work on more restrictive networks
StealthPipe is a utility Minecraft mod that allows Open to LAN multiplayer to work on networks that normally block it, with more inherently stable connections than alternatives. It also allows you to connect to friends that are on different networks.
StealthPipe works anywhere. Literally. It works 95% of the time as it is practically indistinguishable from regular web traffic.
Version >=4.0.0 required for relay connection.
The newest version is version 5 which adds packet batching for increased connection reliability. It is now a stable version. All the clients playing in the same room must have the same version! Either V4 or V5
Steps to quickly start playing:
XXXXXX.stealth.link) to join in the Direct Connection (in Multiplayer menu).Both clients need to have the mod installed. Otherwise, it will say "Unknown Host" (this is intentional).
Default relays only work on the latest (major) mod version!
There's an option to disable Online Mode in the mod's config if needed to resolve issues. This was originally meant for development only.
If it doesn't work, try recreating the session and joining it. Otherwise, you may create an issue on the issue tracker.
If you are experiencing high ping, you may try rejoining then try disabling the Packet Batching optimization, which aims to add almost no latency, but can sometimes result in an added latency of 8-30ms depending on server load and geographical location.
Unlike E4MC, StealthPipe requires both clients to have the mod installed, since it completely rewrites Minecraft's networking to work with WebSockets in order to achieve the benefits listed above.
Version 3.0.0 introduces a parallel connection architecture, enabling the relay to utilize multi-core processing for significantly faster packet forwarding and improved horizontal scalability.
Version 5.0.0 introduces a packet batching system (enabled by default, can be disabled) that batches packets that are sent at around the same time (1ms difference). This measure reduces the packets per second count by around 10x (500 packets per second to 50 packets per second on average). The lower packets per second count allows the connections to have a higher reliability and less random drops from firewalls. However, this brings an additional 8ms to 30ms of ping. This feature can be disabled in the mod config. As of version 5.0.1, the additional latency is almost gone, but an 8-30ms added ping can sometimes still be present in some cases (can be reduced by rejoining).
This mod does not collect any telemetry or user data. Backend source code can be found here: https://github.com/CariLT01/stealthpipe-relay
2.1 MB packet size limit: The public relay enforces a 2.1 MB packet size limit for stability. Since Vanilla Minecraft defaults to a 2 MB limit, this limit is normally fine when playing with a minimal amount of mods. However, this means that mods like Packet Fixer or XXL Packets will not work on the public relay; the relay will disconnect the client before the mod can bypass the limit.
If your modpack requires larger packets, you must host your own relay and adjust the limit in the source code.
Throttling if consuming too much bandwidth: To protect the server's bandwidth usage, your connection may be throttled or disconnected if you are sending too much data. The threshold depends on the duration of sustained high bandwidth usage and the number of clients connected to the current world. Normal vanilla gameplay should never trigger this. You may resolve this by hosting your own relay, see the self-hosting section above.
Proof of Work: To prevent automated Botnets from spamming and crashing the free public relay (DDoS protection), the server requires a 'Handshake Ticket.' The client generates this ticket by solving a small mathematical puzzle (SHA-256 hashing), also called Proof of Work. This ensures that every room creation is backed by a real computer's effort, making it extremely difficult for a script to create 10,000 rooms per second.
The public relay may get upgraded if this mod starts becoming too popular.
In many network environments, peer-to-peer connections are blocked and most ports other than 443 are restricted, like in airports and hotels. Since Minecraft’s Open to LAN relies on direct connections and non-443 ports, it simply doesn’t work in these conditions.
Also, in many of these places, QUIC (technology used behind the popular e4mc mod) is also blocked, but e4mc fundamentally relies on it.
StealthPipe solves this by tunneling LAN multiplayer traffic through secure WebSockets over port 443, allowing players to connect where traditional LAN hosting (and e4mc) would normally fail.
StealthPipe is a protocol-specific relay; it only handles Minecraft game packets and cannot be used as a general-purpose VPN or proxy. It also cannot connect to public servers such as Hypixel.
It achieves this by sending Minecraft traffic over WebSockets, making it appear as normal browser traffic. This mod is similar to e4mc, but it routes traffic through WebSockets instead of using QUIC.
Technical overview can be found here: https://github.com/CariLT01/stealthpipe-relay/blob/main/TECHNICAL.MD
You can configure which relay to use in the mod settings. Use a third-party relay or host your own if needed. The relay backend is open-source and MIT-licensed. The default relay in this mod is completely free to use.
It is highly recommended to host your own relay for control and stability. The relay is designed to be easily portable and can run everywhere, regardless of the environment by using Docker containers. The entire relay consists of three files.
StealthPipe relay is multithreaded, lightweight, and portable. It uses less than 32 MB of memory.
The guide is available here:
https://github.com/CariLT01/stealthpipe-relay/blob/main/HOSTING.md
The default relay hosted on Render.com can sometimes be slow and unreliable depending on external factors. The default relay is hosted on Render's free tier as a proof-of-concept; users are encouraged to self-host for production-level stability.
Explore these alternative relays if you have issues with the default one:
StealthPipe is compatible with all mods tested so far. Play alongside your favorite mods without issues. If you find any incompatibilities with other mods, please report them in the Issues tab and attach the crash report.
This mod cannot be installed on a dedicated server.
The mod is not officially backported to other Minecraft versions or modloaders. However, you are free to port it to any version or modloader as needed. Updates will be provided for the supported versions when necessary.
StealthPipe is slowly being backported to older versions. It is planned to be backported until 1.20.2 where Mojang completely reworked their networking internals.
If the default one is offline, you can use another one.
To see the list, go to the 'Alternative Relays' section under 'More Information'.
This mod strongly recommends self-hosting a relay for stability and performance. See 'More Information' section for more information.
Feel free to report any bugs or issues in the Issues tab on the GitHub repository.
StealthPipe is licensed under the MIT License.