Protocol Gate
Last modified: 26 April 2026
Purpose
The protocol gate blocks clients outside your tested protocol window before they reach deeper packet handling. It does not require ViaVersion as a dependency; it reads the protocol id already exposed by the packet layer.
Default policy
The generated config keeps the gate disabled by default to avoid locking out existing traffic during upgrades, but marks it recommended. The default allowlist is protocol 767 through 774, matching Minecraft 1.21 through 1.21.11 in the bundled PacketEvents map.
compatibility:
protocolGate:
enabled: true
allowedProtocols: [767, 768, 769, 770, 771, 772, 773, 774]
blockUnknown: true
Rollout
Turn it on after confirming your ViaVersion/ViaBackwards stack and supported client list. If you support older clients intentionally, add their protocol ids instead of widening the whole gate blindly.