Instant Gratification: Stack Size Adjuster Wiki
歡迎查閱 Instant Gratification: Stack Size Adjuster 官方百科文件。本 Minecraft Fabric 模組賦予伺服器管理員與玩家動態自訂物品堆疊上限的能力，涵蓋三大自然類別（64 堆疊、16 堆疊及不可堆疊物品），支援超大數值且絕不膨脹 NBT 資料，同時提供容器掉落物最佳化與溢位保護機制。
📌 倉庫原始碼聲明：本 Wiki 中的文件反映了倉庫中的當前原始碼狀態，可能包含領先於 CurseForge 和 Modrinth 上公開發布版本的最新未發布提交或開發中功能。
📦 Minecraft 版本目錄
- Minecraft 26.2 目標指南 — Minecraft 26.2 的官方安裝、依賴需求與設定指南。
- 版本相容性矩陣 — 支援版本、
ModVersionGuard執行時期檢查及依賴範圍。
🎮 玩家與管理員指南
- 動態遊戲規則參考 — 遊戲內 GameRules 說明（
items_64_limit、items_16_limit、items_1_limit、max_drop_entities）。 - 基於類別的堆疊限制 — 64 堆疊、16 堆疊與單物品縮放機制詳解。
- 容器掉落最佳化 — 實體生成上限、槽位拆分數學與破壞容器防卡頓機制。
- 大型箱子防溢位保護 — 整數溢位數學（$39,768,215$ 安全上限）與雙精度合成邏輯。
- ModMenu 與 YACL 設定 — 主選單 GUI 設定（
stack-size-adjuster.json）與 YACL 3.9.5 介面整合。 - 物品數量 GUI 渲染 — 針對多位數堆疊數量的動態字型縮放演算法。
- Item Clumps 連動整合 — 與 Item Clumps 的地面實體合併協同機制。
- 疑難排解與常見問題 — 常見疑問解答、溢位預防及伺服端/客戶端同步。
💻 開發者與技術參考
- 開發者配置與構建指南 — JDK 25 環境、Gradle 9.3+、Loom 1.15+ 與編譯工作流程。
- 架構與套件結構 — 系統架構樹、套件組織與執行緒安全模型。
- Mixin 參考與注入點 — 在
Item、ItemStack、Container、GiveCommand與DataComponents上的注入點詳解。 - 附屬覆蓋 API — 透過
StackSizeManager.registerOverride註冊自訂堆疊上限覆蓋規則。 - 網路同步協定 — 伺服端向客戶端發送的 S2C 封包
stack-size-adjuster:sync_limit與客戶端選單即時重新整理機制。 - Give 指令處理 — 自訂
GiveCommandHelper，支援超大堆疊數量且防止當機。 - 行為設定檔與條件 — 動態 GameRule 同步狀態機與生命週期。
- 取用端模組整合指南 — 面向第三方附屬開發者的完整整合指南。
- 效能與記憶體影響 — 零 NBT 膨脹與記憶體佔用基準測試。
- 進度與徽章 — 進度系統規範與原版一致性指引。
📜 版權與歸屬
由 Dasik (Rifaditya) 基於 GNU 通用公共授權條款第 3 版 (GPLv3) 開發。