Grounded Compatibility Tweaks

# Grounded Compatibility — Complete Changelog

## 1.6.1 — Mechanical Saw Tree Bark

### Added

- Create mechanical-saw stripping now produces one Farmer's Delight Tree Bark
  per processed log or wood block.
- Uses Minecraft's registered axe-stripping map, automatically covering
  vanilla and correctly registered modded woods.
- Verifies that the saw actually produced the registered stripped block before
  adding bark.

### Safety rules

- Cutting already-stripped logs into planks does not produce bark.
- Non-wood saw recipes are unaffected.
- Recipes which already produce Tree Bark do not receive duplicate bark.
- Batch processing produces one bark for each input block.

### Important

- Remove all older Grounded Compatibility JARs before installing 1.6.1.
- Gameplay confirmation remains required.

---

## 1.6.0 — Nutrition Growth & Lumisene Processing

### Nutrition calculation

- Replaced fixed-total redistribution with ingredient-based category growth.
- Each category keeps at least Nutritional Balance's original effective
  per-category award.
- Repeated ingredients in the same category now add their contributions.
- The configured Nutritional Balance per-category cap remains respected.
- Recipe recursion still prefers direct/raw ingredient routes, preventing
  slice-reassembly and recycling recipes from multiplying finished dishes.

### Tooltip and coverage fixes

- Grounded's full-name tooltip now owns every classified edible-item tooltip.
- Removed Nutritional Balance's old shared-value tooltip before rendering the
  replacement.
- Added a null-consumer food-property fallback for custom drinks and foods.
- Empty client classifications are no longer cached while Nutritional Balance
  is still synchronizing its food map.
- Retained the cached recipe index; hovering complex food remains smooth.

### Lumisene production

- Removed the recipe that mixed Glow Berries and a bottle directly.
- Supplementaries' existing Create recipe remains responsible for mixing two
  Glow Berries into 250 mB of Lumisene fluid.
- Added spout filling: one Glass Bottle plus 250 mB Lumisene produces one
  Lumisene Bottle.
- The original crafting-table bottle recipe remains disabled.

### Important

- Remove all older Grounded Compatibility JARs before installing 1.6.0.
- Gameplay confirmation remains required for the complete installed food set.

---

## 1.5.2 — Silent Gear Refractive Removal

### Changed

- Removed the Refractive trait from glowstone tool-tip upgrades.
- Removed the Refractive trait from refined glowstone tool-tip upgrades.
- Glowstone and refined glowstone retain their original attributes and all
  unrelated traits.
- These tools can no longer place Silent Gear phantom lights on right-click.

### Design reason

Refractive exists solely to place phantom lights. Removing the trait itself
keeps tooltips honest and makes carried or constructed lighting meaningful
again, without prohibiting glowstone as a Silent Gear material.

### Important

- Existing glowstone-tipped gear should be checked after restarting the game.
- Already placed phantom lights are not removed.
- Remove all older Grounded Compatibility JARs before installing 1.5.2.
- Gameplay confirmation is still required.

---

## 1.5.1 — Nutrition Coverage & Performance

### Fixed

- Removed repeated full recipe scans while hovering over complex foods.
- Added a one-time recipe index and cached food compositions.
- Added cache invalidation for tag/datapack reloads.
- Unified foods with known Nutritional Balance categories under the current
  Grounded tooltip even when their recipe serializer is incomplete.
- Added Protein to Alex's Mobs Up Kangaroo Meat and other raw animal foods.
- Added Fruit to the Alex's Mobs Up Banana.
- Replaced 61 invalid `neoforge:never` recipe conditions with
  `neoforge:false`, fixing runtime recipe-removal parsing errors.

### Performance

- The first food tooltip may build the recipe index once.
- Continued hovering and later tooltips reuse cached results.

### Important

- Remove all older Grounded Compatibility JARs before installing 1.5.1.
- Gameplay confirmation is still required.

---

## 1.5.0 — Native Nutrition Override

### Fixed

- Prevented Nutritional Balance's original equal-per-category award from
  running for foods handled by Grounded Compatibility.
- Proportional nutrition is now applied exactly once without restoring over
  an earlier award.
- Prevented the original shared-value tooltip from being created.
- Replaced cryptic category abbreviations with full localized names.
- Wrapped tooltips after two categories to prevent overflow.

### Ownership rule

- Foods with a complete proportional result are handled exclusively by
  Grounded Compatibility.
- Simple foods and unsupported recipe serializers remain exclusively handled
  by Nutritional Balance.

### Tooltip example

`Nutrients: Protein 10 / Carbs 6`

`  Veggies 10`

