Minecraft version
Back to mods 
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 should I use?
Latest stable file mod_1.1-minecraft_1.21.11
Game version 1.21.11
Loader Fabric
PROXY protocol v2 Wrapper mod_1.1-minecraft_1.21.11 targets 1.21.11 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
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.
What else does PROXY protocol v2 Wrapper mod_1.1-minecraft_1.21.11 need?
mod_1.1-minecraft_1.21.11. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add PROXY protocol v2 Wrapper without breaking your instance.
Built for PROXY protocol v2 Wrapper mod_1.1-minecraft_1.21.11. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use mod_1.1-minecraft_1.21.11. It targets 1.21.11 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 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_1.21.11. 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-v2in 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
PROXY protocol v2 Wrapper by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
Minecraft version
1.21.11
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
PROXY protocol v2 Wrapper versions and loaders
mod_1.1-minecraft_1.21.11
minecraft_mod_ppv2-1.1-1.21.11.jar
13 Oct 2026
Client Source doesn’t say Server Source doesn’t say Dependencies No extras listed Listed on Release listing
Check the 1.21.11 · Fabric setup Fabric1.21.11 release
mod_1.1-minecraft_26.3
minecraft_mod_ppv2-1.1-26.3.jar
13 Oct 2026
Client Source doesn’t say Server Source doesn’t say Dependencies 1 required · 1 unchecked Listed on Release listing
Check the 26.3 · Fabric setup Fabric26.3 release
mod_1.0-minecraft_1.21.11
minecraft_mod_ppv2-1.0.0 (3).jar
13 Oct 2026
Client Source doesn’t say Server Source doesn’t say Dependencies No extras listed Listed on Release listing
Check the 1.21.11 · Fabric setup Fabric1.21.11 release
Looking for an older file? The official CurseForge project page is in Resources.
mod CurseForge + Modrinth · Minecraft
Armor Trim Item Fix
Adds more trimmed item textures
mod CurseForge · Minecraft
One Block Engine
Data-driven One Block engine for Fabric and NeoForge 1.21.1: phases, blocks, mobs and rewards in JSON, an in-game editor, a One Block world type and one island per player.
mod CurseForge · Minecraft
Better Allay
Customize how allay differentiates between potions and tipped arrows. Optionally can make allays pick up items even when mob griefing is off and set time for how long allay likes noteblock.