• 类型: 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"
  

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

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

  3. 黑暗生存挑战: 在黑暗处 (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-blocked: 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-blocked: 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.