Food Overhaul

This is an overhaul of the food system. Eating food no longer fills the hunger bar or gives saturation. Each food item now grants a corresponding status effect instead.
These effects can grant attribute modifiers like increased health, more stamina or resistance against frost damage.

This gives players a real choice, when they decide what combination of food is the best for a given situation, which in my opinion is much more interesting than eating golden carrots all day.

Food Overhaul adds the back end system for this new food system, but it does not add gameplay content on its own.

This ensures that mod pack authors have the most possible control over how exactly their food items are balanced.

How does it work?

Items in Minecraft can apply status effects to the player when consumed. Food Overhaul uses that functionality and simply checks if one of those status effects is a "food effect".
If an item grants such an effect, the item can only be consumed when the player does not already have that food effect.

A status effect is considered a food effect when it is in the "foodoverhaul:food_effects" mob_effect tag.

Food Overhaul supports two different item types, consumables and potions. They are defined by having specific data components, namely "minecraft:consumable" and "minecraft:potion_contents", respectively.

What prevents a player from eating every available food?

Each player can only have a limited amount of food status effects active at a time. It's not possible to eat food when that limit is reached.
The limit is controlled by an entity attribute called foodoverhaul:max_food_effects and its default value is defined in the server config.

The player doesn't have to wait until an effect is completely gone to refresh it.
When a food effect is running out, it's corresponding food item can be consumed again. The exact threshold after which this is possible is set in the server config.

Food Overhaul adds the "foodoverhaul:remove_effects_in_tag" consume effect typ. It works very similar to the "minecraft:remove_effects" consume effect, but also works with status effect tags.

This can be used to remove all active food effects.

Customization

For 26.1+

Currently, no data-driven solution exists, that would allow modifying default data components of items.

For 1.21.1:

Food effects can be added to any item (even modded) by vanilla methods (mainly commands) or by using third party mods.

https://modrinth.com/mod/item-components and https://modrinth.com/mod/default-components both allow setting the default components of items via data packs.

This gives mod pack authors / players the option to use their own food effects.

Food Blocks

Food blocks can be interacted with to grant a status effect to the player. When that status effect is a food effect, interaction is only possible when the player doesn't already have the effect.

Food Overhaul provides a simple Java API for add-on mods to create food blocks.

Food Display Block

The Food Display Block can hold and display up to 4 items. When these items have the "minecraft:consumable" component, they can be consumed by interacting with the display block. The usual checks for existing food effects and hunger are applied.

The Food Display Block can be configured by creative mode players via a config screen.

Just want to play?

Food Overhaul - Vanilla Foods adds food effects to vanilla items.

Hunger and saturation

Food Overhaul does not remove these systems. They can be used in combination with the food effects.

By default, food items without a food effect can be eaten like normal. This can be disabled in the server config.

If the food system should be completely gone from your mod pack, maybe take a look at my mod Health Regeneration Overhaul, which can completely disable vanillas hunger system including saturation and exhaustion.