Spice of Life: Fabric Flavor

--- <H4 id="CN">Switch Language:</H4> (#EN) --- # 概述 > ~~_我chovy，spice of fabric还不更新？_~~(终于更新了) > > ————咸味闲鱼 > # mod ~~*食用*~~ 指南 该指南的config和GUI说明部分为最新版本（3.2.0）维护，其他版本呢详情请参考游戏内配置页面提示。 ## 关于配置 ### 服务端配置 这些配置存放于 ``/config/spice-of-life-fabric-flavor.json``。 这些配置在服务端生效，本地游戏版本的配置影响本地游戏存档。 #### 生命增益系统 所有配置项以health计算，2health=1heart（红心） <details><summary>maxHealth | 最大血量</summary> - 类型: int - 默认值: 5000 - 取值范围: 2~5000 - 说明: 设置本 Mod 能提供的最大额外生命值(玩家最终血量 = 原版血量 + 其他 Mod 增益 + 本 Mod 增益。此选项仅限制“本 Mod 增益”的上限,防止数值无限膨胀) </details> <details><summary>healthGain | 生命值增益</summary> - 类型: int - 默认值: 2 - 取值范围: 0~20 - 说明: 每发现一个食物的生命值增益(设置此为0则等于禁用) </details> <details><summary>resetOnDeath | 死亡重置</summary> - 类型: boolean - 默认值: false - 说明: 启用后,玩家死亡时血量将重置为默认值,且删除所有已发现记录 </details> <details><summary>healthToMaxOnIncrease | 增益时恢复血量</summary> - 类型: int - 默认值: 0 - 取值范围: 任意 - 说明: 每次生命值增益时恢复血量数值,若大于上限则恢复到上限 </details> <details><summary>healthIncreaseOnIncrease | 增益时恢复满血</summary> - 类型: boolean - 默认值: false - 说明: 每次生命值增益时恢复血量至上限 </details> <details><summary>Expression | 生命值增益计算函数</summary> - 类型: string - 默认值: 0 - 说明: 写法详见下文(#ExpU)<br> 可用变量: `uniqueFoods`食用过的食物数 </details> <details><summary>blacklist | 黑名单</summary> - 类型: List - 默认值: ```json , ``` - 说明：列表中的食物不再会被记录(在黑名单修改后,玩家已发现的食物不受影响,未发现的食物不再计入统计) **相关机制和操作说明**: 客户端的tooltip会显示所有已发现食物(不管是否存在于黑名单,机制应用于保存黑名单前已发现某一食物),未发现且处于黑名单内的食物不显示.修改后使用 /sol2f sync AllFoodList 同步数据以确保tooltip显示正常<br> 客户端的GUI在修改配置后需要使用sync命令同步数据.包括: 在修改了血量增益计算相关配置后,血量概述在执行sync后会重新计算并显示在客户端;在重设黑名单后,执行同步以同步客户端GUI的食物概述.<br> 客户端的食物概述显示的是所有已发现食物/非黑名单食物,而不是所有已发现食物/所有已发现食物+非黑名单食物的并集 </details> <details><summary>whitelist | 白名单</summary> - 类型: List - 默认值: ```json , ``` - 说明：列表存在大于等于1项时，启用白名单，启用后则只有白名单内食物可提供增益，同时黑名单也会阻止白名单的项目，所以如果希望启用白名单建议同时删除所有黑名单项目(在黑白名单修改后,玩家已发现的食物不受影响,未发现的食物不再计入统计) **相关机制和操作说明**: 客户端的tooltip会显示所有已发现食物(不管是否存在于黑名单,机制应用于保存黑名单前已发现某一食物),未发现且处于黑名单内的食物不显示.修改后使用 /sol2f sync AllFoodList 同步数据以确保tooltip显示正常<br> 客户端的GUI在修改配置后需要使用sync命令同步数据.包括: 在修改了血量增益计算相关配置后,血量概述在执行sync后会重新计算并显示在客户端;在重设黑名单后,执行同步以同步客户端GUI的食物概述.<br> 客户端的食物概述显示的是所有已发现食物/非黑名单食物,而不是所有已发现食物/所有已发现食物+非黑名单食物的并集 </details> > 在修改血量配置后,食用未发现食物,或重生(未开启死亡重置配置)以重新计算血量增益值 <br> > 机制: 在每次食用新食物、死亡重生时会按照最新配置计算血量增益值 #### 饱食度衰减系统 所有配置项以FoodLevel(饱食度)计算，2 FoodLevel=1 小鸡腿图标 <details><summary>EnableNaturalHunger | 启用自然饥饿</summary> - 类型: boolean - 默认值: false - 说明: 启用后,玩家会随时间损失饥饿值 </details> <details><summary>NaturalHungerPeriod | 自然饥饿周期</summary> - 类型: int - 默认值: 1200 - 说明: 配置值代表tick(游戏刻 (https://zh.minecraft.wiki/w/%E5%88%BB?variant=zh-cn#%E6%B8%B8%E6%88%8F%E5%88%BB)),每达到一定配置的游戏刻,按照<a href="#NaturalHungerExpression">函数</a>计算衰减 </details> <details id="NaturalHungerExpression"><summary>NaturalHungerExpression | 自然饥饿衰减计算函数</summary> - 类型: string - 默认值: "1" - 说明: 用于计算每次自然衰减值的函数(将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),写法详见下文(#ExpU)<br> **可用变量 (Variables):** - **动作**: `isSprinting` (疾跑), `isSwimming` (游泳), `isSneaking` (潜行), `isCrawling` (爬行) - **环境**: `isTouchingWater` (接触水), `isBeingRainedOn` (淋雨), `isWet` (潮湿(接触水或淋雨或接触气泡柱)), `BrightnessAtEyes` (玩家眼镜坐标的**渲染亮度**(0.0-1.0) (https://zh.minecraft.wiki/w/%E4%BA%AE%E5%BA%A6#%E6%B8%B2%E6%9F%93%E4%BA%AE%E5%BA%A6)) - **状态**: `FoodLevel` (当前饥饿值), `Saturation` (饱食度), `Exhaustion` (消耗度) (https://zh.minecraft.wiki/w/%E9%A5%A5%E9%A5%BF#%E6%9C%BA%E5%88%B6)<br> *注：所有布尔变量在公式中为 `1.0` (真) 或 `0.0` (假)*<br> **配方示例:** 1. **基础固定消耗**: 每周期扣 0.5 点。 ```json "NaturalHungerExpression": "0.5" ``` 2. **环境动态消耗**: 疾跑或游泳：扣 4 点,淋雨或站在水中：扣 2 点,其他情况：扣 1 点 ```json "NaturalHungerExpression": "if(or(isSprinting, isSwimming), 4, if(or(isBeingRainedOn, isTouchingWater), 2, 1))" ``` 3. **黑暗生存挑战**: 在黑暗处 (`BrightnessAtEyes` < 0.1) 消耗加倍。 ```json "NaturalHungerExpression": "if(lt(BrightnessAtEyes, 0.1), 2, 1)" ``` </details> <details><summary>EnableSleepHunger | 启用睡眠饥饿</summary> - 类型: boolean - 默认值: false - 说明: 启用后,玩家睡醒时会根据<a href="#SleepHungerExpression">函数</a>扣除一定饥饿值 </details> <details id="SleepHungerExpression"><summary>SleepHungerExpression | 睡眠饥饿衰减计算函数</summary> - 类型: string - 默认值: "SleepDuration / 3000" - 说明: 用于计算每次睡醒时衰减的饱食度的值(将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),指南详见下文(#ExpU)</a><br> **可用变量:** - **睡眠**: `SleepDuration` (睡眠时长(tick),按照游戏内时间而非睡眠经历的绝对tick (https://zh.minecraft.wiki/w/%E6%98%BC%E5%A4%9C%E6%9B%B4%E6%9B%BF#24%E5%B0%8F%E6%97%B6%E5%88%B6%E4%B8%8B%E7%9A%84Minecraft%E6%97%A5)) - **状态**: `FoodLevel` (当前饥饿值), `Saturation` (饱食度), `Exhaustion` (消耗度) (https://zh.minecraft.wiki/w/%E9%A5%A5%E9%A5%BF#%E6%9C%BA%E5%88%B6)<br> </details> <details><summary>MinFoodLevel | 饥饿衰减下限</summary> - 类型: int - 默认值: 1 - 说明: 本mod的饥饿衰减(包括自然饥饿衰减和睡眠饥饿衰减)所能扣除到的最小值,若小于该值则不再扣除,若扣除后小于该值则扣除至该值,否则按照函数默认扣除 </details> <h4 id="