PROXY protocol Wrapper

A lightweight Fabric server-side mod that adds native support for the HAProxy PROXY protocol v2 to forward real player IPs.

by NovogodnichManagement Technology Utility

Fabric

Loaders: Fabric
Downloads on Modrinth: 120
Followers on Modrinth: 1
versions: 3
Updated: October 13, 2026Oct 13
Published: in 2026

Add to favorites Follow updatesFollow

At a glance

Runs on Fabric

For Minecraft 1.21.11, 26.3

Server only — players don't need to install it

Latest version — 1.1 from October 13, 2026

License GPL-3.0-or-later — free

Where it's needed

In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.21.11, 26.3

Fabric PROXY v2 Base Wrapper (PPv2)

A lightweight Fabric server-side mod that adds native support for the HAProxy PROXY protocol v2. It injects custom handlers into the Netty pipeline to accurately forward real player IPs behind reverse proxies, CDNs, or DDoS protection layers (like HAProxy, Velocity, or cloud mitigation providers).

Features

Native Netty Integration: Dynamically updates the channel pipeline during the handshake phase.
Accurate IP Forwarding: Restores real client IPs in Minecraft server logs, bans, and whitelist systems instead of showing 127.0.0.1 or the proxy's IP.
Production Ready: Fixed common pipeline race conditions (NoSuchElementException) and safely shaded required Netty HAProxy codecs.

Installation & Requirements

Drop the compiled .jar into your server's mods/ directory.
Ensure your upstream proxy/load balancer has PROXY protocol v2 enabled for the Minecraft backend port (e.g., send-proxy-v2 in HAProxy configuration).

Compatibility:

Fabric Loader 0.18.4+
Minecraft 1.21.11 or 26.3
Fabric api 0.159.1+26.3 or newer_(for 26.3 only)_

FAQ

How to install PROXY protocol Wrapper?

Install Fabric for your Minecraft version, download PROXY protocol Wrapper for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does PROXY protocol Wrapper support?

PROXY protocol Wrapper has builds for Minecraft 1.21.11, 26.3.

Is PROXY protocol Wrapper needed on the server?

Server only — players don't need to install it

License and source

GNU General Public License v3.0 or laterfree to use and share; changes to the mod itself must be published under the same license

Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders