🧪 即时满足：药水堆叠扩展 Wiki
📌 代码仓库来源声明：本 Wiki 中的技术文档反映了代码仓库中当前的源代码状态，可能包含领先于 CurseForge 与 Modrinth 正式发布版本的未发布提交或开发中特性。
欢迎查阅 Instant Gratification: Potion Stacker Addon（即时满足：药水堆叠扩展） 官方技术文档。本项目是为 Minecraft Fabric 平台设计的 Stack Size Adjuster 专用高性能扩展模组，彻底解决自 Beta 1.9 以来药水占用背包槽位过多的痛点。支持对常规药水、喷溅药水、滞留药水、水瓶以及炖菜进行无缝动态堆叠配置。
🧭 多版本文档传送门
| Minecraft Target | Mod Version | Fabric Loader | Portal Link |
|---|---|---|---|
| Minecraft 26.2 | 1.1.3+26.2 | >=0.19.1 | 👉 Enter Minecraft 26.2 Documentation Portal |
| Minecraft 26.3 | 1.1.3+26.3 | >=0.19.3 | 👉 Enter Minecraft 26.3 Documentation Portal |
⚡ 核心设计理念与技术支柱
- 释放背包空间：默认将药水最大堆叠数提升至 16，并支持在 1 到 2,147,483,647 之间自由配置。
- 符合直觉的酿造台交互：酿造台药水槽保持单瓶容量，Shift 快速放入时智能拆分 1 瓶进入槽位，避免破坏原版酿造机制。
- 客户端/服务端网络动态同步：通过
PotionLimitSyncPayload与broadcastFullState()实时同步游戏规则，消除幽灵物品。 - 智能共存机制：与
stew-stacker-addon共同安装时，自动检测并让渡炖菜处理逻辑，零冲突。 - 零 Mixin 性能开销：纯 API 驱动架构，直接向
StackSizeManager注册CustomStackSizeOverride回调。
📊 默认 GameRule 快速参考表
| GameRule | Type | Default | Range | Target Items |
|---|---|---|---|---|
potion-stacker-addon:potion_limit | Integer | 16 | 1 .. 2,147,483,647 | Regular, Splash, Lingering Potions, Water Bottles |
potion-stacker-addon:stew_limit | Integer | 16 | 1 .. 2,147,483,647 | Mushroom Stew, Rabbit Stew, Beetroot Soup, Suspicious Stew |