Minecraft's food mechancis are lackluster and I feel like most food related mods swing too far the other direction. This is my take on a nutrition system that is unobtrusive, interesting to use, and highly configurable. The goal is to make _all_ foods a relevant part of your playthrough. Uses directly set item nutrition data with a regex fallback for foods without one. --- ![xkcd comic about standards](https://imgs.xkcd.com/comics/standards.png) This is made for Minecraft version **1.21.1** and has been ported to further versions. Please report any bugs you encounter. ![Using the metabolic gauge](https://cdn.modrinth.com/data/cached_images/81a9c992122db6d09e42dd3e46c44815468e2f29_0.webp) # 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) ![Rabbit Stew, default tooltip](https://cdn.modrinth.com/data/cached_images/3178492021c73502fd6651848b64d9874b5578dd.png) --> ![Rabbit Stew advanced tooltip](https://cdn.modrinth.com/data/cached_images/c2cba7b2e1fcc529492f0f35f3d0a33a0af5ca0e.png) Seen here, tooltips are compatible using Thirst was taken, and Freeze it and Heat it. ## 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 ![Showcases the system on an apple.](https://cdn.modrinth.com/data/cached_images/1abe0f621323af18d56614a5c7197c3eaef828a4.png) ### 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!

Spoiler

- Nutrition Categories - Names - Amount of categories - Nutrition - Initial value - Decay per tick - Enable decay in creative - Max and Min health - Food Saturation and Nutrition modifier (minecraft nutrition, not FFNutrition) - Item Nutrition Fallback - Fully Enable/Disable - Nutrition values - Hunger Decay - Fully Enable/Disable - Amount of ticks - Hunger decay amount - Saturation decay amount - Enable in creative

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

Spoiler

``` ffnutrition getNutritionDataVague [PLAYERNAME] ``` - Will hint at your overall nutrition level - Will give you categories that you're very deficient in

#### Debugging These require permission level 2+

Spoiler

``` ffnutrition getNutritionData [PLAYERNAME] ``` - Gives you the exact nutrition score and category values ``` ffnutrition maxAllNutrients [PLAYERNAME] ``` - Sets all nutrient categories on the given player to 100 ``` ffnutrition minAllNutrients [PLAYERNAME] ``` - Sets all nutrient categories on the given player to 0 ``` ffnutrition setAllNutrients [PLAYERNAME] [VALUE] ``` - Sets all nutrient categories on the given player to VALUE ``` ffnutrition addToCategory [PLAYERNAME] [CATEGORY] [VALUE] ``` - Adds to the nutrient CATEGORY on the given player by VALUE ``` ffnutrition setCategory [PLAYERNAME] [CATEGORY] [VALUE] ``` - Sets the nutrient CATEGORY on the given player to 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 (or has weird interactions) with some mods that modify player health - 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. # Feedback If you have any ideas for improvements, questions, or concerns, I am open to communicating through email: [FyxeINCFeedback@gmail.com](mailto:FyxeINCFeedback@gmail.com)