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.
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
# 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
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
TerraVersions (Version blocker) is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 39 times (via Spigot). Download it and open it directly in the game.