命名空间游戏规则 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$ 个或更多物品时才渲染浮空标签。