TerraVersions
TerraVersions is a lightweight and flexible plugin that allows you to control which Minecraft client versions can connect to your network. Perfect for ensuring compatibility, stability, and a consistent player experience.
With our plugin for BungeeCord/Velocity networks, you can decide whether to enforce version restrictions across your whole network or only on specific servers.
Features
* ✅ Network-wide version blocking – set minimum/maximum supported versions globally.
* ✅ Per-server version control – configure exact versions allowed on individual servers.
* ✅ Flexible configuration – allow full version ranges, exact versions, or no restrictions.
* ✅ Lightweight & optimized – designed to run efficiently with minimal impact.
* ✅ Debug mode – helps you track and test version restrictions easily.
Configuration Highlights
* Network settings: Define minimum and maximum supported versions, customize messages, and choose whether to kick unsupported players.
* Server-specific settings: Each server can allow specific versions or disable restrictions entirely.
* Fallback messages: Default kick message for servers not explicitly configured.
Why Use TerraVersions?
If you’ve ever had players join with outdated or incompatible clients, TerraVersions helps you
maintain a consistent gameplay environment without confusion. You stay in control of exactly which versions are allowed—whether across your entire network or on a server-by-server basis.
Code (YAML):
# TerraVersions Configuration
# Configure version requirements for each server
# General network version support message
network
:
# Show a message when players join the BungeeCord network
show-join-message
: false
# Message to show on network join (supports color codes with &)
join-message
:
"&7Welcome to &bTerraNetwork&7!\n&eWe support Minecraft versions &a1.20.x &7through &a1.21.x&7.\n&7Your version: &f{version}"
# Minimum supported version for the entire network
minimum-version
:
"1.20.1"
# Maximum supported version for the entire network
maximum-version
:
"1.21.8"
# Whether to kick players with unsupported versions from the entire network
kick-unsupported
: true
# Message for unsupported versions (if kick-unsupported is true)
unsupported-kick-message
:
"&cJouw Minecraft-versie wordt niet ondersteund op dit netwerk!\n&7Ondersteunde versies: &a1.20.x - 1.21.x\n&7Jouw versie: &e{version}"
servers
:
# Example configuration for Skyblock server
skyblock
:
# List of allowed Minecraft versions (use exact version strings)
allowed-versions
:
-
"1.21.1"
# Message to display when player is kicked for wrong version
kick-message
:
"&cSkyblock server requires Minecraft 1.21.1!\n&7You are using: &e{version}\n&7Please update your client."
# Whether to enable version checking for this server
enabled
: true
# Example configuration for Survival server (allows multiple versions)
survival:
allowed-versions
:
-
"1.20.1"
-
"1.20.2"
-
"1.20.4"
-
"1.21"
-
"1.21.1"
kick-message
:
"&cSurvival server requires Minecraft 1.20.1 or higher!\n&7You are using: &e{version}"
enabled
: true
# Example for Creative server (no restrictions)
creative:
allowed-versions
:
[
]
# Empty list means all versions allowed
kick-message
:
""
enabled
: false
# Default message for servers not configured above
default-kick-message
:
"&cThis server requires a different Minecraft version!\n&7You are using: &e{version}"
# Whether to enable debug logging
debug
: false