AspectsLib
by Overgrown
AspectsLib is a Fabric library mod that adds a data-driven aspect system, letting mod developers attach aspects to entities, items and blocks.
What it does
Aspects work like the Thaumcraft concept: each one is a tagged property that can be assigned to items, entities and blocks, and aspects can interact with one another. The library ships with a fixed set of built-in aspects arranged into four tiers, named Primal, Secondary, Tertiary and Quaternary. Pack makers can define new aspects through JSON datapacks without writing code.
Because it is a library, AspectsLib is meant to be used by other mods rather than played alone. It provides a full API so mod developers can extend the system. Installation requires Fabric API, and Overgrown's Sync is an optional dependency. The server and every player need the mod installed. The source code is open under the MIT License, and the issue tracker is public. Fabric 1.2.0 for 1.20.1 is the latest file, released 2026-02-20, and the project is also listed in the library category with magic, utility and world generation tags.
Key features
Built-in aspect hierarchy
A ready-made set of aspects arranged across four tiers gives a structure before any custom content is added.
Datapack-defined aspects
Custom aspects are declared in JSON, so new entries can be shipped in a datapack instead of code.
Aspect assignment
Aspects can be attached to items, entities and blocks, which is the basis for every interaction the system supports.
Aspect display in tooltips
Items show their aspects in tooltips with icons and values, making the assigned properties visible to players.
Resonance interactions
A calculation between aspects governs how they interact, so combinations produce results that depend on their values.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
How it compares
Aspect Ratio is client-side only and published for 1.20.1 – 1.20.6, so it covers a wider version range but does not run on the server; its license is All rights reserved. HotShot is server-side only, runs on Fabric and Quilt for 1.20 – 1.20.4, and is open source under the GNU Lesser General Public License v3.0 only.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| AspectsLib | Fabric | 1.20.1 | Client and server | 2026-02-20 |
| Aspect Ratio | Fabric | 1.20.1 – 1.20.6 | Client-side only | 2026-02-07 |
| HotShot | Fabric and Quilt | 1.20 – 1.20.4 | Server-side only | 2023-12-22 |
Questions
Does AspectsLib need Fabric API?
Does the server need AspectsLib?
Is Overgrown's Sync required?
Can custom aspects be added without Java code?
In the catalog
AspectsLib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 34,764 mods support Minecraft 1.20.1.
More from Overgrown
Similar mods
What the author says
AspectsLib is a comprehensive library mod that adds a customizable "aspect" system to Minecraft. It includes: 1. A complete hierarchy of 37 built-in aspects organized into four tiers (Primal, Secondary, Tertiary, Quaternary) 2. Tools to define custom aspects via JSON datapacks 3. Aspect assignment to items, entities…
Official listing
- Modrinth page
- modrinth.com/mod/aspectslib
- Owner
- Overgrown
- Published
- 2025-07-18
- Updated on Modrinth
- 2026-02-20
- Facts verified
- 2026-10-15