切换语言:
概述
一款简单的食物机制扩充模组,包含一些生活调味料的趣味功能。
模组 食用 指南
本指南中的配置和 GUI 说明部分针对最新版本(3.2.0)进行维护,其他版本的详细信息请参考游戏内配置页面提示。
关于配置
服务端配置
这些配置存放于 /config/spice-of-life-fabric-flavor.json。
这些配置在服务端生效,本地游戏版本的配置仅影响本地游戏存档。
生命增益系统
所有配置项以 health(生命值单位)计算,2 health = 1 heart(红心)。
maxHealth | 最大血量
- 类型: int
- 默认值: 5000
- 取值范围: 2~5000
- 说明: 设置本 Mod 能提供的最大额外生命值 (玩家最终血量 = 原版血量 + 其他 Mod 增益 + 本 Mod 增益。此选项仅限制“本 Mod 增益”的上限,防止数值无限膨胀)。
healthGain | 生命值增益
- 类型: int
- 默认值: 2
- 取值范围: 0~20
- 说明: 每发现一种新食物所获得的生命值增益 (将此值设为 0 则等于禁用该功能)。
resetOnDeath | 死亡重置
- 类型: boolean
- 默认值: false
- 说明: 启用后,玩家死亡时血量将重置为默认值,并删除所有已发现食物的记录。
healthToMaxOnIncrease | 增益时恢复血量
- 类型: int
- 默认值: 0
- 取值范围: 任意
- 说明: 每次获得生命值增益时恢复的血量数值,若超过上限则恢复到上限。
healthIncreaseOnIncrease | 增益时恢复满血
- 类型: boolean
- 默认值: false
- 说明: 每次获得生命值增益时,将血量恢复至上限。
Expression | 生命值增益计算函数
- 类型: string
- 默认值: 0
- 说明: 写法详见下文函数编写指南
可用变量:uniqueFoods(食用过的食物种类数)。
blacklist | 黑名单
- 类型: List
- 默认值:
[
"minecraft:rotten_flesh",
"minecraft:spider_eye"
],
- 说明:列表中的食物不再会被记录 (在黑名单修改后,玩家已发现的食物不受影响,未发现的食物不再计入统计)。
相关机制和操作说明:
客户端的 tooltip 会显示所有已发现食物 (不管是否存在于黑名单,机制应用于保存黑名单前已发现的某一食物),未发现且处于黑名单内的食物不显示。修改后使用
/sol2f sync AllFoodList同步数据以确保 tooltip 显示正常。
客户端的 GUI 在修改配置后需要使用 sync 命令同步数据。包括:在修改了血量增益计算相关配置后,血量概述在执行 sync 后会重新计算并显示在客户端;在重设黑名单后,执行同步以同步客户端 GUI 的食物概述。
客户端的食物概述显示的是所有已发现食物 / 非黑名单食物,而不是所有已发现食物 / 所有已发现食物+非黑名单食物的并集。
whitelist | 白名单
- 类型: List
- 默认值:
[],
- 说明:列表存在大于等于 1 项时,启用白名单。启用后则只有白名单内的食物可提供增益,同时黑名单也会阻止白名单的项目,所以如果希望启用白名单建议同时删除所有黑名单项目 (在黑白名单修改后,玩家已发现的食物不受影响,未发现的食物不再计入统计)。
相关机制和操作说明:
客户端的 tooltip 会显示所有已发现食物 (不管是否存在于黑名单,机制应用于保存黑名单前已发现的某一食物),未发现且处于黑名单内的食物不显示。修改后使用
/sol2f sync AllFoodList同步数据以确保 tooltip 显示正常。
客户端的 GUI 在修改配置后需要使用 sync 命令同步数据。包括:在修改了血量增益计算相关配置后,血量概述在执行 sync 后会重新计算并显示在客户端;在重设黑名单后,执行同步以同步客户端 GUI 的食物概述。
客户端的食物概述显示的是所有已发现食物 / 非黑名单食物,而不是所有已发现食物 / 所有已发现食物+非黑名单食物的并集。
在修改血量配置后,食用未发现食物,或重生 (未开启死亡重置配置) 以重新计算血量增益值。
机制:在每次食用新食物、死亡重生时会按照最新配置计算血量增益值。
饱食度衰减系统
所有配置项以 FoodLevel(饱食度)计算,2 FoodLevel = 1 个鸡腿图标。
EnableNaturalHunger | 启用自然饥饿
- 类型: boolean
- 默认值: false
- 说明: 启用后,玩家会随时间损失饥饿值。
NaturalHungerPeriod | 自然饥饿周期
- 类型: int
- 默认值: 1200
- 说明: 配置值代表 tick (游戏刻 ↗ 游戏刻-Minecraft Wiki),每达到一定配置的游戏刻,按照函数计算衰减。
NaturalHungerExpression | 自然饥饿衰减计算函数
- 类型: 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(假)。
配方示例:
- 基础固定消耗: 每周期扣 0.5 点。
"NaturalHungerExpression": "0.5"- 环境动态消耗: 疾跑或游泳:扣 4 点,淋雨或站在水中:扣 2 点,其他情况:扣 1 点。
"NaturalHungerExpression": "if(or(isSprinting, isSwimming), 4, if(or(isBeingRainedOn, isTouchingWater), 2, 1))"- 黑暗生存挑战: 在黑暗处 (
BrightnessAtEyes< 0.1) 消耗加倍。
"NaturalHungerExpression": "if(lt(BrightnessAtEyes, 0.1), 2, 1)" - 动作:
EnableSleepHunger | 启用睡眠饥饿
- 类型: boolean
- 默认值: false
- 说明: 启用后,玩家睡醒时会根据函数扣除一定饥饿值。
SleepHungerExpression | 睡眠饥饿衰减计算函数
- 类型: string
- 默认值: "SleepDuration / 3000"
- 说明: 用于计算每次睡醒时衰减的饱食度的值 (将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),指南详见下文函数编写指南
可用变量:- 睡眠:
SleepDuration(睡眠时长(tick),按照游戏内时间而非睡眠经历的绝对 tick ↗ "24小时制"下的Minecraft-Minecraft Wiki) - 状态:
FoodLevel(当前饥饿值),Saturation(饱食度),Exhaustion(消耗度) ↗ 饥饿机制详解-Minecraft Wiki
- 睡眠:
MinFoodLevel | 饥饿衰减下限
- 类型: int
- 默认值: 1
- 说明: 本 mod 的饥饿衰减 (包括自然饥饿衰减和睡眠饥饿衰减) 所能扣除到的最小值,若小于该值则不再扣除,若扣除后小于该值则扣除至该值,否则按照函数默认扣除。
函数使用指南:
函数编写指南
- 你可以使用
e和pi代表e和π。运算
- 普通四则运算(加+减-乘*除/),用括号表示的优先级 (例如
( 1 + 2 ) * 3)。- 幂运算
pow(底数, 指数)。- 约数:
- 向下取整数:
floor(num)。- 四舍五入数:
round(num)。- 向上取整数:
ceil(num)。- 取大小值:
- 取大值:
max(num1, num2)。- 取小值:
min(num1, num2)。- 对数:
log(底数, 真数)。逻辑
- 判断:
if(condition, A, B),如果 condition > 0 返回 A,否则返回 B。- 逻辑与:
and(A, B),两者都大于 0 返回 1,否则返回 0。- 逻辑或:
or(A, B),A 或 B 任意一个超过 0 返回 1,否则返回 0。- 逻辑非:
not(A),大于 0 返回 0,否则返回 1。比较逻辑
- 大于:
gt(A, B),如果 A > B,返回 1,否则返回 0。- 小于:
lt(A, B),如果 A < B,返回 1,否则返回 0。- 等于:
eq(A, B),如果 A = B,返回 1,否则返回 0。- 不等于:
neq(A, B),如果 A ≠ B,返回 1,否则返回 0。
客户端配置
这些配置存放于 /config/spice-of-life-fabric-flavor-client.json。
这些配置仅影响本地客户端显示,服务端的该配置无效。
ShowConsumedTooltips | 显示已发现食物tooltip
- 类型: boolean
- 默认值: true
- 说明: 控制客户端的 tooltip 显示。
ShowUnconsumedTooltips | 显示未发现食物tooltip
- 类型: boolean
- 默认值: true
- 说明: 控制客户端的tooltip显示。
关于命令
CleanHealth | 重置玩家数据
/sol2f clearhealthy
重置当前玩家的生命值上限与所有食物摄入记录,需管理员权限。(版本:2.0+)
GetPlayerData | 获取已发现列表
/sol2f getlist <player>
获取玩家已发现食物列表。
Sync | 同步数据
/sol2f sync
同步所有数据。
/sol2f sync PlayerData同步玩家数据。主要用于GUI显示和tooltip显示控制。/sol2f sync AllFoodList同步食物数据:最新的非黑名单食物数据,玩家最大血量上限数据。主要用于GUI显示和tooltip显示控制。
关于食物簿
在修改配置后请使用命令同步数据以确保GUI显示的数据为最新数据。
食物簿页面

