Proxy Mod

Route all your Minecraft multiplayer connections through a SOCKS5 proxy, keeping your real IP address hidden from every server you join.

Why Use This?

When you connect to a Minecraft server, the server can see your IP address. This mod prevents that by routing your connection through a proxy server, so the server only ever sees the proxy's IP — not yours.

• Privacy — Keep your real IP address hidden from server owners and other players
• Security — Protect yourself from DDoS attacks and IP logging when playing on public or untrusted servers
• Server Testing — Server admins can test their own server's security and ban systems from a different IP
• Network Restrictions — Connect to servers that may be blocked on your network

Setup is simple: open the Multiplayer screen, click the proxy button, enter your proxy details, test the connection, and you're good to go. No config files to edit manually.

Features

• SOCKS5 Protocol Support — Full implementation of the SOCKS5 handshake, including IPv4 and domain-based address types
• Proxy Authentication — Supports username/password authentication (RFC 1929) for private proxies
• Server List Ping Proxying — Server pings from the multiplayer screen are also routed through the proxy, so your IP is never leaked—even when refreshing the server list
• In-Game Configuration Screen — Accessible directly from the Multiplayer screen via a status button. Configure host, port, and credentials without editing any files
• Built-in Connection Test — Verify your proxy is working before joining a server. The test performs a full SOCKS5 handshake and tunnel check
• Live Status Indicator — A color-coded button on the Multiplayer screen shows proxy state at a glance: green (active & verified), yellow (enabled, not tested), or red (disabled)

How It Works

The mod uses Fabric Mixin to inject into Minecraft's Connection.connect() and ServerStatusPinger.pingLegacyServer() methods. When the proxy is enabled, outgoing connections are routed through Netty's Socks5ProxyHandler, which handles the SOCKS5 negotiation before Minecraft's packet serialization begins. The handler removes itself from the pipeline once the tunnel is established, so there is zero overhead on normal packet flow.

Configuration

All settings are stored in config/proxy-mod.json and can be edited through the in-game GUI:

Requirements

• Minecraft 26.1
• Fabric Loader 0.18.5+
• Fabric API 0.144.3+