設定項詳解：檔案欄位與遊戲內介面。

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儲存與重新整理方式

同一個「儲存」在不同位置含義不同：用戶端本機檔案、伺服器端權威分節和啟動期註冊不能互相替代。

遊戲內設定菜單

改完之後做什麼