超级拖放

超级拖放

在普通容器、背包、AE2 终端和精致存储网格之间，通过一个持久的拖放中转站批量移动海量物品。

超级拖放消除了在不同存储系统之间转移物品时的重复操作。在一个界面中选择物品，拿起整个批次，打开另一个容器或终端，并将所有物品放置到那里，无需将玩家物品栏作为临时中转区。

1.0.1 版本支持多个 Minecraft 版本和模组加载器，终端集成会根据各版本可用的存储模组世代进行调整。

为什么使用超级拖放？

想象一下，你带着一个装有堆叠升级的“精致背包”探险归来。背包中除了附魔装备、工具、地图、饰品和其他带有 NBT 或数据组件的独特物品外，还装有大量矿石。

这些物品通常应放置在不同的地方：

• 矿石和其他高容量资源非常适合放入 AE2 或精致存储网络。
• 装备和组件丰富的冒险战利品可能更适合放在箱子或专用容器中整理。
• 独特物品应保留其完整的名称、附魔、耐久度、内容物和模组定义的元数据。

通常，玩家物品栏会成为一个小型中转区。你需要反复从背包中取出几组物品，关闭它，打开另一个界面，存入物品，然后重复此过程。

有了超级拖放，你可以选择背包中的所有矿石，并将整个批次直接转移到存储终端。然后选择冒险战利品并将其移入箱子。这些物品完全无需经过玩家物品栏。

精致背包仅仅是一个例子，并非必需的依赖项。

工作原理

1. 按住 Alt 键并在槽位或终端条目上拖动鼠标左键。
2. 左键点击任意选中的物品以拾取整个批次。
3. 关闭当前界面并打开另一个容器或受支持的终端。
4. 左键点击目标位置以尽可能多地插入物品。

你也可以使用 Minecraft 光标拿起一个普通的物品堆叠，然后点击中转站进行存放。

选择修饰键可以在 Minecraft 的“控制”菜单中更改。例如，你可以将 Alt 替换为 Ctrl，而无需更改左键交互方式。

为海量转移而生

超级拖放将存储终端条目视为虚拟资源，而非普通的 64 个一组的物品堆叠。

• 终端和中转站的数量使用 long 类型，支持远超 32 位整数上限的数量。
• 大量物品仅在插入普通容器时才会被分割成真实的 ItemStack 对象。
• 单一物品类型可持续填充所选目标中的所有兼容槽位。
• 多物品批次按容器顺序插入。
• 无法容纳的物品会保留在中转站中。
• 网络传输会尊重权限、容量、提取限制和可用能量。

这使得实际转移数百万甚至数十亿的存储物品成为可能，而无需手动取出成千上万个普通堆叠。

支持的存储系统

• 应用能源2： 通过受支持的物品终端进行批量提取和插入。
• 精致存储 1.x： 由兼容的 Minecraft 1.20.1 Forge 和 NeoForge 版本支持。
• 精致存储 2.x： 由兼容的 Minecraft 1.21.1 版本支持。
• 精致存储 3.x： 由 Minecraft 26.1.2 NeoForge 版本支持。
• 普通容器： 箱子、桶、熔炉、玩家物品栏、模组背包以及其他兼容的容器界面。

AE2、精致存储和 JEI 都是可选的。未安装它们时，普通容器的转移功能仍可正常工作。

集成可用性取决于 Minecraft 版本、加载器以及该平台是否存在兼容的存储模组构建。

可靠的物品数据

中转站条目存储为完整的序列化 ItemStack 原型加上一个独立的 long 类型数量。

物品仅在其完整组件匹配时才会合并，而不仅仅是共享一个物品 ID。这可以保留：

• 数据组件和 CustomData/NBT
• 附魔、耐久度、名称和描述
• 潜影盒和收纳袋的内容物
• 模组定义的组件和元数据
• Minecraft 官方物品序列化支持的其他数据

服务器会验证当前菜单、槽位、权限、物品快照和实际转移的数量。只有确认已插入的数量才会从中转站中移除。

如果目标已满、某个槽位拒绝了物品、终端能量不足或传输失败，未转移的剩余部分会保留在其来源处或中转站中。

持久化转移中转站

该中转站属于玩家，并且在以下情况后仍然可用：

• 更换维度
• 重新连接
• 重启服务器
• 死亡，无论 keepInventory 设置如何

其按钮会自动在当前界面周围搜索未使用的位置。已占用的区域也会注册到 JEI，以便其物品列表能在 JEI 布局系统允许的情况下避开该区域。

默认情况下，中转站一次只接受一个批次。在添加另一批次前请先清空它，或者可以在配置文件中更改此行为。

创造模式支持

1.0.1 版本包含针对创造模式的专门处理：

• 玩家物品栏和快捷栏槽位使用其真实的服务器端映射。
• 正常携带的创造模式物品可以被存放而不会复制。
• 中转站可以将物品放入创造模式快捷栏。
• 中转站内容可以通过创造模式销毁槽丢弃。
• 点击已满的中转站会保留当前光标物品，而不是将其丢弃。

虚拟物品展示槽不是有效的取出目标。请使用真实的玩家物品栏或快捷栏槽位。

配置

服务器配置文件生成于 config/superdragdrop-common.toml：

[depot]
allowAddingWhenNotEmpty = false
maxAmountPerItem = 9223372036854775807
maxDistinctItemTypes = 2147483647

• allowAddingWhenNotEmpty：允许在中转站已有物品时进行额外存放。
• maxAmountPerItem：单个完整物品原型可存储的最大数量。
• maxDistinctItemTypes：一次最多可存储的不同物品原型数量。

当前限制

• 仅支持物品。
• 流体、化学物质、能量和其他非物品资源无法转移。
• 存储系统的支持因 Minecraft 版本和加载器而异。
• JEI 的避让功能取决于 JEI 是否会为当前界面和布局注册额外的 GUI 区域。

AI 开发声明

超级拖放的全部源代码均由 AI 编写。

项目方向、功能需求、实际操作测试、兼容性决策和发布管理由 dzt000 提供。

许可证

超级拖放以 MIT 许可证 发布。