VersionBlocker
Keep your server safe from wrong game versions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Overview
VersionBlocker is a lightweight Velocity proxy plugin that checks every connecting player's game version before they reach your Paper servers. If the version doesn't match your allowed protocol, the player is instantly disconnected with a fully customizable message — no incompatible clients, no surprises.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Features
- Version enforcement — define a single allowed protocol version; any other client is blocked at the proxy level.
- Custom rejection message — show players exactly why they were kicked and what version they need.
- Proxy-level blocking — incompatible clients never reach your backend Paper servers.
- Zero overhead — no database, no commands, no extras. Install and forget.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Configuration
The full list of Minecraft protocol versions is available on the Minecraft Wiki .
Code (YAML):
# VersionBlocker Configuration
# Full protocol version list: https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/Protocol_History
# The only protocol version allowed to connect.
allowed-protocol : 774 # 1.21.11
# Message shown to players connecting with the wrong version.
# Supports legacy color codes (&c, §c, etc.) and the %version% placeholder,
# which is replaced by the player's detected Minecraft version.
kick-message : "&cOnly Minecraft 1.21.11 is allowed on this server. You are connecting with %version%."
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Requirements
- Velocity 3.x or newer
- Java 17 or newer
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Support
This is a minimal, no-frills plugin. No feature requests or dedicated support are provided. For general questions, feel free to join the Discord:
Made with ❤ by Golf
Resource Information
Author:
----------
Total Downloads: 15
First Release: Apr 30, 2026
Last Update: May 5, 2026
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings