Shield Lib

Library that makes it easy to add shields with banner support, enchantment support, & custom shapes without conflicts!

261.4K Downloads

fabricneoforgequiltequipmentlibraryutility

Rent Server with this Mod

About this Mod

Shield Lib Banner

Shield Lib is a library that makes it easy to add custom shields with banner support, enchantments, custom shapes, & custom effects across Fabric & Neoforge without conflicts!

We also provide event hooks & modifier registries for shields and shield enchantments for creating custom effects with them by modifying blocking, disabling, movement, or cooldown.

Enchanting:

Vanilla shield being enchanted

Custom Shapes:

Custom square shaped shield model in Blockbench, then in-game with globe banner pattern on it

Tooltips:

Vanilla shield with a new tooltip saying that when it's hit by an axe it will have 5 seconds of cooldown

Documentation?

The example mod repo is a template repo you can use to quickly get started if your making a new mod. Although it isn't updated as frequently.

Available Versions

Shield Lib 2.0.1+1.21.8-neoforgerelease

MC 1.21.8neoforge

November 12, 2025

Shield Lib 2.0.1+1.21.8-fabricrelease

MC 1.21.8fabric, quilt

November 12, 2025

Shield Lib 2.0.0+1.21.8-neoforgerelease

MC 1.21.6, 1.21.7, 1.21.8neoforge

September 12, 2025

Shield Lib 2.0.0+1.21.8-fabricrelease

MC 1.21.6, 1.21.7, 1.21.8fabric, quilt

September 12, 2025

Fabric Shield Lib 1.8.3-1.21.8release

MC 1.21.6, 1.21.7, 1.21.8fabric

July 30, 2025

How to Install Shield Lib 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.8).

Install Mod

Open the mod browser in the dashboard and search for "Shield Lib". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricneoforgequilt

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+38 more)

Server-side

✓ Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Shield Lib 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.8). You can switch loaders with one click in the panel.

Is Shield Lib compatible with fabric and neoforge and quilt?

Shield Lib officially supports fabric, neoforge, quilt for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Shield Lib – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Shield Lib 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.