Description
Gallery
Changelog
Versions

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:
Custom Shapes:

Tooltips:

Pages:
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.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 | ||||
| 20h ago | 1 |
[2.0.1+1.21.8-neoforge] Shield Lib 2.0.1+1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
## Whats Changed:
- Changes**:
- Tweaked the default Targe Shield model to be easier to make banner patterns for.
- Fixes**:
- Added missing null check when checking for shield enchantments.
[2.0.1+1.21.8-fabric] Shield Lib 2.0.1+1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
## Whats Changed:
- Changes**:
- Tweaked the default Targe Shield model to be easier to make banner patterns for.
- Fixes**:
- Added missing null check when checking for shield enchantments.
[2.0.0+1.21.8-neoforge] Shield Lib 2.0.0+1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
## Whats Changed
- FabricShieldLib is now ShieldLib
- Near-Complete rewrite of the library
- Heavily reduced class inheritance(pretty much everything is an interface).
- Library has it's own internal registries for modifying shield behavior.
- Support for NeoForge
- Support for Quilt(As Long as it doesn't cause issues)
- New shield tooltips showing speed while blocking.
- Supports custom shield shapes(with banners)
- Had to remove Russian & Ukrainian translation(hopefully I'll get it translated again).
- Added Norwegian, Portuguese, & Simplified Chinese translations.
- Added pre-made shield types for modders to use:
- Tower(Vanilla Style)
- Buckler
- Heater
- Targe
- Removed FabricASM dependency (Manningham Mills)
- Added several new event hooks
- BLOCK
- BLOCK_FAIL
- CAN_BLOCK
- ATTACK
- COLLIDE
- DISABLE
[2.0.0+1.21.8-fabric] Shield Lib 2.0.0+1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
## Whats Changed
- FabricShieldLib is now ShieldLib
- Near-Complete rewrite of the library
- Heavily reduced class inheritance(pretty much everything is an interface).
- Library has it's own internal registries for modifying shield behavior.
- Support for NeoForge
- Support for Quilt(As Long as it doesn't cause issues)
- New shield tooltips showing speed while blocking.
- Supports custom shield shapes(with banners)
- Had to remove Russian & Ukrainian translation(hopefully I'll get it translated again).
- Added Norwegian, Portuguese, & Simplified Chinese translations.
- Added pre-made shield types for modders to use:
- Tower(Vanilla Style)
- Buckler
- Heater
- Targe
- Removed FabricASM dependency (Manningham Mills)
- Added several new event hooks
- BLOCK
- BLOCK_FAIL
- CAN_BLOCK
- ATTACK
- COLLIDE
- DISABLE
[2.0.0-beta.8+1.21.8-neoforge] Shield Lib 2.0.0-beta.8+1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
- Finished targe shield banner pattern set.
- Added Simplified Chinese translation.
- Added Brazilian Portuguese translation.
[2.0.0-beta.8+1.21.8-fabric] Shield Lib 2.0.0-beta.8+1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
- Finished targe shield banner pattern set.
- Added Simplified Chinese translation.
- Added Brazilian Portuguese translation.
[2.0.0-beta.7-1.21.8-neoforge] Shield Lib 2.0.0-beta.7-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
Additions:
- Bucklers now don't block arrows by default.
- Custom tag-based cooldowns now registerable with mod.
- Reorganized package structure.
- Added
hit_spiked_shield&collide_spiked_shielddamage types. - Spiked shields do damage on entity collision now.
- added
CAN_BLOCKBLOCK_FAILBLOCKATTACKShieldEvents. - Norwegian Bokmal & French translations working.
[2.0.0-beta.7-1.21.8-fabric] Shield Lib 2.0.0-beta.7-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
Additions:
- Bucklers now don't block arrows by default.
- Custom tag-based cooldowns now registerable with mod.
- Reorganized package structure.
- Added
hit_spiked_shield&collide_spiked_shielddamage types. - Spiked shields do damage on entity collision now.
- added
CAN_BLOCKBLOCK_FAILBLOCKATTACKShieldEvents. - Norwegian Bokmal & French translations working.
[2.0.0-beta.6-1.21.8-neoforge] Shield Lib 2.0.0-beta.6-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- Added
targeshield type. - Architectury is now included in .jar
[2.0.0-beta.6-1.21.8-fabric] Shield Lib 2.0.0-beta.6-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- Added
targeshield type. - Architectury is now included in .jar
[2.0.0-beta.5-1.21.8-neoforge] Shield Lib 2.0.0-beta.5-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- reworked how I build the .jar so it should run outside of my IDE lol.
[2.0.0-beta.5-1.21.8-fabric] Shield Lib 2.0.0-beta.5-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- reworked how I build the .jar so it should run outside of my IDE lol.
[2.0.0-beta.4-1.21.8-neoforge] Shield Lib 2.0.0-beta.4-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
### Changes:
vanillashields are nowtowershields.- Added
ShieldInformationcomponent - Added spiked variants of all shield types
- Remade config it will need to be translated again :(
[2.0.0-beta.4-1.21.8-fabric] Shield Lib 2.0.0-beta.4-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
### Changes:
vanillashields are nowtowershields.- Added
ShieldInformationcomponent - Added spiked variants of all shield types
- Remade config it will need to be translated again :(
[2.0.0-beta.3-1.21.8-fabric] Shield Lib 2.0.0-beta.3-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
### Additions:
- Added
heatershield shape - Added model & textures for heater shields
- Made all 48 vanilla banner patterns for heater shields
[2.0.0-beta.3-1.21.8-neoforge] Shield Lib 2.0.0-beta.3-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
### Additions:
- Added
heatershield shape - Added model & textures for heater shields
- Made all 48 vanilla banner patterns for heater shields
[2.0.0-beta.2-1.21.8-fabric] Shield Lib 2.0.0-beta.2-1.21.8-fabric
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- Fixed version of mod being broken...
- Mods can now register
ShieldCooldownModifiers - Mods can now register
ShieldMovementModifiers banner_shieldis nowvanilla_shieldeverywhere.
[2.0.0-beta.2-1.21.8-neoforge] Shield Lib 2.0.0-beta.2-1.21.8-neoforge
by StellarWind22 on Oct 15, 2026
Download
### Changes:
- Fixed version of mod being broken...
- Mods can now register
ShieldCooldownModifiers - Mods can now register
ShieldMovementModifiers banner_shieldis nowvanilla_shieldeverywhere.
[neoforge-2.0.0-beta] Shield Lib NeoForge 2.0.0-beta for 1.21.8
by StellarWind22 on Oct 15, 2026
Download
### Complete rebuild of library!
- Custom shield shapes /w banners now supported.
- Enchantments fully working in 2.0
- Supports fabric AND neoforge!!
[fabric-2.0.0-beta] Shield Lib Fabric 2.0.0-beta for 1.21.8
by StellarWind22 on Oct 15, 2026
Download
### Complete rebuild of library!
- Custom shield shapes /w banners now supported.
- Enchantments fully working in 2.0
- Supports fabric AND neoforge!!
[1.8.3-1.21.8] Fabric Shield Lib 1.8.3-1.21.8
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
Thanks to @rikka0w0 for major work on this release!
- Internal library cleanup/optimization
- Streamlined process for adding banner support to shields (fully data-driven now)
- Removed
FabricShieldinterface, an item is now classified as a shield if it containsBLOCKS_ATTACKS - Two new tags -
supports_bannerandno_tooltip, replacing the previous interface options
- Full Changelog**: https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.1-1.21.6...v1.8.3-1.21.8
Thanks to @rikka0w0 for major work on this release!
[1.8.3-1.21.5] Fabric Shield Lib 1.8.3-1.21.5
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
Thanks to @rikka0w0 for major work on this release!
- Internal library cleanup/optimization
- Streamlined process for adding banner support to shields (fully data-driven now)
- Removed
FabricShieldinterface, an item is now classified as a shield if it containsBLOCKS_ATTACKS - Two new tags -
supports_bannerandno_tooltip, replacing the previous interface options
- Full Changelog**: https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.1-1.21.5...v1.8.3-1.21.5
Thanks to @rikka0w0 for major work on this release!
[1.8.1-1.21.6] Fabric Shield Lib 1.8.1-1.21.6
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
- 1.21.6 Port by [@CringeStar](https://github.com/CringeStar) in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/208
[1.8.1-1.21.5] Fabric Shield Lib 1.8.1-1.21.5
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
\*Full Changelog\*: [https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.0-1.21.4…v1.8.1-1.21.5](https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.0-1.21.4…v1.8.1-1.21.5)
- Port to 1.21.5 by [@rikka0w0](https://github.com/rikka0w0) in [https://github.com/StellarWind22/Fabric-Shield-Lib/pull/206](https://github.com/StellarWind22/Fabric-Shield-Lib/pull/206)
- Removed \
FabricBannerShieldItem \- all shields are now made with \FabricShieldItem\, and components dictate further functionality - The presence or lack of \
FabricShieldModelComponent \determines banner functionality - Shields can still be made with previous constructors, however, new constructors are available for the usage of the \
BLOCKS\_ATTACKS\component. - Several component helpers have been added to \
FabricShieldUtils\- the base Vanilla component as a constant/reference and methods that can take in a component and change just one value, depending on the method. These methods will later be wrapped into a builder class. - Migrated to \
BLOCKS\_ATTACKS\rather than \c:shields\for detecting shields, such as for universal disable - New \
FabricShieldUtils\methods added with vanilla & default shield \ItemSettings\. - Updated dependencies
\*Full Changelog\*: [https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.0-1.21.4…v1.8.1-1.21.5](https://github.com/StellarWind22/Fabric-Shield-Lib/compare/v1.8.0-1.21.4…v1.8.1-1.21.5)
[1.8.0-1.21.4] Fabric Shield Lib 1.8.0-1.21.4
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
## New Contributors
- Internal optimization
- getCooldownTicks has itemstack context now
- Model predicates must be made in .json per each shield in assets/modid/items
- Builtinitemrendererregistry is has been migrated to a data component
- When creating a banner shield, users add their SpriteIdentifiers and the entitymodelayer into the custom component
## New Contributors
- Thanks to New mixin @imverybad on discord for providing a necessary mixin!
[1.8.0-pre1-1.21.3] Fabric Shield Lib 1.8.0-pre1-1.21.3
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
## New Contributors
- Port to 1.21.3 by @rikka0w0 in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/182
- Internal Library Optimization by @rikka0w0
## New Contributors
- @rikka0w0 made their first contribution in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/182
[1.7.2-1.21.1] Fabric Shield Lib 1.7.2-1.21.1
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
- Updated to 1.21.1 by @CringeStar in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/180
- FabricShieldEnchantment removed due to 1.21 changes
[1.7.2-1.20.6] Fabric Shield Lib 1.7.2-1.20.6
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
- Updated to 1.20.6 by @CringeStar in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/179
[1.7.2-1.20.4] Fabric Shield Lib 1.7.2-1.20.4
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
- Updated to 1.20.4 by @CringeStar in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/172
[1.7.2-1.20.1] Fabric Shield Lib 1.7.2-1.20.1
by StellarWind22 on Oct 15, 2026
Download
## What's Changed
- Did backport for 1.20.1 due to compatibility issue by @CringeStar in https://github.com/StellarWind22/Fabric-Shield-Lib/pull/173


