配置项详解：文件字段与游戏内界面。

01配置放在哪，归谁管

所有路径都相对于实例的 config/healthy_diet/；数据包路径另见 data/<命名空间>/healthy_diet/。先看“作用域”，再看“典型刷新方式”。

共 18 个配置入口；输入文件名、路径或字段名过滤。

02server.json：服务端权威分节

一个文件三个分节：gameplay、privacy、shelfMerge。旧版分离文件会在加载时迁入本文件，原文件移入 migration_backup/。

{
  "gameplay": {
    "shelfTemperatureEnabled": false,
    "lsoIntegrationEnabled": true,
    "ecIntegrationEnabled": true,
    "proxyHeatstrokeEffect": true,
    "bonusUpdateTicks": 100,
    "effectUpdateTicks": 200,
    "ejectIllegalProtectedItems": false,
    "removeOwnerOnDeathDrop": false,
    "debugLogs": false
  },
  "privacy": { "sendCommandTextToAllPlayers": false },
  "shelfMerge": {
    "mergeRemainingMinutes": 5,
    "mergeTempThreshold": 10.0,
    "mergeColdFreshThreshold": 20.0
  }
}

gameplay：玩法与刷新间隔

privacy：阶段命令文本

shelfMerge：堆叠合并门槛

03display.json：客户端本地偏好

这份文件只影响当前客户端的外观与编辑默认值，不参与服务器玩法同步。服务端下的玩法开关在 server.json 的 gameplay，不要写回这里。

04营养数据包：组、阶段、加成

三类文件都在 data/<命名空间>/healthy_diet/ 下，以营养组 ID 关联；HD 覆盖层写在 config/healthy_diet/datapack/。文件名就是组 ID，最多 64 个组。

营养组字段

{
  "displayName": "水果",
  "nutritionSymbol": "Ψ ",
  "order": 2,
  "color": "a",
  "decayRate": 6.0,
  "initialValue": 0,
  "gainMultiplier": 1.0,
  "enabled": true
}

阶段字段

加成字段

05物品、提示、方块与品质

这些类型的字段较多，下面只给字段组和入口；具体玩法解释分别放在营养、保质期、Tooltip 和品质章节，避免同一字段在三处写出不同含义。

物品配置的字段组

方块右键变体字段

06保质期与温度环境字段

物品的 shelf 字段控制单件食物；shelf_life/ 与 temperature/ 下的文件控制季节、环境温变和显示方案。字段默认值适合新建，实际物品常在默认数据包中覆盖。

物品 shelf 顶层字段

温度曲线与食用温度效果

common 与温变子对象

shelf_life/ 与 temperature/

07外观方案与小工具

这些文件多数是共享外观或本机小工具，不改变营养/保质期结算。改配色前先确认目标行引用的是哪个方案键。

{
  "silver_mist": { "colors": ["#8e9eab", "#eef2f3"] },
  "warm_example": { "colors": ["#f7971e", "#ffd200"] }
}

08游戏内配置 UI：逐项图解

下面按实际界面的入口和行顺序绘制 HTML 示意。深灰面板、黄色分组标题、输入框、♻、底部按钮参考游戏内界面；窄屏可在预览框内左右滑动。此处的按钮和数值不连服务器，只有温度预览页签可切换说明。

入口：/hdconfig 的四个配置按钮

/hdconfig 是客户端本地命令，执行命令本身会检查 OP4；非 OP 玩家可从其他游戏界面进入本地“客户端外观配置”，不等于可以直接执行该命令。下列预览为 OP 视角，并不表示网页或服务器控制台可以打开本机界面。

客户端外观配置

每位玩家都能进入；只改变本机 display.json，不会调整服务器玩法。

服务端玩法配置

需要 OP 4；从服务端读取 server.json → gameplay，保存后等服务端回执并同步给在线玩家。

温度系统联动配置

需要 OP 4；读取季节倍率、方块热量、雨雪、昼夜、季节温变五组服务端表；另有 LSO 世界温度独立入口。

群系温度

需要 OP 4；按具体群系编辑其昼夜/天气温差，有 EC 时还可编辑 24 节气温度与降水。

关闭

回到打开此菜单前的游戏页面；不会自动保存子页尚未提交的草稿。

客户端外观配置：12 个可编辑项

行内数值是 DisplayConfig 新建时的默认值，不是你当前 display.json 的值。游戏中列表最多显示 12 行，可滚轮查看；每行的 ♻ 仅把该行草稿还原为默认值，仍需点击底部“保存”。

营养行最大条目数 · 6

普通 Tooltip 营养与条件条目的显示上限；超出截断为“…”而不是另起行。1 只保留第一条；可设 1–100。

标题自动换行宽度 · 1000 px

