🍎 Diet — AppleSeed Edition

Neoforge 1.21.1 | Data-Driven | Fully Configurable | Modpack-Friendly

Eat balanced, stay healthy 🥗 | 膳食均衡，健康生活

Bring depth to Minecraft's food system! Get bonuses for eating varied diets, and negative effects from nutritional imbalance.

为 Minecraft 的饮食系统引入深度机制！通过多样化饮食获得奖励，饮食失衡时获得负面效果。

Inspired by TheIllusiveC4's project Diet — https://modrinth.com/mods/diet

灵感来自 TheIllusiveC4 的项目 Diet — https://modrinth.com/mods/diet

📖 About | 关于

Diet — AppleSeed Edition is the spiritual successor of the famous Diet mod, completely rewritten from the ground up for Neoforge 1.21.1.

Diet — AppleSeed Edition 是著名膳食均衡模组 Diet 的精神续作，为 Neoforge 1.21.1 完全重写。

This mod introduces a complete nutrition system that encourages players to eat diverse foods instead of relying on golden carrots forever!

本模组引入了一套完整的饮食营养系统，鼓励玩家多样化饮食，而不是只吃金胡萝卜！

💡 Features | 特性：

• ✅ 100% Data-driven, zero hardcoding | 100% 数据驱动，零硬编码
• ✅ Powerful automatic nutrition calculation engine | 强大的自动营养计算引擎
• ✅ Complete configuration system with per-group overrides | 完整的配置系统，支持每组分段覆盖
• ✅ Smart ingredient tracing via Minecraft recipes | 通过 Minecraft 配方智能追溯原料
• ✅ Supports all modded foods | 支持所有 Mod 食物
• ✅ Multi-language support | 多语言支持
• ✅ Soft dependency — works without FTB Library / SomeAssemblyRequired | 软依赖 — 不安装 FTB Library / SomeAssemblyRequired 也能正常运行
• ✅ Block food support (e.g., Cake) with per-bite nutrition | 方块食物支持（如蛋糕），按口计算营养值
• ✅ Simulated recipes for custom nutrition calculations | 模拟配方系统，支持自定义营养计算
• ✅ Configurable recipe recursion depth for non-food ingredients | 可配置的非食物原料配方递归深度

🎯 Five Food Groups | 五大营养组

💡 26% – 60%: No effects for all groups. | 26% – 60%：所有营养组均无效果。

💡 Sugars special: No effect at 0–50%, speed bonus starts at 51%. | 糖类特殊：0–50% 无效果，51% 起提供速度加成。

🎮 In-Game Features | 游戏内功能

📱 Diet Balance Screen | 膳食均衡界面

Open the diet screen via:

• Inventory Button: Press E → click the Diet button next to the Recipe Book (default mode)
• FTB Library Sidebar: Button appears in the FTB Library sidebar (ftb_compact mode, requires FTB Library)
• Key Binding: Bind a key to "Open Diet GUI" in Controls → AppleSeed category
• Command: /diet screen (no permission required)

打开膳食均衡界面：

• 物品栏按钮：按 E → 点击配方书旁的「膳食均衡」按钮（默认模式）
• FTB Library 侧边栏：按钮出现在 FTB Library 侧边栏中（ftb_compact 模式，需安装 FTB Library）
• 按键绑定：在 控制 → AppleSeed 分类中为「Open Diet GUI」绑定按键
• 指令：/diet screen（无需权限）

┌─────────────────────────────────────────────┐
│                  Diet / 膳食均衡             │
├─────────────────────────────────────────────┤
│  🌾 Grains   [████████░░░░]  80%            │
│  🥬 Veggies  [███████░░░░░]  70%            │
│  🥩 Protein  [████████████] 100%            │
│  🍎 Fruits   [████░░░░░░░░]  40%            │
│  🍬 Sugars   [█████████░░░]  90%            │
├─────────────────────────────────────────────┤
│  ✨ Active Effects:                         │
│     Resistance I                            │
│     +6.0 Max Health / 最大生命值             │
│     +4.0 Armor / 护甲值                      │
└─────────────────────────────────────────────┘

The screen supports pagination when there are more than 5 nutrition groups.

营养组超过 5 个时，界面支持分页浏览。

🔘 Entrance Visibility Modes | 入口可见性模式

Controlled via config entrance_visibility or /diet config set entranceVisibility <mode>:

通过配置 entrance_visibility 或 /diet config set entranceVisibility <mode> 控制：

