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.

Copied