低语暗流

Whispering Currents 是一个适用于 NeoForge 1.21.1 的物流自动化模组。它添加了一个方块——连接附件——作为一个自主物流节点。放置一个，将箱子和熔炉放在范围内，它就会处理其余的事情：为熔炉供料、取出产物，并保持一切运转。

---

运作方式

连接附件方块

连接附件是一个完整方块，它会扫描可配置半径（默认 8 格，可通过连接针在 4–16 格间调整）内的所有容器。它能检测熔炉、箱子、木桶以及任何其他实现了 Container 接口的方块实体。

节点以 20 刻（1 秒）的扫描周期运行。每个周期它按轮询顺序处理一个熔炉（参见下方的熔炉输入/输出）。

熔炉输入/输出

每个扫描周期，连接附件会选择列表中的下一个熔炉，并执行两项检查：

1. 燃料 — 如果燃料槽中的物品少于 2 个，它会从附近的箱子中抽取煤炭、木炭或任何可燃烧物品（最多抽取 2 个，这样燃料就会在各个熔炉之间分配，而不会将一个箱子填满到 64 个）。
2. 输入 — 如果输入槽为空，它会从附近的箱子中抽取任何可熔炼物品。食物和矿石一视同仁——找到的第一个可熔炼物品就会被放入。

输出 — 在每个扫描周期，都会检查每个熔炉的产物槽（槽位 2）。如果有熔炼完成的物品在等待，并且该熔炉没有正在进行的输出飞行，该物品就会被送往最近的有空间的箱子，优先选择带有匹配标志标签的箱子。

燃料系统

连接附件有一个内部燃料缓冲。它会消耗附近箱子中的煤炭/木炭（每个煤炭提供 80 点燃料，最大缓冲为 3200 点）。如果缓冲耗尽，节点会记录一条警告并跳过熔炉处理。连接针在右键点击时会显示燃料百分比。

物品飞行

当物品需要从一个容器移动到另一个容器时，模组会生成一个飞行物品——一个服务端数据结构（无实体，无卡顿），每刻推进一次位置，并每 3 刻向客户端同步一次。

飞行模式（可在 whisperingcurrents-server.toml 中配置）：

模式	行为
PATHFINDING（默认）	物品上升到天花板高度，通过 A* 寻路避开墙壁横飞，然后降落到目标处。当天花板直线路径畅通时，使用视线快速路径。客户端使用弹簧平滑插值和利萨如漂移动画渲染。粒子每秒 1 个。
DIRECT_LINEAR	物品从源中心沿直线飞向目标中心。无避障。
MAGNET	与 DIRECT_LINEAR 相同的直线路径（加速度模型已准备好，供未来调优）。
TELEPORT	物品从源处消失，并在短暂延迟后出现在目标处。无可见实体或客户端同步。将 itemMaxAge 设置得较低（例如 10）以实现近乎即时的传输。

连接针法杖

连接针是一个信息/配置工具（不用于连接）：

• 右键点击连接附件 — 显示统计信息：当前范围、已连接的容器数量、燃料百分比和熔炉索引。
• Shift+右键点击连接附件 — 在 4 到 16 格之间循环调整范围。

配方：石质压力板上的红石粉。

# Whispering Currents — 范围与路线图

## 当前版本 (v1.1.0.14)

• 连接附件：自主物流节点
• 熔炉输入/输出：燃料、输入、输出
• 物品飞行：4 种可配置模式（PATHFINDING、DIRECT_LINEAR、MAGNET、TELEPORT）
• 连接针：信息/配置法杖
• 已知问题：标志检测失效，箱子分类功能不正常

## 第一阶段 — 核心修复 (v1.2.0)

• 修复标志检测（检查所有 6 个方块面）
• 新的标志标签：燃料、原料、锭、宝石、输出、食物、木材、石头、金属、杂项
• 输出箱 = 总收纳处 + 熔炉输出目标
• 原料箱 = 仅作为熔炉输入来源
• 燃料箱 = 仅作为熔炉燃料来源
• 按熔炉类型设定优先级（烟熏炉 → 食物，高炉 → 矿石，熔炉 → 其余）
• 箱子分类：从输出箱取出，路由到匹配的分类箱子

## 第二阶段 — 地面拾取 (v2.0.0)

• 连接附件收集范围内的掉落物实体（ItemEntity）
• 发送到输出箱进行分类
• 每刻处理一个物品

## 第三阶段 — 红石控制面板 (v2.1.0)

• 新方块：读取附近的告示牌和拉杆
• 告示牌文本 = 设置，拉杆 = 开关
• 设置项：分类、地面拾取、自动喂食、防御
• 无 GUI — 完全依赖原版物理交互

## 第四阶段 — 玩家飞行区域 (v2.2.0)

• 金粒燃料（与煤炭分开）
• 在连接范围内可创造模式飞行
• 空中无法与方块交互
• 金色闪光粒子

## 第五阶段 — 自动喂食 (v2.3.0)

• 当饥饿值低于阈值时，从食物箱中喂食玩家
• 使用相同的飞行动画，到达时自动食用
• 通过控制面板切换

## 第六阶段 — 基地防御 (v2.4.0)

• 检测范围内的敌对生物
• 从箱子中发射武器（消耗耐久）
• 激活时煤炭消耗增加
• 通过控制面板切换

## 未来构想（未计划）

• 营火/晾干架集成
• 跨维度连接
• 连接附件升级（范围、速度、容量）
• 按类别自定义飞行视觉效果