NG HaProxy Support

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.