MariesLib

MariesLib is a shared NeoForge 1.21.1 library powering Marie’s mods. It provides runtime item classification, mod compatibility discovery, registry infrastructure, and developer utilities

Загрузки: 561
Подписчики: 0
Обновлён: 2 июля 2026 г.
Лицензия: LGPL-3.0-only

Опубликован 10 июня 2026 г.

Исходный код Сообщить об ошибке

Banner

Nourished grew to the point where its shared infrastructure deserved its own library. MariesLib is the shared foundation behind Nourished and future Marie mods. It is not a gameplay mod—it provides the reusable systems they build on.

So I pulled it out into one library. MariesLib is the shared backbone behind mods like Nourished. It is not a gameplay mod. It is the foundation for my other mods build on.

Community

Discord Channel

Questions, suggestions, and development discussion are welcome.

Do you need to install this?

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

MariesLib is a required library mod, not hidden infrastructure. Nourished currently requires MariesLib_v0.1.0-beta.1+ as a separate install alongside it.

Install both:

Nourished
MariesLib_v0.1.0-beta.1 or newer

Mod loaders and launchers that resolve dependencies automatically should pull MarieLib in for you. If Nourished fails to load, check that MarieLib 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 MarieLibContext at bootstrap.

What it provides

MariesLib handles shared infrastructure so Marie mods can focus on gameplay:

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 and reload support
Tracking & values	Player value tracking, memory windows, decay, and effect hooks
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—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: and multi-value blending where configured
Override registries: via config/<modid>/source_overrides.json
Classification traces: so developers can inspect why a source resolved the way it did

There is also a developer-facing scanner for bulk analysis of unclassified sources. In current Marie mods, that means items with FoodProperties, such as Nourished’s food classification workflow. 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.

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. That gives 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
ProjecT E Extended Life	(Planned)

For mod developers

MariesLib exposes a public API through MarieAPI:

float level = MarieAPI.getValueLevel(player, "Item");
MarieAPI.registerValue(definition);
MarieAPI.registerCompatEntry(definition);
MarieAPI.registerCustomEffect(thresholdEffect);

Ченджлог

0.1.1-beta.3Бета1.21.1 · 2 июля 2026 г.

MariesLib: 0.1.1-beta.5

Changes

Improved source classification stability when resolving external or cached overrides
Refined runtime classification tracing to better distinguish live inference vs cached results
Improved robustness of recipe-based nutrient inheritance fallback behavior
Internal pipeline adjustments for better handling of incomplete or non-standard recipe sources

Internal / Technical

Better separation between runtime inference and external classification overrides
Improved trace clarity for resolver cache hits and misses
Enhanced diagnostics output for unsupported recipe structures

Known Issue

Some Create mod cutting board recipes do not expose standard recipe data, preventing proper nutrient inheritance.

Example:

createfood:hamburger_onion may miss protein classification
createfood:hamburger_onion_lettuce resolves correctly due to explicit ingredient chain

Cause

These recipes are not registered in a way the inheritance system can resolve, causing fallback to name-based inference.

Impact

Some composite foods may be inconsistently classified

Status

Not fixable in this release
Requires Synthetic Recipe Resolver (future system)
Confirmed via trace analysis and reproduction

0.1.1-beta.2Бета1.21.1 · 28 июня 2026 г.

MarieLib 0.1.1-beta.2

This update expands MarieLib's tooling for both mod developers and modpack authors, with a new configuration validation framework, tag-audit system, improved developer commands, and several internal improvements to the classification pipeline.

Highlights

✅ Configuration Validation Framework

Mods built on MarieLib can now register their own configuration validators.

New validation commands provide structured PASS / WARN / FAIL results with detailed findings, making it much easier to diagnose configuration issues without digging through log files.

Highlights include:

ConfigValidator API
ValidationResult / Finding API
Per-mod validation runner
/\<modid> validate

🔍 Tag Audit Framework

MarieLib now includes a complete tag-audit system for developers.

Tag rules can inspect registered tags, identify inconsistencies, and generate suggested fixes automatically.

The framework includes:

