ModsFinder
PR

ProperProxyProtocol

by MrDrak

ProperProxyProtocol lets a Minecraft server read the real player IP address from PROXY protocol headers sent by a proxy such as TCPShield.

FabricForgeNeoForgeServer-side onlyAll rights reserved1.20 – 1.21.11

What it does

Without this handling, a server behind a reverse proxy sees only the proxy address for every connection. ProperProxyProtocol reads the HAProxy header that the proxy attaches to each new connection, so player IPs are parsed correctly and logged by the server. The mod is server-side only: players join without installing anything, and it runs on Fabric, Forge and NeoForge for 1.20 – 1.21.11.

Key features

  1. HAProxy header parsing

    The mod reads only the connection packets that carry a HAProxy header, and leaves the rest of the traffic alone.

  2. TCPShield compatibility

    It is aimed at modded servers protected by TCPShield, with the proxy-protocol option enabled in the TCPShield panel.

  3. Separate connection handling

    Header handling runs on its own thread instead of the main server thread, so login and world loading are not slowed by it.

Compatibility

Latest build for each game version and loader.

1.21.x12 of 12 versions with builds
1.21.111.1.0+1.21.11-fabric1.1.0+1.21.11-forge1.1.0+1.21.11-neoforge
1.21.101.0.0Not available1.0.0
1.21.91.0.0Not available1.0.0
1.21.81.0.0Not available1.0.0
1.21.71.0.0Not available1.0.0
1.21.61.0.0Not available1.0.0
1.21.51.0.0Not available1.0.0
1.21.41.0.0Not available1.0.0
1.21.31.0.0Not available1.0.0
1.21.21.0.0Not available1.0.0
1.21.11.1.0+1.21.1-fabric1.1.0+1.21.1-forge1.1.0+1.21.1-neoforge
1.211.0.0Not available1.0.0
1.20.x7 of 7 versions with builds
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

How it compares

Full comparison

TCPShield is a proxy service that runs on Fabric, Forge and NeoForge for 1.20 – 26.2 under the GNU General Public License v3.0 or later, and it is open source. NG HaProxy Support is Forge-only for 1.20.1, is not open source, and is released under the MIT License.

ModLoadersGame versionsEnvironmentUpdated
ProperProxyProtocolFabric, Forge and NeoForge1.20 – 1.21.11Server-side only2026-05-27
TCPShieldFabric, Forge and NeoForge1.20 – 26.2Server-side only2026-07-24
NG HaProxy SupportForge1.20.1Server-side only2026-03-15

Questions

Does ProperProxyProtocol have to be installed on players' computers?

No. The mod is server-side only, so only the server needs it.

Which loader should a server use?

Fabric, Forge and NeoForge builds are published, with the latest file for 1.21.11 on each loader.

In the catalog

ProperProxyProtocol is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 19,862 mods support Minecraft 1.21.11.

Management mods8,016Fabric modsMods for 1.21.1119,862

More from MrDrak

All projects
StreamlineCore1.7.2 – 26.3VoiceChatProfiles1.20.1 – 26.3QIO Integrations1.20.1 – 1.21.1RealHeights1.8 – 26.2

Similar mods

Cherished Worlds1.12.2 – 26.3Default Options1.18 – 26.3Axiom1.20 – 26.3Resourcify1.8.9 – 26.3Rebind Narrator1.16.1 – 26.1.2Paxi1.19.2 – 26.1.2

What the author says

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…
MrDrak, on the Modrinth page

Official listing

Owner
MrDrak
Published
2026-01-30
Updated on Modrinth
2026-05-27
Facts verified
2026-10-15

Tags

Game mechanicsManagementUtility
Open on ModrinthCompare