Exclusions Lib
by Athebyne
Exclusions Lib is a server-side library that gives datapack makers two JSON levers: a block predicate for overlap checks and a tag field for blacklisting entries.
What it does
Exclusions Lib targets datapack work with vanilla JSON files. A new block predicate, exclusions lib:overlaps, takes a block position with an optional offset, as most other predicates do, and reports whether a structure or a range of blocks overlaps that position. The structures field limits the check to listed structures, while the range value, up to 32, sets the area checked around the position.
The tag system adds a blacklist field. A tag can then contain everything in a base tag, such as minecraft:small_flowers, except named entries like wither roses. Setting the excluded field to true on an added entry removes it while keeping the item in the shared tag, so other mods' tag entries still work. Its author notes that it can clean up edge-case items that other mods add.
Exclusions Lib runs on the server side only, so players join without installing it. It is published for Fabric and Forge, and NeoForge has a separate build. Files cover 1.20.1, 1.21.1 and 1.21.6, and the code is released under Creative Commons Attribution 4.0, which is not open source.
Key features
Overlap block predicate
The exclusions lib:overlaps predicate checks whether a structure or nearby area overlaps a block position.
Optional offset and range
The predicate accepts an offset like other predicates, and a range of up to 32 blocks around the position.
Tag blacklist field
A blacklist field inside a tag removes listed entries from a broader vanilla tag without rewriting it.
Excluded entries
An entry marked excluded is dropped from the tag, leaving other mods' entries in the same tag untouched.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Excluding flowers from a tag
A datapack can build a flower tag from minecraft:small_flowers and exclude wither roses, keeping new flowers from other mods.
Who it’s for: Datapack authors who need a JSON-only way to check overlaps or trim vanilla tags, especially when they want their changes to stay compatible with other mods that add content to the same tags.
Questions
Does Exclusions Lib have to be installed on the client?
Which loaders does Exclusions Lib support?
Does a blacklist entry delete items from other mods?
In the catalog
Exclusions Lib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,625 mods support Minecraft 1.21.6.
More from Athebyne
Similar mods
What the author says
A library for giving you more levers to use in vanilla json files. Everything here is only needed on the server, and not the client, so feel free to build your datapacks based off of this!
Official listing
- Modrinth page
- modrinth.com/mod/exclusions-lib
- Owner
- Athebyne
- Published
- 2024-09-23
- Updated on Modrinth
- 2026-01-21
- Facts verified
- 2026-10-15
