BrandBlock
Block certain client brands from joining your server
Screenshots

About this Mod
BrandBlock
Simple Fabric server-side mod to block certain client brands from joining your server

Configuration
config/brandblock.json
{
"blockedBrands": [ // All brands that will be blocked
"forge",
"vanilla"
],
"kickMsg": "This client brand is not allowed" // The disconnection reason shown to the player, can be in Raw JSON text format
}
How it works?
When joining a server, during the configuration phase, both the server and client send a minecraft:brand custom payload packet (aka plugin message) containing the brand name. For unmodified clients and servers, this brand is always "vanilla." However, custom clients (such as Forge, Fabric, etc.) typically change this brand identifier.
This server-side mod listens when a brand payload is received and checks if it matches any blocked brands specified in the configuration file. If a blocked brand is detected, the player is disconnected from the server. However, this can be easily bypassed and modified clients may not to send this packet at all.
Available Versions
How to Install BrandBlock on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "BrandBlock". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21, 1.20.6 (+16 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
BrandBlock server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is BrandBlock compatible with fabric and quilt?
BrandBlock officially supports fabric, quilt for Minecraft 1.21.1, 1.21, 1.20.6. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with BrandBlock – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if BrandBlock consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install BrandBlock with just one click on your server.