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) 开发。