### Important

- Remove all older Grounded Compatibility JARs before installing 1.5.0.
- Runtime gameplay confirmation is still required.

---

## 1.4.1 — Proportional Nutrition Correction (superseded)

### Fixed

- Preserved each food's original total NU instead of creating a fixed amount
  for every ingredient.
- Divided total NU proportionally according to actual ingredient quantities.
- Removed unrelated categories inherited through recursive recipe lookup.
- Removed Sugar from the two-Glow-Berry Lumisene Bottle.
- Reliably removed the original Nutritional Balance tooltip.
- Replaced the long tooltip with a compact format:
  `NU: C#  P#  V#  F#  S#`.

### Lumisene example

- Two Glow Berries contribute Fruit.
- The Glass Bottle contributes no nutrition.
- Its original 8 NU is preserved.
- Expected tooltip: `NU: F8`.

### Important

- Version 1.4.0 used an illustrative example as a fixed formula and could
  inflate nutrition. Do not distribute 1.4.0.
- Remove 1.4.0 before installing 1.4.1.

---

## 1.4.0 — Weighted Nutrition (superseded)

### Added

- Added per-category Nutritional Balance values for prepared foods.
- Each nutritious recipe ingredient contributes **4 NU** to its own
  category or categories.
- Each category represented in the finished dish receives a **+2 NU**
  preparation bonus.
- Added a corrected tooltip showing the actual value beside every nutrient.

### Behavior

- Example: one bread, two cabbage and three eggs becomes
  **6 Carbs / 10 Veggies / 14 Protein** at the default rate.
- Only dishes containing at least two different nutrient categories are
  changed.
- Raw and simple single-category foods retain Nutritional Balance's original
  calculation.
- The existing `nutrient_increment_rate` and `nutrient_max_food_value`
  settings remain authoritative.
- The system reads active recipe ingredients, so compatible future dishes can
  work without a separate hard-coded food list.

### Compatibility and permissions

- Nutritional Balance itself is not modified.
- Grounded Compatibility uses its public nutrient API and NeoForge events.
- No Nutritional Balance code, assets or JAR files are included.
- Nutritional Balance is credited in the bundled third-party notices.

### Known Limits

- Custom recipe serializers that expose no ingredients cannot be weighted
  automatically and retain the original calculation.
- Runtime eating and tooltip tests are still required.
- Remove version 1.3.0 before installing 1.4.0.

---

Compatibility and balance support for the **Grounded** modpack.  
Author: **Darius A. Blackwood**  
Minecraft **1.21.1** · NeoForge

---

## 1.3.0 — Food Production & Progression

### Added

- Added **22 original processing recipes** for foods not already covered by
  Farmer's Delight or Delightful Creators.
- Added Cooking Pot recipes for:
  - Alex's Mobs Up Mosquito Repellent Stew.
  - BYG Allium Oddion Soup.
  - BYG White Puffball Stew.
- Added Create processing for BYG pies, Blooming Oddion and Aloe Vera Juice.
- Added Create processing for Supplementaries Pancakes, Candy and Lumisene.
- Added Create processing for Farmer's Delight rolls, Gleaming Salad,
  Melon Popsicles and Barbecue Sticks.
- Added machine recipes for Alex's Delight Bison Burger, Bunfungus Sandwich
  and Maggot Salad.
- Added a corrected Alex's Mobs Up Kangaroo Burger production route.

### Changed

- Disabled **61 exact workbench recipe IDs** for complete foods and dishes.
- Promoted existing Farmer's Delight and Delightful Creators production
  routes instead of duplicating them.
- Corrected obsolete `alexsmobs:*` food references to `alexsmobsup:*`.
- Made all directly integrated mods required dependencies.
- Added explicit dependency metadata for Alex's Mobs Up, Supplementaries and
  Oh The Biomes We've Gone.

### Balance

- BYG pies now require a pie crust, three fruits, sugar and an egg.
- Soups cook from raw ingredients because the Cooking Pot supplies the heat.
- Existing yields are preserved for cookies, candy, pancakes, juice, rolls
  and barbecue sticks.
- Storage unpacking and slice-to-whole reassembly remain available.
- Suspicious Stew remains unchanged to preserve its flower-dependent effect.

### Known Limits

- Runtime machine and JEI testing is still required.
- Non-food recipe removals are reserved for a later list.
- Remove version 1.2.0 before installing 1.3.0.

---

## 1.2.0 — Publication & Nutrition

### Added

- Added three gameplay screenshots to the title-screen collection.
- Expanded the random title background pool from 10 to 13.
- Added fruit and sugar nutrition categories to the Supplementaries Lumisene
  Bottle, based on its two-glow-berry recipe.
