Skip to content

Getting Started

Cursor Agent edited this page Jun 10, 2026 · 5 revisions

Getting Started

Nourished adds a five-group nutrition system to Minecraft. Eat a variety of foods to stay balanced and earn passive buffs β€” let any group drop too low and you'll start feeling the effects.


Requirements

Minecraft 1.21.1
Mod Loader NeoForge 21.1.x
MarieLib 1.0.0+ (separate install, required)
Recommended Cloth Config, Patchouli

Installation

  1. Download the latest Nourished and MarieLib releases from Modrinth
  2. Place both jars in your mods/ folder
  3. Launch the game β€” Nourished will generate its config files on first run

No additional setup is required. Nourished automatically classifies food from installed mods through MarieLib's scanner.


How It Works

Nourished tracks five food groups:

Group Neglect Penalty Balance Buff
🌾 Grains Weakness I βœ“
πŸ₯¦ Vegetables Slowness I βœ“
πŸ₯© Proteins Mining Fatigue I βœ“
🍎 Fruits Unluck I βœ“
πŸ₯› Dairy β€” βœ“

Balance buff: When all five groups are above 75%, you gain Health Boost I and Regeneration I passively.

Neglect penalty: When any penalized group drops below 25%, the corresponding debuff applies until you eat enough of that group to recover.

Dairy has no neglect penalty but still counts toward the balance buff.


The HUD

Five color-coded bars appear on your screen while you play. Press H to enter edit mode: drag the HUD anywhere, resize it, and anchor it to any corner.

See HUD & Display for all customization options.


The Diet Screen

Open your inventory and click the Nourished icon for a full nutrition overview: trend arrows, balance score, active effects, calorie tracking, recently eaten foods, and neglected categories.


Mod Compatibility

If a mod adds food with FoodProperties, Nourished handles it automatically through MarieLib's classification β€” no config files to write. For foods that aren't classified correctly, use Datapack Support or Community Tags.

Recipe inheritance allows complex foods to inherit nutrients from their ingredients β€” a hamburger may contribute grains, proteins, vegetables, and dairy depending on its recipe.


After Updating

If updating from an earlier 0.2.x version:

  1. Close Minecraft
  2. Delete config/nourished/scanner_spec.json
  3. Launch the game and load your world
  4. Run /nourished invalidatecache
  5. Leave and rejoin the world

This forces Nourished to rebuild its food classification cache and scanner data.


Need Help?


πŸ“š Related Pages

Clone this wiki locally