• 类型: int
• 默认值: 5000
• 取值范围: 2~5000
• 说明: 设置本 Mod 能提供的最大额外生命值(玩家最终血量 = 原版血量 + 其他 Mod 增益 + 本 Mod 增益。此选项仅限制“本 Mod 增益”的上限,防止数值无限膨胀)

• 类型: int
• 默认值: 2
• 取值范围: 0~20
• 说明: 每发现一个食物的生命值增益(设置此为0则等于禁用)

• 类型: boolean
• 默认值: false
• 说明: 启用后,玩家死亡时血量将重置为默认值,且删除所有已发现记录

• 类型: int
• 默认值: 0
• 取值范围: 任意
• 说明: 每次生命值增益时恢复血量数值,若大于上限则恢复到上限

• 类型: boolean
• 默认值: false
• 说明: 每次生命值增益时恢复血量至上限

• 类型: string
• 默认值: 0
• 说明: 写法详见下文函数编写指南
  可用变量: uniqueFoods食用过的食物数

• 类型: List
• 默认值:

[
  "minecraft:rotten_flesh",
  "minecraft:spider_eye"
],

• 说明：列表中的食物不再会被记录(在黑名单修改后,玩家已发现的食物不受影响,未发现的食物不再计入统计) 相关机制和操作说明: 客户端的tooltip会显示所有已发现食物(不管是否存在于黑名单,机制应用于保存黑名单前已发现某一食物),未发现且处于黑名单内的食物不显示.修改后使用 /sol2f sync AllFoodList 同步数据以确保tooltip显示正常
  客户端的GUI在修改配置后需要使用sync命令同步数据.包括: 在修改了血量增益计算相关配置后,血量概述在执行sync后会重新计算并显示在客户端;在重设黑名单后,执行同步以同步客户端GUI的食物概述.
  客户端的食物概述显示的是所有已发现食物/非黑名单食物,而不是所有已发现食物/所有已发现食物+非黑名单食物的并集

• 类型: boolean
• 默认值: false
• 说明: 启用后,玩家会随时间损失饥饿值

• 类型: int
• 默认值: 1200
• 说明: 配置值代表tick(游戏刻 ↗ 游戏刻-Minecraft Wiki),每达到一定配置的游戏刻,按照函数计算衰减

• 类型: string
• 默认值: "1"
• 说明: 用于计算每次自然衰减值的函数(将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),写法详见下文函数编写指南
  可用变量 (Variables):
  • 动作: isSprinting (疾跑), isSwimming (游泳), isSneaking (潜行), isCrawling (爬行)
  • 环境: isTouchingWater (接触水), isBeingRainedOn (淋雨), isWet (潮湿(接触水或淋雨或接触气泡柱)), BrightnessAtEyes (玩家眼镜坐标的渲染亮度(0.0-1.0) ↗ 渲染亮度|Minecraft Wiki)
  • 状态: FoodLevel (当前饥饿值), Saturation (饱食度), Exhaustion (消耗度) ↗ 饥饿机制详解-Minecraft Wiki
    注：所有布尔变量在公式中为 1.0 (真) 或 0.0 (假)
    配方示例:
  1. 基础固定消耗: 每周期扣 0.5 点。

  "NaturalHungerExpression": "0.5"
  

  1. 环境动态消耗: 疾跑或游泳：扣 4 点,淋雨或站在水中：扣 2 点,其他情况：扣 1 点

  "NaturalHungerExpression": "if(or(isSprinting, isSwimming), 4, if(or(isBeingRainedOn, isTouchingWater), 2, 1))"
  

  1. 黑暗生存挑战: 在黑暗处 (BrightnessAtEyes < 0.1) 消耗加倍。

  "NaturalHungerExpression": "if(lt(BrightnessAtEyes, 0.1), 2, 1)"
  

• 类型: boolean
• 默认值: false
• 说明: 启用后,玩家睡醒时会根据函数扣除一定饥饿值

• 类型: string
• 默认值: "SleepDuration / 3000"
• 说明: 用于计算每次睡醒时衰减的饱食度的值(将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),指南详见下文函数编写指南
  可用变量:
  • 睡眠: SleepDuration (睡眠时长(tick),按照游戏内时间而非睡眠经历的绝对tick ↗ "24小时制"下的Minecraft-Minecraft Wiki)
  • 状态: FoodLevel (当前饥饿值), Saturation (饱食度), Exhaustion (消耗度) ↗ 饥饿机制详解-Minecraft Wiki
    