TagScanner
TagRule API
TagReport
TagIssue
TagFixSuggestion

This is intended to make maintaining large food registries significantly easier.

🛠 Developer Commands

Several new commands have been added for MarieLib-based mods.

/\<modid> validate
- Runs all registered configuration validators.
/\<modid> analyze <item>
- Produces a detailed classification trace for any food item.
/\<modid> set_all
- Sets every registered value for a player simultaneously.

These commands are designed to simplify debugging and balancing during development.

📈 API Improvements

New public APIs have been added for:

Config validators
Export resolvers
Tag audit registration
Source classification inspection

The RecipeInheritanceResolver has also been expanded to support pre-built recipe indexes for improved runtime performance.

🧹 Internal Improvements

Improved scanner-spec loading
Better command registration
Additional export and tag-audit support
Improved classification infrastructure

These changes primarily improve reliability and reduce unnecessary logging for consuming mods.

Notes

Published artifact version: 0.1.1-beta.2

As always, thanks to everyone testing MarieLib and providing feedback. Several improvements in this release were driven directly by real-world testing from the community.

0.1.1-beta.1Бета1.21.1 · 22 июня 2026 г.

MariesLib 0.1.1-beta.1

What's New

Milestone system: Cumulative intake milestones are fully operational. They track lifetime totals per value key, fire once per player, and can grant potion effects and/or vanilla advancements on completion. Define them via datapack JSON or KubeJS scripts.

KubeJS: advancementId support added to registerMilestone(). MarieEvents.milestoneTriggered event bridge added for reacting to completions in scripts.

Export framework: New ExportResolver<T> API for consuming mods to export per-registry-entry data to editable JSON. Register with MarieAPI.registerExportResolver, then run:

/marieslib dump <resolverId>
/marie dump <resolverId>

Output is written to config/<modid>/<resolverId>_export.json.

Config validation: New ConfigValidator API for consuming mods to validate their own config files on demand. Register with MarieAPI.registerConfigValidator, then run:

/marieslib validate <modid>
/marie validate <modid>
/<modid> validate

Tag audit: New tag-audit framework for consuming mods to register rules and scan tag data for issues. Register with MarieAPI.registerTagRule and MarieAPI.registerTagAuditContext, then run:

/marieslib audit_tags <modid>
/marie audit_tags <modid>

Report is written to config/<modid>/tag_audit_report.json.

Explicit bootstrap: Consuming mods must now call MariesLibBootstrap.attach or bootstrap explicitly. MariesLib no longer auto-bootstraps when MarieLibContext is unregistered.

Fixed

Bundled scanner_spec.json now loads from the consuming mod's jar instead of failing with Bundled scanner_spec.json missing.

Notes

Requires explicit bootstrap wiring — see MariesLibBootstrap.attach.
Nourished 0.2.6-beta.1+ is required to use the milestone system end-to-end.
Toolkit commands (scan, diagnostics, reload, etc.) remain under each consumer mod's namespace (e.g. /nourished scan). Library-only commands (status, mods, api, registries, dump, validate, audit_tags) are on /marieslib and /marie.

0.1.0-beta.5Бета1.21.1 · 19 июня 2026 г.

MarieLib 0.1.0-beta.5 {2026-06-16}

Added

Added MarieValueColors.resolvedDefaultArgb(String key)
- Returns the true default ARGB value for a value key
- Checks ValueDefinition.colorOverride first
- Falls back to the built-in palette
- Ignores transient overrides when detecting actual customization
Added per-value decay rate resolution:
- IMarieLibConfig.decayRateFor(String valueKey)
- MarieLibContext.Builder.decayRateFor(Function<String, Float>)
- Uses configured values when available
- Falls back to default decay rates

Fixed

Fixed ARGB parsing for 0x / 0X color values
- Full ARGB literals now parse correctly
Fixed value decay rates ignoring config overrides
- Consuming mods can now properly customize decay behavior
Fixed decay display commands using hard-coded defaults
- Commands now show resolved configured decay rates
Fixed API/KubeJS registered classifications being lost during reloads
- External classifications now survive tag reload passes
Fixed missing translation names in CriticalValueToast
- Falls back to the raw value key instead of displaying translation paths

