Drop Stacker

模组

· 作者 suwizx_

适用于 Minecraft 的 Fabric 模组,可自动将地面上掉落的物品实体合并为堆叠实体——减少服务器和单人世界的物品卡顿。支持配置堆叠大小、扫描半径和扫描间隔。

0 本站下载 0 关注 更新于 2 周前

需要前置:Fabric Language Kotlin、Fabric API

最新 1.3.0 · 26.3 · Fabric

一键开服(送7天)

Drop Stacker

一个用于 Minecraft 的 Fabric 模组,可自动将地面上掉落的物品实体堆叠为单个实体,从而减少实体卡顿并保持世界整洁。

功能特性

  • 即时合并: 新掉落的物品在生成的瞬间就会被吸收进附近的堆中——在同一刻完成,而非等待扫描间隔。怪物的掉落物在你看到它们落地之前就已经坍缩合并了。
  • 整堆坍缩: 每次合并操作会一次性排干所有兼容的相邻堆,因此一个包含 100 个物品的堆会在单次操作中变为一个实体,而不是一次只合并一个物品。
  • 无限堆叠: 支持超出原版 64 个物品的上限——最多可达你配置的 maxStackSize,并支持针对单个物品的覆盖设置。
  • 视觉反馈: 在物品上方显示彩色的堆数量标签(阈值可配置)。
  • 消失计时器: 标签上可选地显示倒计时,并根据紧迫感进行颜色编码(支持使用 ∞ 表示无限物品)。
  • 自适应扫描: 闲置的堆会逐渐降低扫描频率(最高至 maxScanInterval),因此满是静止物品的世界几乎不消耗性能。这是安全的,因为新掉落物会在生成时推入堆中,而不是等待被轮询。
  • 物品规则: 黑名单、白名单以及针对单个物品的堆叠大小覆盖——均接受物品标签(如 #minecraft:logs)以及精确 ID。
  • 运行时控制: /dropstacker 命令可在不重启的情况下重载配置文件、报告统计信息并调整设置。
  • 尊重命名物品: 拥有自定义名称的物品实体永远不会被重新标记或无声地吸收到其他堆中。
  • 原版兼容性: 合并操作遵循原版的无限寿命、临近消失和无限拾取延迟保护机制,并保留最长的拾取延迟,以确保合并不会缩短它。
  • 仅服务端运行: 所有逻辑均在服务器端执行。未安装模组的原版客户端也能看到数量和计时器。

依赖要求

命令

/dropstacker 需要权限等级 2(管理员)。

命令 描述
/dropstacker reload 从磁盘重载配置文件
/dropstacker stats 查看合并次数、坍缩的实体数及当前设置
/dropstacker resetstats 重置计数器
/dropstacker toggle 在运行时启用/禁用堆叠功能
/dropstacker set maxStackSize <n> 更改堆叠上限
/dropstacker set scanInterval <n> 更改扫描间隔
/dropstacker set radius <n> 更改水平扫描半径
/dropstacker set verticalRadius <n> 更改垂直扫描半径

配置

配置文件会自动创建在 .minecraft/config/drop-stacker.json(服务器端则为 config/drop-stacker.json)。如果你升级模组,字段会在重启时自动更新。

{
  "enabled": true,
  "mergeOnSpawn": true,
  "maxStackSize": 1000,
  "radius": 5.0,
  "verticalRadius": 2.0,
  "scanInterval": 5,
  "maxScanInterval": 100,
  "maxMergePerPass": 64,
  "ageInheritance": "YOUNGEST",
  "labelMode": "ALWAYS",
  "showDespawnTimer": true,
  "countLowThreshold": 64,
  "countHighThreshold": 500,
  "hideSingleItemLabel": false,
  "despawnTicks": 6000,
  "blacklist": [],
  "whitelist": [],
  "overrides": {}
}
字段 描述 默认值
enabled 所有堆叠功能的总开关 true
mergeOnSpawn 新掉落物生成时立即合并 true
maxStackSize 每个堆叠实体的最大物品数量 1000
radius 水平扫描半径(方块) 5.0
verticalRadius 垂直扫描半径(方块) 2.0
scanInterval 活跃堆之间合并扫描的间隔刻度 5
maxScanInterval 闲置堆退避到的最慢扫描速率 100
maxMergePerPass 单次操作中吸收的最大相邻堆数量 64
ageInheritance 合并时的消失计时器继承策略:YOUNGEST(最年轻)、KEEP_RECEIVER(保持接收者)或 OLDEST(最古老) YOUNGEST
labelMode 何时显示标签:ALWAYS(始终)、STACKED_ONLY(仅堆叠时)或 NEVER(从不) ALWAYS
showDespawnTimer 在标签上显示消失倒计时 true
countLowThreshold 标签变黄的计数阈值 64
countHighThreshold 标签变红的计数阈值 500
hideSingleItemLabel 如果堆中只有一个物品,则隐藏标签 false
despawnTicks 世界消失速率(与服务器设置的计时器匹配) 6000
blacklist 永不堆叠的物品列表 []
whitelist 若非空,仅堆叠这些物品 []
overrides 针对单个物品的堆叠上限 {}

物品规则

blacklist、whitelist 和 overrides 均接受精确物品 ID 和物品标签(以 # 开头):

{
  "blacklist": ["minecraft:elytra", "#minecraft:shulker_boxes"],
  "overrides": {
    "minecraft:cobblestone": 5000,
    "#minecraft:logs": 512
  }
}

关于 ageInheritance 的说明

默认的 YOUNGEST 意味着当堆吸收掉落物时,它会继承剩余寿命最长的那个——因此农场旁边的堆会不断重置其消失计时器,实际上永远不会消失。这很方便,但在繁忙的服务器上,这会导致物品堆无限累积。如需原版消失行为,请设置为 KEEP_RECEIVER。

构建

./gradlew build

输出的 JAR 文件位于 build/libs/ 目录中。Gradle 会自动提供所需的 Java 25 工具链。

许可证

MIT — 见 LICENSE。


[!CAUTION] 我不擅长 Kotlin,该项目是在 AI 协助下构建的。可能存在糟糕的代码、错误的模式或可以做得更好的地方。如果你发现任何问题——请提交 Issue 或 Pull Request。我真诚地感谢你的贡献,并将从中学习。谢谢。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源