OVERVIEW

TL;DR: (it's really simple I swear)

• Foods contribute to nutrient categories which decay over time
  • Based on their Nutrition/Saturation values
  • Decay rate is slower the higher level you are (config)
• Max Health is determined by how full all your categories are.
  • Can set minimum in config
• Changes a few food mechanics (all configurable)
  • Hunger increases over time
  • Can eat when full
  • Adds an item to see nutrition
• Supports popular mods by default
• (defaulted off) Can enable player category decay rate by name! (So people get hungry in different ways)

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 only 1 item
  • Tooltips are collapsed by default
  • Numbers are intentionally to prevent min-maxing and encourage expirementation
• Highly configurable & supports mods
  • See Config section below
  • Can easily add support for foods through simple json
• Makes traditionally unused food relevant
• Enhances the survival experiences and encourages diverse eating habits
• Built-in mod support for:
  • Artifacts
  • Ben's Sharks
  • Brewin and Chewin
  • Burnt
  • Critters and Companions
  • Cold Sweat
  • Corn Delight
  • Enderscape
  • Ends Delight
  • Expanded Delight
  • Farmer's Delight
  • Freeze it and Heat it
  • Minecolonies
  • More Delight
  • Nether Depths Upgrade
  • Oceans Delight
  • Rustic Delight
  • Tide & Tide2

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
{
  "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

• May have compatability issues with modded placed food blocks
• Probably not compatible with mods that modify player health (not tested)
• This is my first substantial mod, there will surely be other bugs I'm unaware of

What's with the FF prefix?

It stands for Fyxe's Features! Its a clean way to easily find all of my mods when changing configs or creating packs. Mods that are a part of the "FF" system are usually smaller and unintrusive. In the future, if I develop larger mods, it will be under another prefix.