NG HaProxy Support
by SSbaxyS
NG HaProxy Support lets a Forge server read the real client address when players connect through a HAProxy-compatible reverse proxy.
What it does
Without support for the PROXY protocol, a server sees only the address of the proxy, so every player appears to share one IP. NG HaProxy Support accepts PROXY protocol v1 and v2 headers and restores the real player address in server logs. It is aimed at servers placed behind proxies such as Velocity, TCPShield, FRP or Nginx, and any other reverse proxy that can send the header.
The mod supports a hybrid setup in which proxied and direct connections are accepted at the same time. Connections from addresses it does not recognize are rejected by default, which blocks players who try to skip the proxy and spoof an IP. Whitelists accept CIDR ranges, and TCPShield server addresses can be fetched automatically. The config can be reloaded without a restart, and a status command shows the current settings and connection counts in game.
The mod is server-side only, so players join without installing anything. It is published for Forge 1.20.1, with the latest file, 1.0.0, dated 2026-03-15. Its code is under the MIT License and is not open source.
Key features
PROXY protocol v1 and v2
Both header versions are parsed, so the server recognizes the real client address from either format.
Fail-closed connections
Unknown addresses are rejected automatically, which stops players from bypassing the proxy and connecting directly.
CIDR whitelists
Whole subnets can be listed in one entry instead of individual addresses.
TCPShield address fetch
The whitelist can pull TCPShield server addresses automatically rather than requiring manual updates.
Status command and logging
An in-game command shows the current configuration and connection statistics, and connections are logged.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
ProperProxyProtocol is available for Fabric, Forge and NeoForge across 1.20 – 1.21.11, is server-side only and is under All rights reserved, so it is not open source. PROXY protocol Wrapper targets Fabric only, for 1.21.11 – 26.3, is server-side only and is open source under the GNU General Public License v3.0 or later. TCPShield covers Fabric, Forge and NeoForge for 1.20 – 26.2 and is open source under the GNU General Public License v3.0 or later.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| NG HaProxy Support | Forge | 1.20.1 | Server-side only | 2026-03-15 |
| ProperProxyProtocol | Fabric, Forge and NeoForge | 1.20 – 1.21.11 | Server-side only | 2026-05-27 |
| PROXY protocol Wrapper | Fabric | 1.21.11 – 26.3 | Server-side only | 2026-10-13 |
| TCPShield | Fabric, Forge and NeoForge | 1.20 – 26.2 | Server-side only | 2026-07-24 |
Questions
Does NG HaProxy Support need to be installed on the client?
Which proxies work with NG HaProxy Support?
What happens to a connection that skips the proxy?
In the catalog
NG HaProxy Support is one of 8,499 Technology mods on ModsFinder, and one of 4,122 Technology mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from SSbaxyS
Similar mods
What the author says
Adds HAProxy PROXY protocol support to your Minecraft Forge server. See real player IP addresses when your server is behind a proxy like Velocity, TCPShield, FRP, Nginx, or any other HAProxy-compatible reverse proxy.
Official listing
- Modrinth page
- modrinth.com/mod/ng-haproxy-support
- Owner
- SSbaxyS
- Published
- 2025-12-19
- Updated on Modrinth
- 2026-03-15
- Facts verified
- 2026-10-15