Notes

Published artifact version: 0.1.0-beta.5

0.1.0-beta.4Бета1.21.1 · 16 июня 2026 г.

Fixed

SourceRegistry registration logs dropped from INFO to DEBUG, no more per-item classification spam on every reload
External classification cap warnings now log once per item per server session instead of repeating on every reload

0.1.0-beta.3Бета1.21.1 · 16 июня 2026 г.

What's New

Datapack Support

Effect definitions now parse correctly from datapacks: no more "not yet implemented" warnings
comment* keys in datapack JSON are silently skipped: no false validation warnings Milestone definitions fully load from
Milestone definitions fully load from data///milestones/.json at datapack apply time

Milestone System

Cumulative intake now accumulates at runtime per player and per value key
Milestones fire on first completion, grant mob effects, and award advancements
MilestoneProgressData and MilestoneProgressAttachment persist cumulative intake and completion state across sessions and death
generate_milestone_template command writes a starter milestone + advancement datapack to your world folder

Colors

MarieEvents.MilestoneTriggeredEvent: fired on milestone completion: getPlayer(), getMilestone(), getValueKey(), getCumulativeIntake()
KubeJS milestoneTriggered — playerId, milestoneId, valueKey, cumulativeIntake, cumulativeGoal

Fixes

neoforge.mods.toml dependency entries corrected
EMI / REI / JEI plugin registration
Mod icon asset paths normalized
Milestone progress attachment now correctly copies on death

0.1.0-beta.2Бета1.21.1 · 14 июня 2026 г.

Added

Configurable death respawn behavior for tracking bars (preserve, reset_to_starting, vanilla_half)
Consuming mods can override death handling via MarieLibContext
Initial bar fill now uses your mod's startingValueFill config instead of a fixed 50%

Changed

Default death behavior is now preserve (bars kept on respawn)
Several API types promoted to @Stable for addon authors
Admin value commands and KubeJS bindings use the shared value write pipeline

Fixed

neoforge.mods.toml dependency entries
EMI / REI / JEI plugin registration
Mod icon asset paths

0.1.0-beta.1Бета1.21.1 · 10 июня 2026 г.

marieslib-0.1.0-beta.1

First Stable Beta of the shared library powering Marie mods on NeoForge 1.21.1.

Highlights

Item scanner: auto-classifies modded food and items with token stemming, recipe inheritance, and confidence validation; outputs tag recommendations and diagnostic reports
Three-tier compat: mod, addon, and modpack override layers via JSON without recompiling
Player tracking: memory windows, decay, diminishing returns, streaks, synergies, milestones, and threshold effects
Classification traces: inspect every pipeline stage and scoring decision for debugging
Datapack support: source classifications, compat entries, source families, and module locks
Integrations: KubeJS scripting, Cloth Config presets/import-export, JEI/REI/EMI tooltips
Stable API: MarieAPI and MarieLibContext with @Stable / @Experimental markers

Requirements

Minecraft 1.21.1
NeoForge 21.1.x
Java 21

Note

MariesLib is required as a separate install alongside any Marie mod that depends on it. It is infrastructure, not standalone gameplay.

Community

Do you need to install this?

For mod developers

What it provides

The classification pipeline

Broad mod compatibility

Mods built on MariesLib

For mod developers

Ченджлог

MariesLib: 0.1.1-beta.5

Changes

Internal / Technical

Known Issue

Cause

Impact

Status

MarieLib 0.1.1-beta.2

Highlights

✅ Configuration Validation Framework

🔍 Tag Audit Framework

🛠 Developer Commands

📈 API Improvements

🧹 Internal Improvements

Notes

MariesLib 0.1.1-beta.1

What's New

Fixed

Notes

MarieLib 0.1.0-beta.5 {2026-06-16}

Added

Fixed

Notes

Fixed

What's New

Datapack Support

Milestone System

Colors

Fixes

Added

Changed

Fixed

marieslib-0.1.0-beta.1

Highlights

Requirements

Note

Комментарии

Открытый код