CurseForge · Minecraft mod

PROXY protocol v2 Wrapper

A minecraft fabric mod, which adds PPv2 support. Topics

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

Quick answer

Which PROXY protocol v2 Wrapper release matches 26.3 Fabric?

Updated 21 days ago

Best match for your filters mod_1.1-minecraft_26.3

Game version 26.3

Loader Fabric

PROXY protocol v2 Wrapper mod_1.1-minecraft_26.3 targets 26.3 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

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

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say

Dedicated server Source doesn’t say

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

The source does not explicitly classify this release as client-only or server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does PROXY protocol v2 Wrapper mod_1.1-minecraft_26.3 need?

mod_1.1-minecraft_26.3 on 26.3 Fabric. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by PROXY protocol v2 Wrapper mod_1.1-minecraft_26.3

required

Matching file found Matched file: [26.3] Fabric API 0.166.0+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 v2 Wrapper without breaking your instance.

Built for PROXY protocol v2 Wrapper mod_1.1-minecraft_26.3 on 26.3 Fabric. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use mod_1.1-minecraft_26.3. 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. We found matching files for this game-version and loader setup.
03
Put it on the correct side

The project page does not say whether this file belongs on the client, dedicated server, or both.
04
Pick the file you checked

Use the “Get this file” button beside mod_1.1-minecraft_26.3. It opens that exact file at the source.

About this project

What does PROXY protocol v2 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

Project description from CurseForge.

Pick your setup