- Added third-party notices, retained MIT notices and an unofficial-project
  disclaimer.
- Added Flomik's written permission record for the adjusted Delightful
  Creators apple-cider recipe.

### Fixed

- Fixed the final three title backgrounds never being selected.
- Fixed Lumisene showing Nutritional Balance information with no assigned
  categories.

### Known Limits

- Run `/nutritionalbalance get_unassigned_foods` to identify any other foods
  requiring manual nutrition review.
- Planned recipe removals were not included in this version.

---

## 1.1.0 — Menu Backgrounds & Ore Balance

### Added

- Embedded ten full-resolution gameplay screenshots as title backgrounds.
- Added a client-side random background selector:
  - Selects once when Minecraft starts.
  - Selects again after leaving a world.
  - Does not change when opening ordinary submenus.
- Added aspect-preserving cover rendering without stretching.

### Changed

- Replaced the unsuccessful separate panorama experiment with static 16:9
  backgrounds inside Grounded Compatibility.
- Reduced excessive Nether ore frequency:
  - Nether Gold: `10 → 7`.
  - Nether Quartz: `16 → 12`.
  - Basalt Deltas Quartz: `32 → 24`.
  - Silent Gear Crimson Iron: `10 → 7`.
  - Six active Silent's Gems variants: `2 → 1`.
  - Black Diamond: `3 → 2`.
- Preserved vein sizes so individual discoveries remain rewarding.
- Left Ancient Debris and Create's already-rare Nether deposits unchanged.

### Fixed

- Fixed backgrounds changing whenever a submenu opened.
- Fixed background stretching on non-16:9 displays.
- Superseded the failed `Grounded-Panorama-1.0.0.zip`.

### Compatibility

- Better Panorama should be disabled because it changes the same title-screen
  rendering path.
- Ore changes affect newly generated chunks only.

---

## 1.0.1 — Grounded Identity

### Changed

- Renamed **Blackwood's Modpack Compatibility** to
  **Grounded Compatibility**.
- Changed the mod ID from `blackwood_pack_compat` to `grounded_compat`.
- Renamed the file to `Grounded-Compatibility-1.0.1.jar`.
- Retained **Darius A. Blackwood** as author.
- Reworked the mod-list description into Compatibility, Balance and World
  Generation sections.

### Fixed

- Fixed the project name not matching the Grounded modpack.
- Fixed unclear player-facing metadata.

### Important

- The old 1.0.0 JAR must not be loaded alongside 1.0.1 or later.

---

## 1.0.0 — Initial Compatibility Release

Originally published as **Blackwood's Modpack Compatibility**.

### Cold Sweat + Thirst Was Reclaimed

- Fixed Cold Sweat waterskin pouring being interpreted as drinking.
- Prevented the synthetic one-tick pouring event from permanently granting
  thirst or quenched points.
- Preserved genuine waterskin drinking and normal hydration.

### Farmer's Delight / Create Ecosystem

- Restored Farmer's Delight's flexible Barbecue Stick recipe.
- Added a two-output moose-rib Barbecue Stick route.
- Restored the common-tag chocolate-pie filling recipe.
- Corrected four Delightful Creators emptying recipes from `333 mB` to
  `250 mB`, closing an `83 mB` fluid duplication loop.
- Disabled Slice & Dice's cheaper direct chocolate-only Hot Cocoa route.

### Nutritional Balance & Seasons

- Added nutrition categories for Alex's Delight foods.
- Assigned proteins, carbohydrates and vegetables according to ingredients.
- Classified Cold Sweat Soul Sprout as a vegetable.
- Made Soul Stalk and Soul Sprout year-round Serene Seasons crops.

### Ore Balance

- Reduced excessive combined placement frequency from Silent Gear,
  Silent's Gems, Create zinc and common vanilla ores.
- Preserved vein sizes and already-rare progression ores.

### Development Errors Corrected

- Incorrect Alex's Mobs namespace references.
- Conflicting Farmer's Delight/Alex's Delight recipe ownership.
- Delightful Creators filling/emptying fluid mismatch.
- Duplicate cheap Hot Cocoa processing.
- Missing nutrition categories.
- Cold Sweat pouring being processed as actual drinking.

---

## General Notes

- Install only one Grounded Compatibility version.
- Grounded Compatibility is an unofficial community project and is not
  endorsed by Mojang, NeoForge or the integrated mod developers.
- The mod references existing registry IDs, tags and public recipe
  serializers. It does not redistribute third-party mod JARs or their
  textures, models, sounds or source code.