命名空间游戏規則 GameRules 参考 (MC 26.2)
本文件提供 Minecraft 26.2 下 Item Clumps 注册的所有命名空间游戏規則 (GameRules) 的完整参考規範。
📊 游戏規則分類資訊框
| 属性 | 数值 |
|---|---|
| 分類标识符 | item_clumps:item_clumps |
| 本地化标题 | "Item Clumps" (gamerule.category.item_clumps.item_clumps) |
| 注册方法 | DynamicGameRuleManager.registerCategory(...) (DasikLibrary API) |
| 运行时持久化 | 每个世界保存在 level.dat (GameRules CompoundTag) |
| 網路端属性 | 服务端权威判定（在服务端 tick/变动时動態求值） |
📋 完整游戏規則 GameRules 参考表
| 游戏規則标识符 | 类型 | 默认值 | 有效範圍 | 描述与游戏影响 |
|---|---|---|---|---|
item_clumps:enable_clumping | 布尔值 (Boolean) | true | true / false | 总开关。为 true 时地面物品突破堆疊限制聚合。为 false 时恢复原版 64 堆疊合併。 |
item_clumps:max_clump_size | 整數 (Integer) | 9999 | 64 至 2147483647 | 单个實體容纳的最大物品总数。(注：安装 stack-size-adjuster 时自動隐藏并以此模组上限为准)。 |
item_clumps:render_labels | 布尔值 (Boolean) | true | true / false | 为 true 时在巨型聚合体上方显示浮空数量標籤（如 石頭 x500）。 |
item_clumps:merge_radius | 整數 (Integer) | 1 | 1 至 10 | 搜索相同掉落物进行聚合的水平方块半径。 |
item_clumps:label_min_count | 整數 (Integer) | -1 | -1 至 2147483647 | 渲染標籤所需的最小数量。-1 表示采用原版最大堆疊数（鵝卵石 $> 64$，珍珠 $> 16$）。 |
💻 游戏内聊天栏管理操作示例
所有游戏規則均可在游戏内即时生效，无需重启伺服器：
1. 调整搜索聚合半径
text
/gamerule item_clumps:merge_radius 3将物品搜索聚合範圍扩大至水平 $3\text{ 格}$ 半径。
2. 設定超大聚合容量上限
text
/gamerule item_clumps:max_clump_size 50000允许单个地面實體容纳最多 $50,000$ 个物品。
3. 开关浮空数量標籤显示
text
/gamerule item_clumps:render_labels false隐藏所有全息浮空名牌標籤，还原純粹原版视觉效果。
4. 自定义標籤显示最低閾值
text
/gamerule item_clumps:label_min_count 100仅在聚合体包含 $101$ 个或更多物品时才渲染浮空標籤。