TitlePro 标题文本超过指定像素宽度才换行；可设 1–100000。

信息右对齐间隙 · 20 px

D 信息模式中左侧文本与右对齐内容之间的固定空隙；可设 0–100000。

D 模式信息面板最大宽度 · 320 px

限制 D 信息面板宽度，超出时内容换行；S 保质期模式按自然宽度，不受此项限制。

显示强制统一药水样式 · 关

总开关。关闭时，即使物品行或下面“默认强制统一”开启，也不使用 HD 的统一效果样式。

自动显示附魔信息 · 开

在 D 信息模式自动显示附魔书说明，前提是有对应翻译文本；不影响附魔本身。

自动显示药水信息 · 开

控制 D 模式中的药水/效果信息块；关闭不影响普通紧凑效果行、温区效果行、手写说明或附魔说明。

隐藏前缀 · 关

仅隐藏 HD 自动加在行首的符号及间距；手写名称、行内分隔符仍保留。

温度单位 · 摄氏

点击在摄氏/华氏之间循环；只换本客户端 Tooltip 和 HUD 的显示，编辑界面与保存的配置仍用摄氏。

默认效果行仅 Shift 显示 · 关

新建效果行及未配置物品的默认可见方式；关=常显，开=按住 Shift 才显示，已保存行不改。

默认强制统一药水效果样式 · 关

新建效果行的强制统一初始值；先要打开上面的统一样式总开关，已保存行保留自己的选择。

饮食值行默认显示方式 · 常显

循环“常显 → Shift → 信息(D) → 关闭”；关闭退回原版/相关模组饮食值行。只影响未单独设置的物品及新建行。

保存 / 返回 / ♻

保存写当前客户端的 display.json 并立即应用；返回不保存草稿；♻ 只重置当前一行，不是全局恢复。

服务端玩法配置：9 项与重置动作

此页只保存 server.json → gameplay；privacy、shelfMerge 没有对应的游戏内行。下列为新建默认值，服务器实值要以 OP 打开时收到的回包为准。

保质期与控温系统 · 关

保质期、温度、冷鲜的总开关；关闭期间暂停推进与相关效果，已有数据保留，重新打开不追补关闭时段。

启用 LSO 联动 · 开

允许食物保质期读取 LSO 的世界环境；关闭不等于关闭其他 LSO 功能。

启用 EC 联动 · 开

允许食物直接使用 EC 气候与 HD 季节变质倍率；不修改 LSO 自带的季节影响。

代理中暑效果 · 开

服务端把 LSO 中暑镜像为 EC 中暑以显示模糊效果；不代替玩家体温规则，是否生效还取决于联动和免疫状态。

属性加成刷新间隔 · 100 tick

营养组的属性奖励重新计算周期，默认约 5 秒；允许 1–1728000 tick。

药水效果刷新间隔 · 200 tick

营养组的药水效果奖励刷新周期，默认约 10 秒；允许 1–1728000 tick。

非法持有时掉落到脚下 · 关

从未被信任的玩家持有受保护物品时，开=丢到脚下，关=留在原位冻结并警告；默认关可减少误判丢失风险。

死亡掉落移除主人标记 · 关

开=所有死亡掉落物清除已有主人，关=仅为原本无主的掉落标注死者，已有主人的保持不变。

测试日志 · 关

开启后服务端输出方块右键和放置/分口食物的诊断明细；所有玩家都会记，排查后建议关闭。

重置默认定义 · 重置

不是重置这 9 个开关！点此后还要确认，会把营养组、阶段、加成、品质、品级五类默认定义写回 HD 覆盖层，同名覆盖、缺失补齐、自建 ID 保留，并立即重载；不可撤销，操作前备份。

保存 / 返回 / ♻

保存发送服务端并等待成功回执；失败不当作成功。返回放弃未保存草稿；♻ 只改当前行的待保存值。

温度系统联动配置：五个表页 + LSO 世界温度入口

六个入口按游戏内的两行三列排列。前五个是同一页签组，切换页签会保留未保存的输入；点击其中任一“保存”会校验并一起提交五张表。第六个“LSO 世界温度”会打开独立页面，不走五表合并保存。预览页签只切换下方说明，不修改文件。

变质倍率 · 服务端季节表

每行一个实际存在的季节/节气 ID，0–100，默认复位为 1；大于 1 加速变质，小于 1 减慢。需 EC 有效节气及服务端“启用 EC 联动”，不改变气温；旧六季节文件仍按六条显示。

方块温变 · 搜索框

按中文名、英文名、方块 ID 或语言键过滤；清空恢复全部。搜索不丢弃已改却未保存的温度。

方块温变 · 每个方块/状态行

