Modrinth · Minecraft mod

PROXY protocol Wrapper

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which PROXY protocol Wrapper release matches 26.3?

Updated 27 days ago

Best match for your filters 1.1

Game version 26.3

Loader Fabric

PROXY protocol Wrapper 1.1 targets 26.3 with Fabric. Do not install it on the client. It must be installed on the dedicated server. 1 required mod needs a matching file.

Where it goes

Is PROXY protocol Wrapper required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported

Dedicated server Required

Loader for this release Fabric

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does PROXY protocol Wrapper 1.1 need?

1.1 on 26.3. Every mod below is checked against that same setup.

1 required mod needs a matching file

Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.

Fabric API Needed by PROXY protocol Wrapper 1.1

required

No matching file Version asked for: 0.159.1+26.3

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add PROXY protocol Wrapper without breaking your instance.

Built for PROXY protocol Wrapper 1.1 on 26.3. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use 1.1. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
03
Put it on the correct side

Do not install it on the client. It must be installed on the dedicated server.
04
Pick the file you checked

Use the “Get this file” button beside 1.1. It opens that exact file at the source.

About this project

What does PROXY protocol Wrapper add?

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)_

Project description from Modrinth.

Pick your setup