Spice of Life: Fabric Flavor

模组

· 作者 XianFish

为 Fabric 增添生活气息

0 本站下载 0 关注 更新于 2 个月前

需要前置:Fabric API

最新 4.0.0-Alpha.dev1 · 26.2 · Fabric

一键开服(送7天)

切换语言:

点击链接前往英文版本


概述

一款简单的食物机制扩充模组,包含一些生活调味料的趣味功能。

模组 食用 指南

本指南中的配置和 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 | 自然饥饿周期
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 (假)。
      配方示例:
    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)"
    
EnableSleepHunger | 启用睡眠饥饿
  • 类型: boolean
  • 默认值: false
  • 说明: 启用后,玩家睡醒时会根据函数扣除一定饥饿值。
SleepHungerExpression | 睡眠饥饿衰减计算函数
  • 类型: string
  • 默认值: "SleepDuration / 3000"
  • 说明: 用于计算每次睡醒时衰减的饱食度的值 (将玩家的饱食度减少此函数的结果,而非设置为此函数的结果),指南详见下文函数编写指南
    可用变量:
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显示的数据为最新数据。

食物簿页面

GUI_foodbook

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

使用FluentUI-MC重构了GUI

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

GUI_overview

  • 血量概述:当前获得的mod增益 / 最大可获得的mod增益。
按键绑定

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

物品

食物簿

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

依赖

该模组根据 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 0 to 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, the healthIncreaseOnIncrease setting 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 healthToMaxOnIncrease is set to false.
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 healthGain value.
  • 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 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.
whitelist - Food Whitelist
  • 类型: List
  • 默认值:
[]
  • 作用: 当列表包含 1 个或多个物品时,启用白名单。只有白名单中的食物才能提供生命值加成。请注意,黑名单仍然可以屏蔽白名单中的物品,因此如果你打算使用白名单,建议清空黑名单中的所有物品。(更改黑名单/白名单后,玩家已发现的食物不受影响;未发现的食物的计数将不再计入。)
  • 工作原理:
    • 工具提示(Tooltips): 客户端工具提示显示所有已发现的食物(即使它们现在位于黑名单中——这仅适用于你在将其加入黑名单 之前 已经发现它们的情况)。黑名单上的未发现食物不会显示。更改配置后,运行 /sol2f sync AllFoodList 以确保工具提示正确显示。
    • GUI 同步: 更改配置后,你必须使用同步命令来更新客户端 GUI。例如,如果你修改了生命值获取计算设置,在运行同步命令后,生命值概览将在客户端重新计算并更新。如果你重置了黑名单/白名单,请同步以更新客户端 GUI 中的食物概览。
    • 食物概览显示: 客户端的食物概览显示为 所有已发现食物 / 非黑名单食物。它不显示所有已发现食物与所有非黑名单食物的并集。

应用配置更改: 更改与健康相关的设置后,新值将在你下一次食用 新的 食物或重生时生效(如果 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))"
      
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 显示正确的信息。

食物之书页面

GUI_foodbook

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

GUI_overview

  • 生命值摘要: 显示 当前模组加成 / 最大可能加成。
按键绑定

你可以在 Minecraft 的控制菜单中设置快捷键来打开食物之书。 GUI_keybinding

食物之书物品

合成配方

制作“食物之书”即可在不使用快捷键的情况下访问界面。 food book

依赖项

本模组在 Apache 2.0 LICENSE 下重新分发 exp4j。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源