MariesLib

I wanted to pull out all the reusable code from Nourished and place it in one library. MariesLib is a shared library behind Marie's mods.

It handles the hard problems auto-classifying thousands of items from modded content, three-tier compat with modpack overrides, player tracking with memory and decay, datapack tooling with validation, a generic dynamic-UI framework, and more so consuming mods can focus on gameplay.

MariesLib 0.1.1-beta is still under development.

Development is ongoing as more systems are being refined, expanded, and stabilized. Recent work has focused on a full dynamic-UI editing framework (drag/resize, cross-component snapping, group edit mode, a slider-based config panel, and a pluggable command-center screen), a generic milestone system that works against any tracked value, and honest classification-confidence fixes across the scanner and runtime resolver.

More updates will be shared as development progresses.

Version 0.1.1-beta.4 is split into four modules:

• marie-core: classification, tracking, compat, registries, config, milestones
• marie-commands: command/KubeJS integration
• marie-resources: datapack tooling and validation
• marie-ui: the dynamic UI/editing framework

This modular structure keeps maintenance manageable and lets individual systems evolve independently.

Community

Discord Channel

Questions, suggestions, and development discussions are welcome. A lot of the bug fixes and new features came from here.

Do you need to install this?

Yes: if you use a mod that depends on it.

Mod loaders and launchers that resolve dependencies automatically should pull MariesLib in for you. If a Marie mod fails to load, check that MariesLib is present and up to date.

For mod developers

Every Marie mod requires MariesLib as a separate mod on the classpath. There is no JarJar bundling. Declare marieslib as a required dependency and wire your runtime through MarieContext at bootstrap.

What it provides

System What it does Classification Runtime source resolution, scanner tooling, and classification traces Compat discovery Three-tier compatibility registry with modpack overrides Registry lifecycle Lifecycle-aware registries with snapshots, freeze/reset, and reload support Tracking & values Player value tracking, memory windows, decay, and effect hooks Generic accumulator tracking Arbitrary numeric trackers (MarieTracking): daily/weekly/monthly periods with retained history, usable for anything a consuming mod wants to count Milestones One-time achievements, either against nutrient-style intake or against any MarieTracking tracker, registerable via Java, datapack JSON, or KubeJS Notifications A stacking, mergeable popup system anchored above the XP bar, for discrete player-facing events Dynamic UI Drag/resize, content-scale/padding editing, cross-component snapping, group edit mode, and a pluggable command-center screen see below Diagnostics Datapack validation, unknown-item logging, and debug commands Config tooling Presets, import/export, share codes, and module locks Utilities JSON helpers, bounded LRU cache, running averages, validation

It is designed to stay lightweight, modular, and reusable, and to provide a foundation rather than a gameplay framework.

The classification pipeline

This is the core of MariesLib.

When a consuming mod needs to reason about a source it has never seen before, MariesLib resolves it through staged runtime logic:

• Runtime resolution: with caching and cascade fallbacks
• Token normalization: for domain-specific source vocabulary
• Recipe inheritance: with honest, non-suppressive multi-value blending: a name-based keyword match no longer silently locks out a genuinely conflicting recipe signal; contested categories now show up with real, non-inflated confidence instead of a falsely "stable" result
• Override registries: via config/<modid>/source_overrides.json
• **Classification traces so developers can inspect exactly why a source resolved the way it did, step by step

There is also a developer-facing scanner for bulk analysis of unclassified or under-classified sources including multi-value detection (finding sources that should carry more than one category, like a composite recipe item spanning several value groups), an ambiguous-sources report for anything genuinely needing manual review, and a generated starter datapack of recommended tag entries. It is not a player-facing gameplay feature.

The exact pipeline is determined by the consuming mod. MariesLib provides the infrastructure; gameplay decisions remain the responsibility of the mod using it.

Milestones

A generic, one-time achievement system with two flavors:

• Value milestones: cumulative intake against a named value key (e.g. "reach 500 lifetime intake of X").
• Tracker milestones: the newer, fully generic version, working against any registered MarieTracking accumulator. MariesLib has no domain knowledge of what the tracker measures — mining blocks, kills, distance traveled, machine operations, spells cast, anything a consuming mod counts. Each milestone can check either a lifetime cumulative total or the tracker's current period value, and fires exactly once, ever, per player.

Tracker milestones can be registered three ways, and each fits a different kind of author:

Method Fits Java API Mod developers, compiled into the mod Datapack JSON Modpack authors and players — drop a JSON file in a world-save datapack, no recompiling KubeJS Scripting-focused modpack authors

On completion, a milestone can grant a potion effect and/or a vanilla advancement, and fires a listenable event (marie.trackerMilestoneTriggered in KubeJS) so any script or mod can react.

Dynamic UI

A full editing framework for building draggable, resizable, in-game UI panels: built once in MariesLib, usable by any consuming mod.

• Drag & resize: any panel can become player-repositionable and resizable with a couple lines of setup.
• Content scale & padding: independent of box size: growing or shrinking a panel never distorts its text, and a dedicated slider-card editor (ScaleConfigPanel, via the MarieScaleConfig facade) lets players tune text scale and padding directly, per panel.
• Cross-component snapping (SnapRegistry): any registered panel's edges can snap against any other registered panel's edges during drag, regardless of whether they share a parent: genuinely independent top-level panels can snap to each other.
• Group edit mode (EditModeCoordinator) — coordinate entering/exiting edit mode across multiple independent panels at once, instead of forcing players to toggle each one separately.
• Command Center: a shared, pluggable directory screen. Any consuming mod registers categories and cards into one common registry; a single screen renders all of them together, sidebar-navigated by category. Cards can open a config panel, run a command, or trigger any caller-supplied action.

Everything in this layer lives under dev.marie.framework.ui.api as the stable-facing entry point, with real usage-example javadoc on each facade.

Broad mod compatibility

MariesLib uses a three-tier compat system:

Tier Source Notes 1 data/<modid>/compat/compat_registry.json in the consuming mod Base registry 2 data/<other_modid>/marie_compat.json from loaded mods Mod-provided declarations 3 config/<modid>/compat_overrides.json Modpack overrides

Later tiers merge into earlier entries rather than replacing them wholesale — giving mod authors, addon authors, and modpack creators a predictable override path without recompiling.

Mods built on MariesLib

Mod Description Nourished Nutrition mod for NeoForge 1.21.1 ProjectE Extended Life (Planned) Thermal Systems (WIP)

For mod developers

MariesLib exposes a public API through MarieAPI, plus dedicated facades for specific systems:

// Value tracking float level = MarieAPI.getValueLevel(player, "Item"); MarieAPI.registerValue(definition); MarieAPI.registerCompatEntry(definition); MarieAPI.registerCustomEffect(thresholdEffect); // Generic accumulator tracking MarieTracking.registerTracker(TrackerDefinition.daily(id, retentionDays)); MarieTracking.incrementTracker(player, trackerId, amount); // Tracker milestones TrackerMilestoneRegistry.register( TrackerMilestoneDefinition.builder() .id("mymod:example_milestone") .trackerId(myTrackerId) .goal(100f) .scope(MilestoneScope.LIFETIME) .rewardEffectId(ResourceLocation.parse("minecraft:speed")) .build() ); // Notifications MarieNotifications.show(NotificationRequest.builder(content, durationTicks).build()); // Dynamic UI MarieScaleConfig.create(entries, persistenceProvider, Anchor.TOP_RIGHT); MarieCommandCenter.openScreen();

See the individual reference docs (TRACKER_MILESTONES.md and others) for full usage examples, datapack schemas, and KubeJS bindings.