
Modrinth · Minecraft mod
ProperProxyProtocol
Adds proxy protocol capabilities to your Minecraft server (that actually work). Also fixes TCPShield for modded servers.
Quick answer
Which ProperProxyProtocol release matches 1.21.8?
ProperProxyProtocol 1.0.0 targets 1.21, 1.21.1, 1.21.2 with NeoForge. 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 ProperProxyProtocol required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does ProperProxyProtocol 1.0.0 need?
1.0.0 on 1.21.8. Every mod below is checked against that same setup.
Install Fabric API, Architectury API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add ProperProxyProtocol without breaking your instance.
Built for ProperProxyProtocol 1.0.0 on 1.21.8. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.0. It targets 1.21, 1.21.1, 1.21.2 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API, Architectury 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.0.0. It opens that exact file at the source.
About this project
What does ProperProxyProtocol add?
Overview
This mod adds Proxy Protocol (or HAProxy) support to your Minecraft server. It also fixes TCPShield connections on your server!
FAQ
Q: Does this affect performance?
A (Simple): No.
A (Full): No, this mod only reads connection packets and checks if they are using an HAProxy header. There is no hard operations happening. If anything, this should speed up logins as we patch players loading in to the world. We do this because the HAProxy handler handles connections on a different thread than the main server thread.
Q: Does this fix TCPShield connections?
A (Simple): Yes!
A (Full): Yes! You can actually turn proxy-protocol to enabled in your TCPShield panel and then your players' IPs will actually be parsed correctly by your server.
Currently Supported
Platforms
- NeoForge
- Fabric
- Forge
Versions
- 1.21.11
- 1.21.1
- 1.20.1
Requirements
0 requirements!
Project description from Modrinth.
Pick your setup
ProperProxyProtocol by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.11
3 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader builds1.21.3
2 loader builds1.21.2
2 loader builds1.21.1
3 loader builds1.21
2 loader buildsShowing the newest 12 of 19 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
ProperProxyProtocol versions and loaders
1.0.0
ProperProxyProtocol-neoforge-1.0.0.jar
30 Jan 2026
1.0.0
ProperProxyProtocol-fabric-1.0.0.jar
30 Jan 2026
Looking for an older file? The official Modrinth project page is in Resources.