ModsFinder

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.

FabricForgeNeoForgeServer-side onlyCreative Commons Attribution 4.01.20.1 – 1.21.6

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

  1. Overlap block predicate

    The exclusions lib:overlaps predicate checks whether a structure or nearby area overlaps a block position.

  2. Optional offset and range

    The predicate accepts an offset like other predicates, and a range of up to 32 blocks around the position.

  3. Tag blacklist field

    A blacklist field inside a tag removes listed entries from a broader vanilla tag without rewriting it.

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

1.21.61.0.2Not availableNot available
1.21.11.0.2Not available1.1.0-NEO
1.20.11.0.21.0.2Not available
ReleaseBetaAlphaNot available

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?

No. Server owners install it, and players connect with no copy of their own.

Which loaders does Exclusions Lib support?

Fabric and Forge files are published, and a separate NeoForge build is available. Files cover 1.20.1, 1.21.1 and 1.21.6.

Does a blacklist entry delete items from other mods?

It removes the entry from the tag where it is set, while the item stays in the shared tag that other mods feed, so their tag entries keep working.

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

All projects

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!
Athebyne, on the Modrinth page

Official listing

Owner
Athebyne
Published
2024-09-23
Updated on Modrinth
2026-01-21
Facts verified
2026-10-15

Tags