疑難排解與常見問題

📌 倉庫原始碼聲明：本 Wiki 中的文件反映了倉庫中的當前原始碼狀態，可能包含領先於 CurseForge 和 Modrinth 上公開發布版本的最新未發布提交或開發中功能。

---

❓ 常見問題解答

Q1：為什麼已存在的存檔沒有套用 config/stack-size-adjuster.json 中設定的堆疊上限？

答：全域設定檔（stack-size-adjuster.json）僅為新建立的世界提供預設範本初始值。對於已存在的存檔，遊戲規則儲存在存檔的 level.dat 中。請在遊戲內透過 /gamerule 指令或遊戲規則編輯介面調整：

/gamerule stack-size-adjuster:items_64_limit 256

Q2：如果將堆疊上限設定得高於 39,768,215 會發生什麼？

答：設定高於 $39,768,215$ 的數值會面臨大箱子 32 位元整數溢位的風險。一個擁有 54 槽位的大箱子若裝滿 54 組該物品，總數將超過 32 位元有號整數上限（$2,147,483,647$），導致物品總數回繞為負數並在移動物品時造成物品被吞刪除。強烈建議保持上限 $\le 39,768,215$。

Q3：為什麼破壞箱子時只掉落 8 堆物品而不是成千上萬個？

答：這是由 stack-size-adjuster:max_drop_entities 控制的效能最佳化機制（預設值：8）。它可防止在破壞裝有數萬物品的箱子時造成伺服器卡死當機。配合 Item Clumps，這 8 堆物品會在瞬間進一步合併為一個掉落物實體。

---

🛠️ 常見問題排查對照表

症狀表象	潛在原因	解決方案
客戶端物品欄仍顯示原版堆疊上限	網路同步封包遺失或伺服端/客戶端版本不相符	確保在客戶端與伺服端同時安裝了相符的 stack-size-adjuster。
Give 指令提示「物品過多」並執行失敗	/give 數量超出了 $100 \times \text{maxStackSize}$ 的安全上限	減少一次性索取的物品數量，或分批次執行 /give 指令。
ModMenu 中無法開啟 YACL 設定介面	缺少 ModMenu 或 YACL 依賴	在客戶端安裝 ModMenu 與 YetAnotherConfigLib (YACL v3)。