Teal Lib
by Ninni
Teal Lib is a NeoForge library mod for 1.21.1 that supplies shared utilities and data-driven systems for other mods' entities and block entities.
What it does
Teal Lib adds an animation system built on vanilla keyframes, letting mod developers drive mob and block animations from shared definitions instead of custom code. Entity and block entity variants are defined in data files through a data-driven variant system, not hard-coded in the source.
Variants are backed by a new variant data registry type, which gives further customization over mob variants, such as assigning a specific color to a variant. The mod also offers a simple way to store released mobs as items. Its common utilities are meant to be reused across development projects, so mods that depend on it share the same helper code instead of each bundling its own copy.
Teal Lib runs on NeoForge only, with files for 1.21.1. It is needed on both the client and the server. The license is a custom one, and the mod is not open source. Public links exist for the source code, issue tracker and wiki. The latest file, 1.3.teal, was published on 2026-07-25, and the first release dates from 2026-07-04.
Key features
Keyframe animation system
Animations are built on vanilla keyframes, so mod authors can reuse one animation framework across their entities.
Data-driven variants
Entity and block entity variants are defined through data, without changing the code of the mobs that use them.
Variant data registry
A new registry type holds variant data, so variant definitions can be added and referenced like other registered content.
Stored mob items
Released mobs can be kept as items, providing a simple way to store and place them again.
Shared utilities
Common helper code is collected in one library, so dependent mods do not each carry their own copy.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Required by 2 mods
Use cases
Who it’s for: Mod developers building mobs or block entities for NeoForge 1.21.1 will find the animation, variant and utility systems most useful. Players mainly encounter Teal Lib through the mods that require it, such as Spawn and Peaceless.
How it compares
Mixed Litter is a NeoForge mod for 1.21.1 that runs on the client and server, but it is not open source and carries an All rights reserved license. ItemOverlayState is a NeoForge mod for 1.21.1 that is client-side only and released under the GNU Lesser General Public License v3.0 or later, so it does not involve the server. Research Tree is also NeoForge for 1.21.1, client and server, under the Apache License 2.0 and open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Teal Lib | NeoForge | 1.21.1 | Client and server | 2026-07-25 |
| Mixed Litter | NeoForge | 1.21.1 | Client and server | 2026-06-11 |
| ItemOverlayState | NeoForge | 1.21.1 | Client-side only | 2025-11-07 |
| Research Tree | NeoForge | 1.21.1 | Client and server | 2026-03-25 |
Questions
Does Spawn need Teal Lib?
Is Teal Lib needed on the server?
Does Teal Lib work on Fabric?
In the catalog
Teal Lib is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from Ninni
Similar mods
What the author says
Library mod I made that provides some common utils for the development of my mods, as well as generally shared code among them. It also features: - A new Animation system based on the Vanilla Keyframes - Fully data driven Variant system for Entities and Block entities - A new Variant Data registry type that's used by…
Official listing
- Modrinth page
- modrinth.com/mod/teallib
- Owner
- Ninni
- Published
- 2026-07-04
- Updated on Modrinth
- 2026-07-25
- Facts verified
- 2026-10-15