NG HaProxy Support

Adds HAProxy protocol support to Forge servers. See real player IPs behind Velocity, TCPShield, FRP, and Nginx proxies. Features hot-reload config, status command, and connection logging.

File Details
DownloadInstall

NG HaProxy Support v1.0.0 - Initial Release

BySSbaxyS
  • R
  • Feb 15, 2026
  • 1.63 MB
  • 118
  • 1.20.1
  • Forge

File Name

ng_proxy_support-1.0.0-all.jar

Supported Versions

  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:ng-haproxy-support-1408807:7629065")
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

NG Proxy Support — v1.0.0

Release Date: 2026-02-15
Minecraft: 1.20.1 | Forge: 47.x | Java: 17+
License: MIT

🎉 Initial Release

First public release of NG Proxy Support for Minecraft Forge 1.20.1.
Ported from the Fabric mod proxy-protocol-support with new features and improvements.

✨ Features

  • HAProxy PROXY Protocol v1/v2 — full support for both protocol versions
  • Real IP Resolution — players connecting via proxy show their real IP in logs, bans, and plugins
  • Hybrid Mode — supports both proxied and direct connections simultaneously
  • Fail-Closed Security — unknown IPs are automatically rejected to prevent proxy bypass
  • CIDR Notation — whitelist entire subnets (e.g. 192.168.0.0/16)
  • TCPShield Integration — auto-fetch and whitelist TCPShield server IPs
  • Hot-Reload Config — /proxyprotocol reload reloads config without server restart
  • Status Command — /proxyprotocol status shows current config and active rules in-game
  • Connection Logging — logs real player IPs and proxy IPs to logs/proxy_connections.log

🔧 Configuration

Config file: config/proxy_protocol_support.json

Option Default Description
enableProxyProtocol true Enable/disable the mod
proxyServerIPs ["127.0.0.1"] Trusted proxy IPs
directAccessIPs ["127.0.0.1", "192.168.0.0/16"] IPs allowed to connect directly
whitelistTCPShieldServers false Auto-fetch TCPShield IPs
logConnections true Log connections to file

🛡️ Commands

Command Permission Description
/proxyprotocol reload OP 4 Reload config without restart
/proxyprotocol status OP 4 View current configuration

🔗 Compatible Proxies

  • Velocity (with haproxy-protocol = true)
  • TCPShield
  • HAProxy
  • Nginx (with proxy_protocol on)
  • FRP
  • Any HAProxy-compatible reverse proxy

Author: xylos
© 2024-2026 xylos. Licensed under MIT.