- 4.0.0之前的版本,使用鼠标滚轮翻页。

- 4.0.0之后的版本,支持动态布局,平滑滚动。
概述页面

- 血量概述:当前获得的mod增益 / 最大可获得的mod增益。
按键绑定
打开GUI的快捷键在minecraft的按键绑定中配置

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

依赖
- Mod Menu (v2.2.0+ 可选)配置页面入口
- Cloth Config API (v2.2.0+ 必装)
- Fabric API (必装)
该模组根据 Apache 2.0 协议 重新分发了 exp4j 。
Switch Language:
Notice: The translation is completed by AI and may be not correct.
Overview
本模组鼓励玩家尝试各种食物,每吃一种新食物都会永久增加生命值上限作为奖励。它旨在为整合包扩展其食物系统提供动力,并为平衡游戏难度提供了一种新的方式。
Mod Guide
注意: 下面的配置和 GUI 部分适用于模组版本 3.2.0。对于其他版本,请参阅游戏内的 tooltip 和配置界面。
Configuration
Important: Health Values
所有与健康相关的数值均以**生命值点(health points)**为单位。2 个生命值点 = 1 颗心。
Server-Side Configuration (/config/spice-of-life-fabric-flavor.json)
这些设置由服务器控制。在单人世界中,它们会影响你的本地存档。
Health Gain System
maxHealth - Maximum Bonus Cap
- 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.
healthGain - Bonus per New Food
- Type:
int - Default:
2 - Range:
0~20 - What it does: The amount of health (in HP) granted for each new food discovered. Set to
0to disable the base gain.
resetOnDeath - Reset on Death
- 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.
healthToMaxOnIncrease - Heal to Max on Gain
- 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, thehealthIncreaseOnIncreasesetting below is ignored.
healthIncreaseOnIncrease - Heal Amount on Gain
- 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
healthToMaxOnIncreaseis set tofalse.
Expression - Custom Bonus Formula
- Type:
string - Default:
"0" - What it does: A custom formula for calculating your health bonus. The result is added to the
healthGainvalue. - Variable:
uniqueFoods(the total number of unique foods you've eaten). - Syntax: See the Function Guide below.
blacklist - Food Blacklist
- 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 AllFoodListto 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.
whitelist - Food Whitelist
- 类型:
List - 默认值:
[]
- 作用: 当列表包含 1 个或多个物品时,启用白名单。只有白名单中的食物才能提供生命值加成。请注意,黑名单仍然可以屏蔽白名单中的物品,因此如果你打算使用白名单,建议清空黑名单中的所有物品。(更改黑名单/白名单后,玩家已发现的食物不受影响;未发现的食物的计数将不再计入。)
- 工作原理:
- 工具提示(Tooltips): 客户端工具提示显示所有已发现的食物(即使它们现在位于黑名单中——这仅适用于你在将其加入黑名单 之前 已经发现它们的情况)。黑名单上的未发现食物不会显示。更改配置后,运行
/sol2f sync AllFoodList以确保工具提示正确显示。 - GUI 同步: 更改配置后,你必须使用同步命令来更新客户端 GUI。例如,如果你修改了生命值获取计算设置,在运行同步命令后,生命值概览将在客户端重新计算并更新。如果你重置了黑名单/白名单,请同步以更新客户端 GUI 中的食物概览。
- 食物概览显示: 客户端的食物概览显示为
所有已发现食物 / 非黑名单食物。它不显示所有已发现食物与所有非黑名单食物的并集。
- 工具提示(Tooltips): 客户端工具提示显示所有已发现的食物(即使它们现在位于黑名单中——这仅适用于你在将其加入黑名单 之前 已经发现它们的情况)。黑名单上的未发现食物不会显示。更改配置后,运行
应用配置更改: 更改与健康相关的设置后,新值将在你下一次食用 新的 食物或重生时生效(如果
resetOnDeath为false)。每当你的uniqueFoods数量发生变化或在死亡/重生时,模组都会重新计算你的加成。
饥饿衰减系统
注意: 此处的数值使用的是原版 食物等级(Food Level),其中 2 食物等级 = 1 鸡腿。
EnableNaturalHunger - 基于时间的饥饿
- 类型:
boolean - 默认值:
false - 作用: 如果为
true,玩家将随时间被动损失饥饿度。
NaturalHungerPeriod - 衰减间隔
- 类型:
int - 默认值:
1200 - 作用: “自然饥饿”衰减触发的频率(以游戏刻为单位,20 刻 = 1 秒)。每次触发时,它会减去由
NaturalHungerExpression计算得出的数值。
NaturalHungerExpression - 衰减公式(基于时间)
- 类型:
string - 默认值:
"1" - 作用: 一个自定义公式,用于确定每个衰减间隔扣除多少饥饿度(食物等级)。
- 变量:
- 动作:
isSprinting(正在冲刺)、isSwimming(正在游泳)、isSneaking(正在潜行)、isCrawling(正在爬行) - 环境:
isTouchingWater(接触水)、isBeingRainedOn(被雨淋)、isWet(潮湿)、BrightnessAtEyes(眼部的渲染亮度,0.0-1.0) - 状态:
FoodLevel(当前饥饿度)、Saturation(饱和度)、Exhaustion(疲劳值) - 注意:布尔变量返回
1.0(真)或0.0(假)。
- 动作:
- 语法: 参见下方的 函数指南。
- 示例:
- 固定消耗: 每个周期损失 0.5 饥饿度。
"NaturalHungerExpression": "0.5" - 动态消耗: 冲刺或游泳时损失 4,在雨中或水中时损失 2,否则损失 1。
"NaturalHungerExpression": "if(or(isSprinting, isSwimming), 4, if(or(isBeingRainedOn, isTouchingWater), 2, 1))"
- 固定消耗: 每个周期损失 0.5 饥饿度。
EnableSleepHunger - 起床饥饿
- 类型:
boolean - 默认值:
false - 作用: 如果为
true,玩家在睡觉醒来后会损失饥饿度。
SleepHungerExpression - 衰减公式(起床)
- 类型:
string - 默认值:
"SleepDuration / 3000" - 作用: 一个自定义公式,用于确定你醒来时扣除多少饥饿度(食物等级)。
- 变量:
- 睡眠:
SleepDuration(跳过的时间,以刻为单位) - 状态:
FoodLevel、Saturation、Exhaustion
- 睡眠:
- 语法: 参见下方的 函数指南。
MinFoodLevel - 最低饥饿底线
- 类型:
int - 默认值:
1 - 作用: 该模组的饥饿系统(包括基于时间和起床的饥饿)能将你的食物等级降低到的最低值。当你达到此值时,衰减将停止。
函数语法指南
点击展开
-
常量: 你可以使用
e和pi。 -
算术运算:
- 基础:
+、-、*、/以及括号()。 - 幂运算:
pow(base, exponent) - 取整:
floor(num)、round(num)、ceil(num) - 最小/最大值:
min(a, b)、max(a, b) - 对数:
log(base, argument)
- 基础:
-
逻辑运算:
- 条件判断:
if(condition, value_if_true, value_if_false)(条件 > 0 为真) - AND(与):
and(a, b)(如果两者都 > 0 则返回1,否则返回0) - OR(或):
or(a, b)(如果任一者 > 0 则返回1,否则返回0) - NOT(非):
not(a)(如果 a <= 0 则返回1,否则返回0)
- 条件判断:
-
比较运算:
- 大于:
gt(a, b)(如果 a > b 则返回1,否则返回0) - 小于:
lt(a, b)(如果 a < b 则返回1,否则返回0) - 等于:
eq(a, b)(如果 a == b 则返回1,否则返回0) - 不等于:
neq(a, b)(如果 a != b 则返回1,否则返回0)
- 大于:
客户端配置 (/config/spice-of-life-fabric-flavor-client.json)
这些设置仅影响你的本地显示。服务器不关心这些设置。
ShowConsumedTooltips - 显示“已食用”工具提示
- 类型:
boolean - 默认值:
true - 作用: 在你已经发现的食物上显示工具提示。
ShowUnconsumedTooltips - 显示“新”工具提示
- 类型:
boolean - 默认值:
true - 作用: 在你尚未发现的食物上显示工具提示。
指令
/sol2f clearhealthy - 重置玩家
- 用法:
/sol2f clearhealthy - 功能说明: 重置你的生命值加成和食物发现列表。需要操作员权限。(v2.0+ 新增)
/sol2f getlist <player> - 查看已发现的食物
- 用法:
/sol2f getlist <player> - 功能说明: 显示特定玩家已发现的食物列表。
/sol2f sync - 同步数据
- 用法:
/sol2f sync PlayerData- 同步玩家的发现列表。如果 GUI 工具提示看起来不正确,请使用此命令。/sol2f sync AllFoodList- 同步全局食物列表。在更改黑名单后必须运行此命令,以更新 GUI 和客户端显示。
食物之书
更改任何配置后,请运行相应的 /sol2f sync 命令,以确保 GUI 显示正确的信息。
食物之书页面

- 浏览你的发现记录。使用滚轮翻页。
概览页面

- 生命值摘要: 显示
当前模组加成 / 最大可能加成。
按键绑定
你可以在 Minecraft 的控制菜单中设置快捷键来打开食物之书。

食物之书物品
合成配方
制作“食物之书”即可在不使用快捷键的情况下访问界面。

依赖项
- Fabric API(必需)
- Cloth Config API(必需)
- Mod Menu(可选)- 提供配置屏幕入口点。
本模组在 Apache 2.0 LICENSE 下重新分发 exp4j。
你是这个资源的作者?登录后可认领此资源。
相似资源
让你能够在世界中的任何位置定位结构。
一堆修复
TerraFirmaCraft (TFC) 是一个全面转换模组,对生存模式进行了彻底的改造与重新设计。
所有本应存在的事物
为 Cobblemon 添加 Mega 进化、Z 招式、太晶化、超极巨化/超巨大化、究极爆击与融合!
一款适用于你选择的加载器的 Minecraft VR 模组!

评论 0
登录后参与评分
还没有评论,来抢沙发吧