VO:物品团块

VO:物品团块

物品团块彻底重新设计了掉落物品实体在世界中的行为方式,将其合并为轻量级的虚拟超级堆叠,以最大化服务器性能和客户端帧率。

性能

Requires Fabric API Java License Minecraft 26.2+

📦 Item Clumps (仅服务端):“即时满足”更新

无向后移植: 我不会将此模组向后移植到更旧的 Minecraft 版本(1.21、1.20 等)。请勿询问。

在原版 Minecraft 中,掉落的物品会合并,但严格限制最大堆叠数量为 64。如果一个高效生物农场、自动化采石场或大规模 TNT 爆炸掉落了数千个物品,游戏将被迫刻处理和渲染数百个单独的地面实体。这会导致严重的客户端帧率下降、渲染卡顿以及严重的服务器 TPS 下降。

Item Clumps (仅服务端) 通过完全在服务端打破地面实体的 64 物品堆叠限制,改变了这一基础。它将相同物品积极压缩成单个轻量级的虚拟巨型堆叠,默认情况下最多可容纳 9,999 个物品。原版客户端无需安装此模组即可连接到运行此模组的服务器!


🎥 展示视频

物品堆叠展示视频

点击上方图片观看模组实际演示!(CurseForge 不支持嵌入)


✨ 特性

🚀 服务端堆叠大小虚拟化

绕过 64 物品地面堆叠上限。相同物品将合并为单个实体,默认最多容纳 9,999 个物品(可在游戏规则屏幕和通过命令配置,最高可达完整的 32 位整数上限 2,147,483,647)。

海量计数策略: 在此仅服务端版本中,真实虚拟计数直接存储在标准的原版 ItemStack 计数中。由于 Minecraft 26.x 使用标准的 VarInt/整数而非字节来序列化堆叠计数,原版客户端原生支持、同步并显示物品实体上的这些更大计数。

🏷️ 原版兼容的计数标签

在堆叠数量超过正常堆叠时,在其上方渲染一个自定义名称标签(例如 橡木原木 x450)。使用服务端的原版自定义名称标签(setCustomName / setCustomNameVisible),使原版客户端无需任何客户端模组即可显示计数标签。

⏱️ 原版消失计时器规则

为匹配原版合并逻辑,当两个堆叠合并时,合并后的堆叠会继承合并中最年轻物品的存在时间(取较小的年龄值,因为年龄是向上计数的)。这完全像原版一样延长/重置了合并堆叠的消失窗口,确保您不会过早丢失物品。

📦 智能物品栏整合

走过堆叠时,会以最大堆叠块为单位,平滑地将物品转移到您的物品栏中。该模组会动态计算物品栏中的确切可用空间,并仅拾取能容纳的部分,将剩余部分安全地留在地面堆叠中,而不是删除它们或导致同步问题。

⚙️ 漏斗滴入式输入

漏斗以标准的原版传输速度,逐个从虚拟堆叠中抽取物品。这确保您的红石自动化、分类系统和物品电梯管道功能与原版完全一致,保持游戏平衡。

📐 原生物理对齐

为匹配原版合并规则并防止故障,堆叠操作基于可配置的水平方块半径,但会尊重垂直空间。如果物品在垂直方向上相隔 1 个方块或更多(例如,放置在方块顶部的物品不会与方块下方的物品合并),则它们不会合并。


⚙️ 配置

⚠️ 重要提示:配置文件 与 游戏内规则
全局配置文件仅在创建世界时定义新世界的默认值。
如果您已经创建/打开过一个世界,更改配置文件将不会产生任何效果。您必须使用编辑游戏规则 UI 屏幕或 /gamerule 命令在游戏内更改设置。

该模组开箱即用,无需任何设置。所有参数均使用原生 Minecraft 游戏规则系统在游戏内进行管理。

  • 游戏内: 使用 /gamerule item_clumps: 进行核心设置。
    • item_clumps:enable_clumping (默认: true) - 切换堆叠机制。禁用时,物品行为完全与原版相同。
    • item_clumps:max_clump_size (默认: 9999) - 单个堆叠实体可包含的最大物品数量。(如果加载了 Stack Size Adjuster,将自动禁用)。
    • item_clumps:render_labels (默认: true) - 切换在虚拟堆叠上方渲染浮动计数标签。
    • item_clumps:merge_radius (默认: 1) - 物品搜索匹配物品以进行合并的水平方块半径。
    • item_clumps:label_min_count (默认: -1) - 显示堆叠标签前的最低物品计数。设置为 -1 以使用默认的原版堆叠限制。

Item Clumps Game Rules Screenshot

推荐模组: 由于此模组添加了多个游戏规则,我们强烈推荐使用 Collapsible Game Rules 来保持您的设置菜单干净整洁。


📦 安装与环境

🖥️ 环境支持

  • 仅服务端: 所有功能均在服务端完成,兼容原版客户端。
    • 在单人游戏中也有效。

📥 安装说明

  1. 安装 Fabric API。
  2. 下载 item-clumps-*.jar 并将其放入您的 mods 文件夹。

🧩 兼容性

特性 Fabric (26.2+)
单人游戏 ✅
多人游戏 (局域网/服务器) ✅
空维度 ✅

🎮 版本兼容性及支持

  • Minecraft 26.2+: 当前公开发布版本 — 活跃并受支持。
  • Minecraft 26.1.2: 已停止支持

☕ 支持

如果您喜欢 即时满足 系列,请考虑为下一次更新提供支持!

Ko-fi SocioBuzz Saweria


📜 鸣谢

角色 作者
创作者 Rifaditya (Dasik)
系列 即时满足 (Instant Gratification)
许可协议 GNU GPLv3

整合包许可政策:
您可以自由地在任何整合包中包含此模组。但是,严格禁止跨平台重新分发此项目或其文件。托管此项目文件的整合包必须在同一平台(CurseForge)上发布。


为 Minecraft 社区 ❤️ 制作

即时满足系列的一部分