NamVelocityBlockVersion

A lightweight Velocity proxy plugin that allows you to block specific Minecraft versions from entering individual backend servers.

Features

• Per-Server Version Control: Define minimum and maximum protocol versions for each server in your network.
• Custom Kick Messages: Supports MiniMessage (Adventure) for rich-text notifications.
• Console Command Execution: Execute any proxy commands when a player is blocked (e.g., remove from queue, notify admins, or ban).
• ajQueue Integration: Seamlessly remove players from queues if they try to join with an unsupported version.
• Comprehensive Protocol Table: Includes a built-in reference for Minecraft Protocol IDs from 1.7.10 to the latest versions.

Configuration

The config.yml file is generated automatically. You can define server rules like this:

servers:
  lobby:
    min-protocol: 5
    max-protocol: 2147483647
    kick-message: "<red>Lobby server supports version 1.7.10 to latest."
    commands: []

  smp:
    min-protocol: 767
    max-protocol: 2147483647
    kick-message: "<red>SMP server requires version 1.21 or higher!"
    commands:
      - "ajq kick %player%"
      - "kick %player% Please use version 1.21+"

Placeholders

• %player%: The name of the player who was blocked.

Requirements

• Velocity Proxy (3.0+)
• Java 21 or higher

Author

• nattapat2871

License

This project is licensed under the MIT License - see the LICENSE file for details.