CaveFlow

CaveFlow

一款客户端 Fabric 模组。地下每格空气都有气流方向。CaveFlow 通过从露天洞口进行 BFS 洪水填充算法计算风向，并生成随结果飘移的尘埃粒子。

功能

• 气流模拟 — 从每个露天洞口播种 BFS，通过洞穴网络传播气流向量，在后台线程运行，不会导致帧时间飙升。
• 尘埃粒子 — 从地下空气方块生成，沿计算出的向量移动。具有生物群系感知：普通洞穴、繁茂洞穴和幽匿/深暗之域各有不同的粒子变体。
• 探索与未探索密度 — 玩家附近区域的密度倍率较低。回到已知洞穴感觉更安静；未探索的洞穴更有生机。
• 沉积尘埃 — 在气流停滞的死角区域，粒子减速并沉降。
• 深度与 Y 层缩放 — 越深的地下气流越强。
• 磁盘缓存 — 每个世界/服务器的计算气流会被保存，重新连接时加载，避免每次会话重新计算。
• 调试覆盖层 — 使用 /caveflow debug 或配置开关在游戏中显示 3D 流线箭头。

使用方法

只需加载世界。无需指令 — 区块加载时即开始气流计算，粒子会自动在地下出现。

• /caveflow debug — 切换 3D 流线箭头覆盖层。
• ModMenu → CaveFlow → ⚙ 进入配置界面。

配置

配置界面共四个选项卡：

• 常规 — 主开关。
• 气流 — 粒子密度、流速、检测范围、已探索/未探索倍率、深度与 Y 层缩放。
• 效果 — 视觉变体。部分选项尚未实现（热浪扭曲、冷气粒子、穿堂风、隧道气流）— 菜单中已有但暂无功能。
• 进阶 — 后台线程数、每 tick BFS 预算、队列大小、洞穴最小/最大深度、FPS 节流与暂停阈值、磁盘缓存路径、缓存淘汰间隔、快速移动阈值、调试覆盖层半径与步长。

需求

Minecraft	加载器	Fabric API	YACL
1.21.11	Fabric 0.19.2+	任意 1.21.x 版本	3.8.2+

可选： ModMenu — 添加配置界面按钮。

仅客户端模组。无需安装在服务器上。

备注

• 性能默认值已针对中端 CPU 调整（约 0.5 ms/tick BFS）。如有需要，可在配置中降低BFS 预算和后台线程数。
• 快速移动阈值会在达到设定速度时暂停远处 BFS 工作 — 使用鞘翅时很有用，避免为快速掠过的地形进行不必要的计算。
• 自动 FPS 保护 — 帧率下降时 BFS 工作自动节流。低于节流阈值（默认 60 FPS）时预算线性缩减；低于暂停阈值（默认 30 FPS）时 BFS 完全暂停并显示聊天消息。两个阈值均可配置。游戏窗口失去焦点时 BFS 静默暂停 — 不会发送消息。