Skip to content

Getting Started

Jump to bottom
Maire edited this page Jun 2, 2026 · 5 revisions

Getting Started

Nourished adds a six-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
Required Cloth Config V15, Patchouli

Installation

  1. Download the latest release from Modrinth
  2. Place the jar in your mods/ folder alongside Cloth Config and Patchouli
  3. Launch the game — Nourished will generate its config files on first run
  • No additional setup is required. Nourished automatically scans all installed food mods and classifies items into nutrient categories.

How It Works

Nourished tracks six food groups:

Group Neglect Penalty Balance Buff
🌾 Grains Weakness I ✓
🥦 Vegetables Slowness I ✓
🥩 Proteins Mining Fatigue I ✓
🍎 Fruits Unluck I ✓
🍬 Sugars — —
🥛 Dairy — ✓

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

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

  • Sugars and Dairy have no neglect penalty but Dairy still counts toward the balance buff.

The HUD

  • Six 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.

You can configure HUD behavior under Options → Mod Options → Nourished → HUD & Display:

  • Hide bars that are above a threshold (so they only appear when you need them)
  • Show bars temporarily when a nutrient increases from eating
  • Toggle zero bars, vertical layout, and background opacity

The Diet Screen

  • Open your inventory and click the Nourished icon to pull up your full nutrition overview. It shows trend arrows, your 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 its classification pipeline — no config files to write. For foods that aren't classified correctly, you can fix them instantly using Datapack Overrides.

  • If you find a food that's missing or wrong, open an issue and it'll be added to the bundled tags in the next release.

  • Recipe inheritance allows complex foods to inherit nutrients from their ingredients, enabling accurate multi-nutrient classifications across large modpacks. A hamburger, for example, may contribute grains, proteins, vegetables, and dairy depending on its recipe.

After Updating

If updating from an earlier 0.2.x version:

Required steps

  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

What this does

This forces Nourished to rebuild its:

  • food classification cache
  • scanner data
  • recipe inheritance results

This ensures all foods use the latest compatibility rules.

⚠ Note (0.2.x Beta)

During 0.2.x beta releases, manual cache invalidation may be required when updating due to ongoing changes in the classification system.

This will be handled automatically in a future release.

Troubleshooting

If foods still appear outdated after updating:

  • repeat /nourished invalidatecache
  • rejoin the world

Need Help?

Nourished · Food variety finally matters · Documentation for 0.2.x

Modrinth · GitHub · Report an Issue

Clone this wiki locally