正数加热、负数降温，范围 -1000 至 1000；同一方块不同状态会分行，距离和遮挡影响实际贡献。♻ 还原打开页面时的该行数值；“新增方块”从背包选择可放置方块并进入确认流程。HD 自有热量表用于 HD/EC 回退分支；LSO 的世界热量读取走其来源，不能把两者当同一张表。

昼夜温变 · 每节气双框

左“正午”、右“午夜”，各为 -100 至 100°C，默认 0；一天内平滑过渡。若群系另填对应端点，群系值优先。

季节温变 · 每节气单框

每节气额外加算的摄氏温差，-100 至 100°C，默认 0；有 EC 时按当前节气，没有则取立春；不是覆盖 EC 的既有温度。

雨雪温变 · 每节气双框

左“雨/雪”默认 -1°C，右“雷雨/雪”默认 -2°C；各可设 -100 至 100°C。无降水时不施加；群系单独覆盖优先，雷暴不再叠加普通雨雪值。

保存 / 返回 / ♻

五个表页共用一次服务端保存，切页不会丢草稿；保存前校验全部页。每个 ♻ 仅复位对应输入框，返回放弃未保存值。方块页底部另有“新增方块”。

LSO 世界温度

第六个按钮打开独立表单（见下），不是五表页签；仅在 LSO 联动环境中有实际作用，保存后须按 LSO 数据包机制执行 /reload。

24 节气行顺序：立春、雨水、惊蛰、春分、清明、谷雨、立夏、小满、芒种、夏至、小暑、大暑、立秋、处暑、白露、秋分、寒露、霜降、立冬、小雪、大雪、冬至、小寒、大寒。预览只显示前两行，不代表其余 22 行缺失。

LSO 世界温度：独立维度表单

维度 ID

新建时填完整维度 ID（如 minecraft:the_nether）；载入现有文件后只读，不能借改 ID 覆盖另一维度。

基础温度

LSO 世界温度的绝对量纲，不是 °C；可设 -1000 至 1000 的有限数字。

海平面高度 / 海拔影响

sea_level_height 为整数，初始草稿 64；has_altitude 控制高度影响，开启时高处更冷。

查询当前维度

从服务端请求玩家当前维度的世界温度快照；不保存。

文件列表

可搜索、载入或新增维度；“删除”只对 HD 覆盖层文件开放，原生/世界数据包文件只读，删覆盖后回落下一层。

保存 / 关闭

保存写入 HD 配置数据包（已有条目编辑，原生条目创建覆盖），成功后仍须手动 /reload；关闭不保存草稿。旧“昼夜循环刻数”字段不在当前表单中。

群系温度：按群系的覆盖与 24 节气

群系（基温:…）/ 查询其他群系

一次编辑一个群系。基温来自原版群系、只读且不是摄氏度；输入群系 ID 或从列表选择，右侧按钮仅在 EC 可用时显示。

昼夜温差 · 正午 / 午夜

此群系的两个独立覆盖值（°C）：留空继承全局同名端点，填 0 表示显式覆盖成零而非继承；不会与全局值相加。

雨雪/雷雨温差 · 两个输入框

同样留空继承全局，填数值覆盖；只影响温度，雷雨时用雷雨框，不再加普通雨雪框。与昼夜覆盖均属于 HD 自有配置。

平均温度 / 平均降水

EC 环境才出现；批量调整各节气的预计 °C 或最终降水值，属于草稿，仍需保存。

24 节气 · 黄色额外温差

只读展示“季节温变”页同一节气的值；想修改须回温度系统的“季节温变”页；不包含在右侧的 EC 预计气温内。

24 节气 · EC 偏移 / 最终降水

有 EC 时可编辑；EC 偏移不是 °C，最终降水是基础值加节气偏移，不等于完整降雨概率。留空沿用原有设置。

24 节气 · 预计气温 / 自动分配

预计气温按摄氏展示 EC 气候估算，不含方块、天气、昼夜额外值，不能代表玩家/食物最终温度。改预计值后点该行“自动分配”反推 EC 偏移，再点保存。

查询所在群系 / 刷新

前者选玩家脚下的群系并请求配置；后者重算预计值、空白默认值和当前服务端温度详情，不写盘。

保存 / 删除覆盖 / 关闭

保存提交 EC 气候（有 EC 时）及 HD 群系覆盖；EC 气候改动需按 EC 资源重载机制执行 /reload。删除覆盖仅删除此群系 HD 昼夜/天气覆盖以恢复继承，不是删除 EC 或原版群系；关闭不保存草稿。

09保存与刷新方式

同一个“保存”在不同位置含义不同：客户端本地文件、服务端权威分节和启动期注册不能互相替代。

游戏内配置菜单

改完之后做什么