Compatibility
Minecraft: Java Edition
1.20.4–1.20.6
Platforms
Supported environments
Client and server
Tags
Creators
Details
Licensed MIT
Published last month
Updated last month
ValiMod
ValiMod is an advanced server security and synchronization tool for Fabric that ensures connecting clients match the server's required mod environment.
Features
- Automated Handshake: Verifies client mod lists, version numbers, and active resource pack SHA-1 hashes during login.
- Anti-Bypass Protection: Enforces a 10-second connection timeout—clients that drop or ignore the handshake request are automatically kicked.
- Configurable Enforcement: Define required mods, exact versions, allowed mods, or blacklisted mods in
config/valimod.json. - Smarter Kick Messages: Displays stylized disconnect notices with optional clickable links so players can quickly download missing modpacks.
- Hot-Reload Support: Reload configuration files instantly using the
/valimod reloadcommand without restarting the server. - Warning Mode: Toggle
enforceKickstofalseto log violations without kicking players—perfect for auditing client environments safely.
Configuration
Edit config/valimod.json on your server to set your rules:
{
"enforceKicks": true,
"downloadUrl": "[https://modrinth.com/modpack/your-modpack](https://modrinth.com/modpack/your-modpack)",
"required_mods": [
"valimod",
"fabricloader@>=0.15.0"
],
"blacklisted_mods": [
"xray",
"freecam"
]
}
---
Commands
/valimod reload - Reloads config/valimod.json from disk (Requires OP level 2+).


