BrandBlock

Block certain client brands from joining your server

by
985 Downloads
fabricquiltmanagementutility
Rent Server with this Mod

Screenshots

Disconnection Message

About this Mod

BrandBlock

Simple Fabric server-side mod to block certain client brands from joining your server

Disconnection Message

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

1.4.0+1.20.5release
MC 1.20.5, 1.20.6, 1.21, 1.21.1fabric, quilt
August 31, 2024
1.3.0+1.20.3release
MC 1.20.3, 1.20.4fabric, quilt
August 31, 2024
1.2.0+1.20.2release
MC 1.20.2fabric, quilt
August 31, 2024
1.1.0release
MC 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1fabric, quilt
July 23, 2022
1.0.0release
MC 1.17, 1.17.1fabric
August 15, 2021

How to Install BrandBlock on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).

3

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

fabricquilt

Minecraft Versions

1.21.1, 1.21, 1.20.6 (+16 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install BrandBlock with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.11.211.20.61.20.51.20.41.20.31.20.21.20.11.201.19.4+9 more