MariesLib
by kgbcupcake
MariesLib is a shared NeoForge library for 1.21.1 that supplies reusable infrastructure to the author's other mods.
What it does
The library provides runtime item classification, mod compatibility discovery, a registry layer and developer utilities. It is intentionally focused on framework infrastructure and adds no gameplay mechanics of its own. Consuming mods supply the actual gameplay rules, while MariesLib holds systems that would otherwise be implemented separately in each project.
It is server-side only, so only the server needs it and players join without installing anything. It requires Cloth Config API, and Nourished is one of the mods that depend on it. The library is split into several modules, targets Minecraft 1.21.1 on NeoForge with Java 21, and is released under the GNU Lesser General Public License v3.0 only, so its source code is open. Its public links cover the source code, the issue tracker and a wiki.
Key features
Value tracking
Persistent player values can track decay thresholds, effects, diminishing returns, source memory and synergies.
Generic counters
Counters that can be reused across mods tally events like blocks broken, mobs killed, distance covered and machine runs.
Item classification
Items can be classified through tags, namespaces, keywords, recipes, weighted signals, overrides and exclusions, with runtime resolution.
Data-driven resources
Resource systems read JSON configuration and datapack-driven definitions, along with overrides.
Dynamic UI components
Shared widgets include draggable and resizable panels, notifications, rendering utilities and a Command Center.
Developer tooling
Framework commands, diagnostics, classification tracing and request and response networking help developers debug their mods.
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
Required by 1 mod
Use cases
Building a consuming mod
Developers who write NeoForge mods for 1.21.1 can reuse counters, classification and UI components instead of building them separately.
Tuning item behavior
Server owners and pack authors can adjust classification through tags, overrides and exclusions in configuration files and datapacks.
Who it’s for: The library suits developers building NeoForge mods for 1.21.1, and pack authors who run mods that depend on it.
Questions
Does MariesLib need to be installed on the client?
What does MariesLib require?
Which mods depend on MariesLib?
Can the library be used in other projects?
In the catalog
MariesLib is one of 29,952 Game mechanics mods on ModsFinder, and one of 12,140 Game mechanics mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from kgbcupcake
Similar mods
What the author says
MariesLib is a shared development library for my NeoForge mods. It contains reusable systems that would otherwise have to be implemented separately in each project. It is intentionally focused on framework infrastructure rather than providing its own gameplay mechanics.
Official listing
- Modrinth page
- modrinth.com/mod/marieslib
- Owner
- kgbcupcake
- Published
- 2026-06-10
- Updated on Modrinth
- 2026-10-02
- Facts verified
- 2026-10-15