💡 Switching to/from ftb_compact mode automatically triggers /reload to refresh FTB Library's sidebar.

💡 切换至/出 ftb_compact 模式时自动执行 /reload 以刷新 FTB Library 侧边栏。

💬 Item Tooltips | 物品提示

All edible items show nutrition values when hovered. | 所有可食用物品在鼠标悬停时显示营养值。

Cake / 蛋糕
──────
Nutrition: / 营养值：
  Grains: +3.2% / 谷物: +3.2%
  Sugars: +15.8% / 糖类: +15.8%
  Protein: +1.5% / 蛋白质: +1.5%

💡 Only nutrients with value > 0 are shown. | 仅显示值大于 0 的营养素。 💡 SomeAssemblyRequired sandwiches are fully supported. | 完整支持 SomeAssemblyRequired 的三明治。

🧱 Block Foods | 方块食物

Block foods like Cake are fully supported. Nutrition is calculated per bite. | 方块食物（如蛋糕）已完全支持，营养值按口计算。

// diet/blocks/cake.json
{
    "source_block": "minecraft:cake",
    "bites": 7,
    "nutritions": {
        "grains": 0.03,
        "sugars": 0.15,
        "proteins": 0.02
    }
}

Each bite of cake adds 1/7th of the total nutrition values. | 每口蛋糕增加总营养值的 1/7。

⚙️ Nutrition Mechanics | 营养机制

📉 Nutrition Decay | 营养衰减

Your nutrition decays based on your actions: | 营养值会根据玩家行为衰减：

🛡️ Decay Exemptions | 衰减豁免

Each group can be configured to ignore decay from specific sources:

每个营养组可配置忽略特定来源的衰减：

These can be set per-group in appleseed-common.toml under [Group_Overrides].

可在 appleseed-common.toml 的 [Group_Overrides] 中按组设置。

📈 Nutrition Gain | 营养获取

When you eat a food item, nutrition values are added based on the food's nutritional composition, multiplied by the group's gain_multiplier.

食用食物时，根据食物的营养成分增加营养值，乘以该组的 gain_multiplier。

💀 Death Mechanics | 死亡机制

Controlled by gamerule keepNutritions: | 由游戏规则 keepNutritions 控制：

• false (Default): Reset to initial values on respawn. | false（默认）：重生时重置为初始值。
• true: Keep nutrition values on death. | true：死亡后保留营养值。

/gamerule keepNutritions true

🚀 Smart Auto-Calculation Engine | 智能自动计算引擎

🧠 Recipe-Driven Nutrition | 配方驱动的营养计算

This is the mod's most powerful feature! No manual data files required!

这是模组最强大的功能！无需手动编写数据文件！

On world load, the mod will: | 世界加载时，模组会：

1. 🔍 Scan all registered recipes | 扫描所有已注册的配方
2. 🍳 Identify all items with FoodProperties | 识别所有带有 FoodProperties 的物品
3. 🔗 Recursively trace each food's ingredients | 递归追溯每个食物的原料
4. 🧮 Automatically calculate nutritional composition | 自动计算营养成分
5. 💾 Save results to config/apple_seed_foods/ as JSON cache | 将结果保存为 JSON 缓存至 config/apple_seed_foods/

📊 Calculation Example | 计算示例

Take Cake for example: | 以蛋糕为例：

Cake Nutrition = 3×Milk + 2×Sugar + Egg + 3×Wheat
蛋糕营养值 = 3×牛奶 + 2×糖 + 鸡蛋 + 3×小麦
──────────────────────────────────────────────────
Result: Grains +3.2% / Sugars +15.8% / Protein +1.5%
结果: 谷物 +3.2% / 糖类 +15.8% / 蛋白质 +1.5%

✅ Supported Recipe Types | 支持的配方类型

• ✅ Crafting (Shaped / Shapeless) | 合成配方（有序 / 无序）
• ✅ Furnace / Smoker / Blast Furnace | 熔炉 / 烟熏炉 / 高炉
• ✅ Campfire Cooking | 营火烹饪
• ✅ Stonecutting | 切石机
• ✅ Smithing | 锻造

📁 Data Loading Priority | 数据加载优先级

When multiple sources define nutrition for the same food, the highest priority wins:

1. appleseed_data.json           ← Highest priority
2. Datapack diet/foods/*.json    ← Can override built-in
3. Other mods' diet/foods/*.json
4. Appleseed built-in foods
5. config/apple_seed_foods/*.json ← Auto-generated (lowest priority)

当多个来源为同一食物定义营养值时，高优先级覆盖低优先级：

1. appleseed_data.json            ← 最高优先级
2. 数据包 diet/foods/*.json       ← 可覆盖内置
3. 其他模组的 diet/foods/*.json
4. AppleSeed 内置食物数据
5. config/apple_seed_foods/*.json  ← 自动生成（最低优先级）

🧪 Simulated Recipes | 模拟配方

Simulated recipes allow you to define custom nutrition calculations for items that don't have actual crafting recipes, or to override existing recipe-based calculations.

模拟配方允许你为没有实际合成配方的物品定义自定义营养计算，或覆盖现有的基于配方的计算。

// data/appleseed/recipes/simulate/custom_food.json
{
    "type": "appleseed:simulate_recipe",
    "inputs": [
        {
            "item": "minecraft:wheat",
            "count": 3
        },
        {
            "item": "minecraft:sugar",
            "count": 2
        }
    ],
    "outputs": [
        {
            "item": "minecraft:cake",
            "count": 1
        }
    ]
}

Simulated recipes support both items and fluids as inputs:

模拟配方支持物品和流体作为输入：

{
    "type": "appleseed:simulate_recipe",
    "inputs": [
        {
            "fluid": "minecraft:water",
            "count": 1000
        },
        {
            "item": "minecraft:wheat",
            "count": 2
        }
    ],
    "outputs": [
        {
            "item": "minecraft:bread",
            "count": 1
        }
    ]
}

💡 Simulated recipes are processed alongside vanilla recipes during auto-calculation. | 模拟配方在自动计算时与原版配方一起处理。

🔧 Commands | 指令

Nutrition Management | 营养管理

Item Nutrition Management | 物品营养管理

Block Nutrition Management | 方块营养管理

Configuration | 配置管理

Cache Management | 缓存管理

Screen | 界面

💡 All nutrition ID arguments support Tab completion. | 所有营养 ID 参数都支持 Tab 补全。 💡 Entrance visibility arguments support Tab completion. | 入口可见性参数支持 Tab 补全。

⚙️ Configuration File | 配置文件

Located at config/appleseed-common.toml.

位置：config/appleseed-common.toml。

[General_Settings]

[Group_Overrides]

Override group-level behavior. Each preset group has:

• *_is_negative — Nutrition from this group is ignored during auto-calculation
• *_ignore_attack — Nutrition does NOT decay when taking damage
• *_ignore_hunger — Nutrition does NOT decay when hunger decreases

覆盖营养组级别的行为。每个预设组拥有：

• *_is_negative — 自动计算时忽略该营养组的贡献
• *_ignore_attack — 受到攻击时该营养素不衰减
• *_ignore_hunger — 饱食度降低时该营养素不衰减

Example:

[Group_Overrides]
    grains_is_negative = false
    grains_ignore_attack = false
    grains_ignore_hunger = false
    fruits_is_negative = false
    fruits_ignore_attack = false
    fruits_ignore_hunger = false
    vegetables_is_negative = false
    vegetables_ignore_attack = false
    vegetables_ignore_hunger = false
    proteins_is_negative = false
    proteins_ignore_attack = false
    proteins_ignore_hunger = false
    sugars_is_negative = false
    sugars_ignore_attack = false
    sugars_ignore_hunger = false

[Nutritions_Settings] > [Effects_Override]

Override effect ranges per group. Leave empty (default) to use the data file definitions.

覆盖每个营养组的效果范围。留空（默认）则使用数据文件中的定义。

[Nutritions_Settings.Effects_Override]
    # grains_ranges = ["0-25:effect(minecraft:slowness,0)"]
    # fruits_ranges = ["0-25:effect(minecraft:mining_fatigue,0)"]

[Nutritions_Settings]

📁 Data Pack Configuration | 数据包配置

📂 Directory Structure | 目录结构

data/
└── <namespace>/
    └── diet/
        ├── groups/               ← Group definitions (required / 必需)
        │   ├── grains.json
        │   ├── fruits.json
        │   ├── vegetables.json
        │   ├── proteins.json
        │   ├── sugars.json
        │   └── disabled_groups.json   ← Groups to disable (array / 数组)
        └── foods/                ← Food nutrition data (optional / 可选)
            ├── apple.json
            ├── bread.json
            └── ...

📄 Food Data Format | 食物数据格式

Each file defines one food item. Supports both single-object and array formats. The auto_calculated field defaults to false when omitted.

每个文件定义一个食物。支持单对象和数组两种格式。auto_calculated 字段缺失时默认为 false。

// Single object format / 单对象格式 — diet/foods/apple.json
{
    "source_item": "minecraft:apple",
    "nutritions": {
        "fruits": 0.02
    }
}

// Array format, only for file config/appleseed_data.json / 数组格式，仅可在config/appleseed_data.json中使用
[
    {
        "source_item": "minecraft:apple",
        "nutritions": {
            "fruits": 0.02
        }
    },
    {
        "source_item": "minecraft:bread",
        "nutritions": {
            "grains": 0.05
        }
    }
]

📄 Group Definition Format | 营养组定义格式

{
    "icon": "minecraft:apple",
    "color": "#9e2a2b",
    "order": 1,
    "default_value": 0.5,
    "gain_multiplier": 1.0,
    "decay_multiplier": 1.0,
    "beneficial": true,
    "translation_key": "diet.group.fruits",
    "effects": [
        "0-25:effect(minecraft:mining_fatigue,0)",
        "61-70:attribute(minecraft:generic.max_health,2.0)",
        "71-80:attribute(minecraft:generic.max_health,4.0)",
        "81-100:attribute(minecraft:generic.max_health,6.0)"
    ]
}

📄 Effects Format | 效果格式

"min-max:effect(namespace:id,amplifier),attribute(namespace:id,amount),..."

Multiple effects/attributes in one range are separated by commas.

同一范围内的多个效果/属性用逗号分隔。

🚫 Disabling Groups | 禁用营养组

disabled_groups.json — an array of group names to disable entirely:

disabled_groups.json — 一个包含要完全禁用的营养组名称的数组：

["grains", "sugars"]

🍎 appleseed_data.json

A special config file at config/appleseed_data.json with the highest priority. Format is an array of food entries:

位于 config/appleseed_data.json 的特殊配置文件，拥有最高优先级。格式为食物条目数组：

[
    {
        "source_item": "minecraft:golden_apple",
        "nutritions": {
            "fruits": 0.5,
            "sugars": 0.3
        }
    }
]

🔌 Soft Dependencies | 软依赖

FTB Library Compat | FTB Library 兼容

When FTB Library is installed, the mod supports registering a sidebar button to open the diet screen. Set entrance_visibility to ftb_compact in config, or use /diet config set entranceVisibility ftb_compact.

当安装 FTB Library 时，支持在侧边栏注册按钮以打开膳食均衡界面。 在配置中设置 entrance_visibility 为 ftb_compact，或使用 /diet config set entranceVisibility ftb_compact。

The button is defined via the JSON asset at assets/appleseed/sidebar_buttons/diet.json and appears in FTB Library's sidebar as "Diet Balance".

按钮通过 assets/appleseed/sidebar_buttons/diet.json JSON 资源定义，在 FTB Library 侧边栏显示为「Diet Balance」。

SomeAssemblyRequired Compat | SomeAssemblyRequired 兼容

Sandwiches from SomeAssemblyRequired are fully supported — their nutritional value is calculated from all ingredients inside the sandwich.

完整支持 SomeAssemblyRequired 的三明治 — 根据三明治内所有原料计算营养值。

🎮 Key Binding | 按键绑定

A key binding is registered under Controls → AppleSeed → Open Diet GUI. Can be used to open the diet screen regardless of entrance visibility mode.

在 控制 → AppleSeed → Open Diet GUI 中注册了按键绑定。 无论入口可见性模式如何，均可使用该按键打开膳食均衡界面。

📦 Modpack Usage | 整合包使用

This mod is designed with modpack creators in mind:

• Create custom food nutrition data in your datapack under data/<namespace>/diet/foods/
• Override group behaviors via appleseed-common.toml → [Group_Overrides]
• Define highest-priority food data in config/appleseed_data.json
• Disable unwanted groups via disabled_groups.json
• Customize nutrition effects in group JSON files under diet/groups/
• Auto-calculation handles all modded foods — no manual data needed for most items

本模组为整合包作者设计：

• 创建自定义食物营养数据：在数据包的 data/<namespace>/diet/foods/ 下
• 覆盖营养组行为：通过 appleseed-common.toml → [Group_Overrides]
• 定义最高优先级食物数据：在 config/appleseed_data.json 中
• 禁用不需要的营养组：通过 disabled_groups.json
• 自定义营养效果：在 diet/groups/ 下的组 JSON 文件中
• 自动计算覆盖所有 Mod 食物 — 大多数物品无需手动编写数据

📝 License | 许可证

LGPLv3