OVERVIEW

TL;DR:

• Foods contribute to nutrient categories which decay over time
• Higher Nutrition / Saturation foods will effect the categories more
• Players max health changes based on how high the average of your categories are
• Hunger increases over time to enable you to eat more (configurable)

Why use this mod?

• It does not work like "Spice Of" mods, and does not track any list of foods you've eaten
• It is designed to be an extremely lightweight user experience
  • Adds no new items
  • Hold shift to view relevant information on edible items
  • Intuitive default features
  • Intentionally Vague to prevent min-maxing and encourage expirementation
• Highly configurable & supports mods
  • See Config section below
• Makes traditionally unused food relevant and makes farming a necessity
• Can enable a more survival feeling without cluttering your game
• Built-in mod support for:
  • Artifacts
  • Ben's Sharks
  • Tide
  • Critters and Companions
  • Ends Delight
  • Minecolonies
  • More Delight
  • Nether Depths Upgrade
  • Oceans Delight
  • Rustic Delight
  • Farmer's Delight
  • Expanded Delight
  • Brewin and Chewin
  • Corn Delight

Quick Examples!

• To get max health you'll need to max all your categories. This makes things like cookies and beetroot more relevant than ever!
• Eating the same high saturation food to heal will max your hunger but will lower your max health over time.
• Would be great to have a dedicated cook / nutrition coach!
• Pairs incredibly well with other food mods (and you can add support for more yourself!)

DETAILS

How does the system work?

• Players track nutrition per-category, and these decrease over time
  • Is a value from 0-100
  • The default categories are Meat, Fruit, Veg, Carbs, Sweets
    • Can be changed in config
• The average of these categories is your nutrition score.
• Player max health is determined by their nutrition score.
  • A min-health value exists to prevent really low max health values.
• To increase a player's nutrition category, you must eat food that contains that nutrition.
• Food is setup in data as percentage of category
  • i.e. Apple is 100% fruit, whereas rabbit stew is 50% meat, 30% veg, and 20% carbs
• Food nutritional value is determined by its minecraft nutrition and saturation
  • i.e. Apple is 4 nutrition and 2.4 saturation, therefor its nutrition is calculated as
    • Apple = Fruit: (4 * NutritionModifier) + (2.4 * SatrationModifier)
    • The modifiers are set in configs

Why is X food set to only Y Category?

The balance design of this mod is to encourage food diversity. The more categories a food belongs to, the less diverse food you need to eat. Therefore, things like Apples (which have sugar in them naturally) do not contribute to the "sweets" category.

• This can be changed by configuring foods using datapacks!

Does this support mods?

Yes! You can create custom data packs to add information for modded items, or change the defaults of the ones I've configured.

data/ffnutrition/item_nutrition/MODNAME/item.json

example: data/ffnutrition/item_nutrition/minecraft/rabbit_stew.json
{
  "item": "minecraft:rabbit_stew",
  "values": [0.5, 0.0, 0.3, 0.2, 0.0]
}

• Each value is the percetnage the food is made up of that category.

Also you can change the categories

data/ffnutrition/item_nutrition/nutrition_categories.json

What's configurable?

Literally everything that I could think of / get working. You can do weird things like enable it for non-food items. I currently do it for milk!

Are there commands?

You bet! There's 2 sets of commands, one for general player use and another set for debugging.

Players

ffnutrition getNutritionDataVague [PLAYERNAME]

Debugging

These require permission level 2+

ffnutrition getNutritionData [PLAYERNAME]

ffnutrition maxAllNutrients [PLAYERNAME]

ffnutrition minAllNutrients [PLAYERNAME]

ffnutrition setAllNutrients [PLAYERNAME] [VALUE]

ffnutrition addToCategory [PLAYERNAME] [CATEGORY] [VALUE]

ffnutrition setCategory [PLAYERNAME] [CATEGORY] [VALUE]

OTHER

Can I use in modpacks?

Yes! That's what I initially designed this for.

Known issues

• Cake and block edible items are not supported
• This is my first substantial mod, there will surely be other bugs I'm unaware of

What is FF?

Fyxe's Features are small mods that are designed to be easily added (or removed) from any modpack. They often revolve around adding a few items or creating compatibility between mods in simple, non-intrusive ways.