Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
Platforms
Supported environments
Creators
Details
Modpack Checker
A lightweight Fabric mod to verify that players use the correct modpack version on your server.
Features
- Simple version-based client-server check (no modlist comparison)
- Automatic disconnect with helpful messages
- Easy-to-edit TOML config files for both client and server
/reload
support to apply changes without restarting- Dev mode: use version
0.0.0
to disable checks during development
How It Works
- Server sends a version check during login
- Client replies with the version from
modpack-checker-client.toml
- Server compares it to its expected version
- If mismatched, the player is kicked with a custom message
Configuration
Server (config/modpack-checker-server.toml
):
enable = true
expected_version = "1.0.0"
[messages]
no_mod = "Please install the Modpack: <your-modpack-link>"
wrong_version = "Please install modpack version {version}: <your-modpack-link+version>"
server_error = "Server configuration error. Please contact an administrator."
Client (config/modpack-checker-client.toml
):
version = "1.0.0"