Food Overhaul
Food Overhaul represents a fundamental overhaul of the food system in Minecraft. Now when consuming food, the hunger bar is not replenished and saturation is not added. Instead, each food item grants the player a corresponding status effect. These effects can provide attribute modifiers such as increased health, enhanced stamina, or resistance to frost damage.
This allows players to make informed choices by selecting optimal food combinations for different situations. This approach is significantly more interesting than constantly consuming golden carrots.
It's important to note that Food Overhaul only adds the basic system for the new food mechanics but does not include ready-made gameplay content on its own. This gives mod pack authors maximum control over balancing food items.
How It Works
In Minecraft, items can apply status effects to the player when used. Food Overhaul utilizes this functionality by checking whether one of these status effects is a "food effect". If an item provides such an effect, it can only be consumed when the player doesn't already have that food effect.
A status effect is considered a food effect when it's in the mob_effect tag "foodoverhaul:food_effects".
The mod supports two types of items: food and potions, which are defined by having specific data components - "minecraft:food" and "minecraft:potion_contents" respectively.
System Limitations
Each player can have a limited number of active food effects simultaneously. When this limit is reached, consuming additional food becomes impossible. The limit is controlled by the entity attribute _generic.max_food_effects and defaults to 3.
Players don't need to wait for an effect to completely disappear to refresh it. When a food effect is about to expire, the corresponding food item can be consumed again. The exact threshold after which this becomes possible is configurable in the server settings.
There's also a way to remove all active food effects. Food Overhaul implements the RemoveFoodStatusEffect effect type. When effects of this type are applied, all FoodEffect and the RemoveFoodEffect itself are removed.
Configuration and Customization
Food effects can be added to any items (including modded ones) using standard Minecraft methods (primarily commands) or by using third-party mods. The Item Components and Default Components mods allow setting default components for items through data packs, giving mod pack authors and players the ability to use their own food effects.
Food Blocks
When interacting with food blocks, the player receives a status effect. If this effect is a food effect, interaction is only possible when the player doesn't already have that effect. Food Overhaul provides a simple Java API for creating food blocks in addons.
Ready Solutions
For those who want to start playing immediately, there's the Food Overhaul - Vanilla Foods addon, which adds food effects to standard Minecraft items.
Hunger and Saturation System
Food Overhaul does not remove these systems. They can be used in combination with food effects. By default, food items without food effects can be consumed normally. This can be disabled in the server settings.
If you want to completely remove the food system from your mod pack, consider using the Health Regeneration Overhaul mod, which can completely disable Minecraft's standard hunger system, including saturation and exhaustion.