• 类型: int
• 默认值: 1
• 说明: 本mod的饥饿衰减(包括自然饥饿衰减和睡眠饥饿衰减)所能扣除到的最小值,若小于该值则不再扣除,若扣除后小于该值则扣除至该值,否则按照函数默认扣除

• 类型: boolean
• 默认值: true
• 说明: 控制客户端的tooltip显示。

• 类型: boolean
• 默认值: true
• 说明: 控制客户端的tooltip显示。

/sol2f clearhealthy

重置当前玩家的生命值上限与所有食物摄入记录，需管理员权限。（版本：2.0+）

/sol2f getlist <player>

获取玩家已发现食物列表。

/sol2f sync

同步所有数据。

• /sol2f sync PlayerData同步玩家数据。主要用于GUI显示和tooltip显示控制。
• /sol2f sunc AllFoodList同步食物数据：最新的非黑名单食物数据，玩家最大血量上限数据。主要用于GUI显示和tooltip显示控制。

• 使用鼠标滚轮翻页。

• 血量概述：当前获得的mod增益 / 最大可获得的mod增益。

打开GUI的快捷键在minecraft的按键绑定中配置

通过合成"食物簿"打开食物簿:

• Type: int
• Default: 5000
• Range: 2 ~ 5000
• What it does: Sets the absolute maximum bonus this mod can add to a player's health.
  • Final player health = (Base Health + Bonuses from other mods) + This Mod's Bonus.
  • This setting only caps "This Mod's Bonus" to prevent runaway scaling.

• Type: int
• Default: 2
• Range: 0 ~ 20
• What it does: The amount of health (in HP) granted for each new food discovered. Set to 0 to disable the base gain.

• Type: boolean
• Default: false
• What it does: If true, dying resets your bonus to zero and erases your entire food discovery history. This is a hardcore option.

• Type: boolean
• Default: false
• What it does: If true, whenever you gain a health bonus (by eating a new food), your current health is instantly filled to your new maximum.
• Note: If this is true, the healthIncreaseOnIncrease setting below is ignored.

• Type: int
• Default: 0
• Range: Any positive integer
• What it does: Heals you by a specific amount whenever you gain a health bonus. If the heal amount would exceed your new max, it heals you to full instead.
• Note: This only applies if healthToMaxOnIncrease is set to false.

