Stack Manager

堆叠管理器

可配置的堆叠大小（原版 + 模组）

一个轻量级的服务端模组，会生成一个包含所有物品（原版 + 模组）的配置文件，并允许你为每个物品设置最大堆叠大小。可在单人游戏（内置服务器）和专用服务器上运行。

功能

• 生成 config/stackmanager_items.json，包含所有已注册的物品。
• 可为每个物品设置堆叠上限，随时可编辑。
• 启动/重载时自动添加新安装模组中的新物品。
• 安全的网络上限 = 99，以避免协议/NBT 问题。
• 可选的内置游戏命令（当存在 Fabric API 时启用）。

命令

（可选，需要 Fabric API） /stackmanager reload — 重新加载配置并追加任何缺失的物品。

/stackmanager set — 设置新的上限（限制为 99）。

/stackmanager set default — 恢复游戏/模组默认值（限制为 99）。

没有 Fabric API 时模组仍可正常工作；编辑文件并重启（或使用你喜欢的方式重载）。

配置文件

路径：config/stackmanager_items.json

{
  "formatVersion": 1,
  "items": {
    "minecraft:acacia_button": 64,
    "minecraft:oak_planks": 99
  }
}

• 键是完整的物品 ID（命名空间:物品）。
• 值在加载时会被限制在 1–99 之间。

便捷编辑器快捷键

（VS Code / 大多数编辑器；Windows/Linux = Ctrl，macOS = Cmd，除非另有说明）

格式化文档：

Shift+Alt+F（Win/Linux）· Shift+Option+F（macOS）

• 查找 / 替换： Ctrl+F / Ctrl+H · Cmd+F / Cmd+Alt+F
• 选择下一个匹配项（多光标）： Ctrl+D · Cmd+D
• 跳转到行： Ctrl+G · Cmd+G
• 选择单词 / 行： Ctrl+W（单词）/ Ctrl+L（行）· Option+Shift+→/← 或 Cmd+L（macOS）

提示

• 保持 ID 按字母顺序排列，以便更容易进行差异对比。
• 在 Ctrl+H 中使用正则表达式替换来批量编辑数值。
• 编辑后，运行 /stackmanager reload（如果命令可用）或重启世界/服务器以应用更改。

兼容性与限制

• 模组在服务器端强制执行上限；客户端不需要该模组（除非其他模组要求）。
• 具有不同 NBT（自定义名称、附魔、耐久等）的物品永远不会堆叠，这是原版规则。
• 大多数原版和模组 GUI 都会遵循这些上限。如果某个特定模组的界面仍然限制为 64/99，请报告——可以进行小规模的单界面补丁。
• 高于 99 的数值会被有意降低到 99，以保持网络稳定。

需求

Fabric API：可选但推荐，以获得更好的体验（启用 /stackmanager 命令和更顺畅的重载）。

推荐用法

• 安装 Fabric API（推荐，非必需）以使用内置游戏命令并改善使用体验。
• 在启动世界/服务器之前，直接在配置文件中编辑数值。基于命令的更改——尤其是在没有 Fabric API 的情况下——可能很繁琐，并且可能需要重启或额外步骤。

使用模组的思路

• 药水： 更简单：将药水设置为每格 16 或 32

minecraft:potion: 16
minecraft:splash_potion: 16
minecraft:lingering_potion: 8–16

好处：在袭击、挖矿和 Boss 战中减少背包往返次数。

注意：药水携带 NBT（效果类型）。只有完全相同的药水才会堆叠。

其他快速思路

• 建筑 / 大型项目（便利性）：
• 方块（石头、木板、玻璃、陶瓦）99；食物 64–99；firework_rocket 64–99。
• 探索 / 鞘翅： 火箭 16（更难）或 64–99（更简单）；末影珍珠 16–32（更简单）或 8（更难）。
• 战斗 / PvE： arrow 99；雪球/鸡蛋 64–99，用于活动/小游戏。
• 经济 / 生存挑战： 矿石/锭 16；矿石块 8；珍珠/雪球 8 以抑制刷屏

常见问题

• 如何查找物品 ID？

使用 F3 + H 启用高级工具提示，然后悬停物品：你会看到 命名空间:物品。

• 我可以设置为 9999 吗？

不可以。为了网络安全，有效上限为 99。

• 单人游戏还是服务器？

两者都可以。在单人游戏中，将模组放入 mods/。在专用服务器上，只有服务器需要该模组。