• Type: string
• Default: "0"
• What it does: A custom formula for calculating your health bonus. The result is added to the healthGain value.
• Variable: uniqueFoods (the total number of unique foods you've eaten).
• Syntax: See the Function Guide below.

• Type: List
• Default:

["minecraft:rotten_flesh", "minecraft:spider_eye"]

• What it does: Foods in this list will not be counted towards your discovery progress.
• How it works:
  • Existing data: Foods you already ate before they were added to the blacklist remain in your history (the mod doesn't erase your past meals).
  • New data: Foods on the blacklist that you haven't eaten yet will never count.
  • After changing the list: You must run /sol2f sync AllFoodList to update the client GUI and tooltips. This ensures the display matches the new blacklist.
• GUI Display: The overview screen shows Discovered Foods / Total Non-Blacklisted Foods.

• Type: boolean
• Default: false
• What it does: If true, the player will passively lose hunger over time.

• Type: int
• Default: 1200
• What it does: How often (in game ticks, 20 ticks = 1 second) the "Natural Hunger" decay triggers. Each time it triggers, it subtracts the amount calculated by NaturalHungerExpression.

• Type: string
• Default: "1"
• What it does: A custom formula that determines how much hunger (Food Level) is subtracted each decay interval.
• Variables:
  • Actions: isSprinting, isSwimming, isSneaking, isCrawling
  • Environment: isTouchingWater, isBeingRainedOn, isWet, BrightnessAtEyes (render brightness at eye level, 0.0 - 1.0)
  • Status: FoodLevel (current hunger), Saturation, Exhaustion
  • Note: Boolean variables return 1.0 (true) or 0.0 (false).
• Syntax: See the Function Guide below.
• Example:
  • Basic fixed cost: Lose 0.5 hunger every period.

    "NaturalHungerExpression": "0.5"
    

  • Dynamic cost: Lose 4 if sprinting/swimming, 2 if in rain/water, otherwise 1.

    "NaturalHungerExpression": "if(or(isSprinting, isSwimming), 4, if(or(isBeingRainedOn, isTouchingWater), 2, 1))"
    

• Type: boolean
• Default: false
• What it does: If true, the player loses hunger upon waking up after sleeping.

• Type: string
• Default: "SleepDuration / 3000"
• What it does: A custom formula that determines how much hunger (Food Level) is subtracted when you wake up.
• Variables:
  • Sleep: SleepDuration (time skipped in ticks)
  • Status: FoodLevel, Saturation, Exhaustion
• Syntax: See the Function Guide below.

• Type: int
• Default: 1
• What it does: The lowest your food level can be reduced to by this mod's hunger systems (both time-based and wake-up). Decay will stop when you hit this value.

• Constants: You can use e and pi.

• Arithmetic:

  • Basic: +, -, *, /, and parentheses ().
  • Power: pow(base, exponent)
  • Rounding: floor(num), round(num), ceil(num)
  • Min/Max: min(a, b), max(a, b)
  • Logarithm: log(base, argument)

• Logic:

  • Conditional: if(condition, value_if_true, value_if_false) (condition > 0 is true)
  • AND: and(a, b) (returns 1 if both > 0, else 0)
  • OR: or(a, b) (returns 1 if either > 0, else 0)
  • NOT: not(a) (returns 1 if a <= 0, else 0)

• Comparisons:

  • Greater Than: gt(a, b) (1 if a > b, else 0)
  • Less Than: lt(a, b) (1 if a < b, else 0)
  • Equal: eq(a, b) (1 if a == b, else 0)
  • Not Equal: neq(a, b) (1 if a != b, else 0)

• Type: boolean
• Default: true
• What it does: Shows a tooltip on foods you've already discovered.

• Type: boolean
• Default: true
• What it does: Shows a tooltip on foods you haven't discovered yet.

• Usage: /sol2f clearhealthy
• What it does: Resets your health bonus and food discovery list. Requires operator privileges. (Added in v2.0+)

• Usage: /sol2f getlist <player>
• What it does: Shows the list of foods a specific player has discovered.

• Usage:
  • /sol2f sync PlayerData - Syncs player discovery lists. Use this if GUI tooltips seem wrong.
  • /sol2f sync AllFoodList - Syncs the global food list. You must run this after changing the blacklist to update the GUI and client displays.

• Browse your discoveries. Use the scroll wheel to flip pages.

• Health Summary: Shows Current Mod Bonus / Maximum Possible Bonus.

You can set a hotkey to open the Food Book in Minecraft's Controls menu.

Craft the "Food Book" to access the interface without using the keybind.

"maxHealthy": 5000,

配置本mod的增益上限，无关玩家默认血量和其他mod的修改，仅影响本mod的增益上限。 玩家血量=初始血量+其他mod的修改（若存在其他mod修改）+本mod增益。该选项控制最后一项。

"healthGain": 2,

每次奖励血量数

resetOnDeath: false,

死亡后是否重置生命值上限与所有食物记录。

"developerMode": false,

开发者模式，输出log记录玩家变更记录，建议不开启。

"healthToMaxOnIncrease": false

是否在增加生命上限时恢复满血。

"Increasefrequency": 4,

食用X种食物而增加N点血量，该配置项作为X（区别于与前面的healthyGain，且共存）

"frequencyGain": 4,

食用X种食物后增加N点血量，该配置项作为N（区别于与前面的healthyGain，且共存）

"healthIncreaseOnIncrease": 2,

每次血量上限增益时回复的血量，若超过上限则回复至上限

"Expression": 0,

字符串类型，增益计算函数，与旧版本设置并存。

函数使用文档：

• uniqueFoods食用过的食物数
• 你可以使用e和pi代表e和π

运算：

• 普通四则运算（加+减-乘*除/），用括号表示的优先级（例如( 1 + 2 ) * 3）
• 幂运算 pow(底数, 指数)
• 约数：
  • 向下取整数:floor(num)
  • 四舍五入数:round(num)
  • 向上取整数:ceil(num)
• 比较大小
  • 取大值:max(num1, num2)
  • 取小值:min(num1, num2)
• 对数:log(底数, 真数)

"blacklist": [
  "minecraft:rotten_flesh",
  "minecraft:spider_eye"
]

列表类型。列表中的食物不会被记录，已经食用的物品不会从统计中移除。在修改后，使用/sol2f sync AllFoodList 同步数据以确保tooltip显示正常，已经食用的食物tooltip仍然显示。

每行输入一个物品ID，例如：minecraft:golden_apple

"ShowConsumedTooltips": true,

控制客户端的tooltip显示。

"ShowUnconsumedTooltips": true,

控制客户端的tooltip显示。

/sol2f clearhealthy

重置当前玩家的生命值上限与所有食物摄入记录，需管理员权限。（版本：2.0+）

/sol2f getlist <player>

获取玩家已发现食物列表。

/sol2f sync

同步所有数据。

• /sol2f sync PlayerData同步玩家数据。主要用于GUI显示和tooltip显示控制。
• /sol2f sunc AllFoodList同步食物数据：最新的非黑名单食物数据，玩家最大血量上限数据。主要用于GUI显示和tooltip显示控制。

• 使用鼠标滚轮翻页。

• 血量概述：当前获得的mod增益 / 最大可获得的mod增益。

打开GUI的快捷键在minecraft的按键绑定中配置

通过合成"食物簿"打开食物簿:

"maxHealthy": 5000,

Sets the upper limit for health bonuses granted by this mod. This value is independent of the player's default health or modifications from other mods; it strictly caps the bonus provided by this mod.
Formula: Player Max Health = Base Health + Other Mod Modifications (if any) + This Mod's Bonus. This option controls the final term.

"healthyGain": 2,

The amount of health points awarded for each unique food consumed.

"resetOnDeath": false,

Whether to reset the maximum health bonus and all food consumption records upon player death.

"developerMode": false,

Enables developer mode, which outputs detailed logs regarding player record changes. Recommended to be kept disabled for normal gameplay.

"healthToMaxOnIncrease": false

Whether to fully restore the player's current health whenever their maximum health increases.

"Increasefrequency": 4,

Defines the frequency threshold (X) for special rewards. Instead of gaining health for every single new food, the player gains a bonus only after consuming X unique foods. This works alongside healthyGain.

"frequencyGain": 4,

Defines the health amount (N) awarded when the frequency threshold (Increasefrequency) is reached. This works alongside healthyGain.

"healthIncreaseOnIncrease": 2,

The amount of health restored to the player whenever their maximum health increases. If the healing amount exceeds the new maximum, health is capped at the new limit.

"Expression": "0",

A string type field for a custom gain calculation function. This coexists with the standard settings above. If set to "0", this feature is disabled.

Function Documentation:

• uniqueFoods: The number of unique foods consumed.
• currentHealth: The current health value (excluding bonuses from this mod, but including base health and other mod modifications).
• You can use e and pi to represent Euler's number and π.

Supported Operations:

• Basic Arithmetic: Addition (+), Subtraction (-), Multiplication (*), Division (/). Use parentheses () for precedence (e.g., (1 + 2) * 3).
• Power: pow(base, exponent)
• Rounding:
  • Round Down: floor(num)
  • Round Nearest: round(num)
  • Round Up: ceil(num)
• Comparison:
  • Maximum: max(num1, num2)
  • Minimum: min(num1, num2)
• Logarithm: log(base, argument)

"blacklist": [
  "minecraft:rotten_flesh",
  "minecraft:spider_eye"
]

A list type configuration. Foods listed here will not be recorded in statistics. Note that foods already consumed before adding them to the blacklist will not be removed from existing statistics.
Important: After modifying this list, use the command /sol2f sync AllFoodList to synchronize data. This ensures tooltips display correctly. Tooltips for already consumed foods will remain visible until re-evaluated.

Enter one Item ID per line. Example: minecraft:golden_apple

"ShowConsumedTooltips": true,

Controls whether the tooltip indicator for "Consumed" foods is displayed on the client.

"ShowUnconsumedTooltips": true,

Controls whether the tooltip indicator for "Not yet consumed" foods is displayed on the client.

/sol2f clearhealthy

Resets the current player's maximum health bonus and all food consumption records. Requires operator permissions. (Version: 2.0+)

/sol2f getlist <player>

Retrieves the list of consumed foods for the specified <player>.

/sol2f sync

Synchronizes all data.

• /sol2f sync PlayerData: Synchronizes player-specific data. Primarily used to update GUI displays and tooltip states.
• /sol2f sync AllFoodList: Synchronizes food data (latest non-blacklisted food list and player max health cap). Primarily used to ensure GUI and tooltip displays are current after config changes.

• Use the mouse scroll wheel to flip pages.

• Health Summary: Displays (Current Mod Bonus / Maximum Possible Mod Bonus).

The shortcut key to open the GUI can be configured in Minecraft's Controls menu.

Craft the "Food Book" to open the food journal interface: