ZQ_pumpkin的远景AI补丁

ZQ_pumpkin的远景AI补丁

Minecraft 1.20.1 (Forge) 上 FarView 的客户端配套程序。

Bug修复

概述

为 Minecraft 1.20.1 (Forge) 上的 FarView 提供客户端配套支持。

它在不替换 FarView 本身的前提下,改善 FarView 远景 LOD 地形与 Iris / Oculus 光影包的兼容表现——尤其是水面以及普通区块与 LOD 之间的过渡。

需要 FarView。Iris/Oculus 为可选,但若使用光影则推荐安装。


特性

Iris / Oculus 水面

  • 将水从 opaque LOD 网格中移出,并在半透明 pass 中单独绘制水面,以便光影包能够正确着色。
  • 海床保持在永层之下,而不是看起来像一块平整、全亮的“地面顶部”。

水下观感

  • FarView 的 shader 路径通常会将 LOD 顶面按全亮度照亮(水下无天空遮蔽)。
  • 本模组将简单的基于深度的变暗烘焙进海床颜色与顶点亮度中,使水下的 LOD 观感更接近近处地形(仍为近似处理——FarView 不携带完整光照贴图)。

LOD 过渡空隙

  • 减少离开已加载区块、FarView LOD 应接手时出现的空白“空洞”。
  • 将附近区域网格保留更长时间,并优先重建渲染距离边缘处的空区域。

使用光影时更安全的启动

  • 避免在标题界面早期 / 管线初始化阶段触碰(poking)Iris。
  • 避免使用 Mixin @ModifyArgs 模式,该模式在某些环境中可能破坏资源包重载。

需求

Minecraft 1.20.1
加载器 Forge
必需 FarView
可选 Iris 或 Oculus(以及一个光影包)

仅客户端。除非服务器也运行客户端式 FarView 配置(不常见),否则不需要安装在专用服务器上。


安装

  1. 安装 Forge 1.20.1 与 FarView。
  2. 将此模组放入 mods 文件夹。
  3. (可选)安装 Iris/Oculus 以及你的光影包。
  4. 启动游戏。

说明 / 限制

  • 不会替换 FarView 的网格生成器或配置;只针对水面、光照近似以及 LOD 网格生命周期相关的行为进行修补。
  • 水下亮度为近似处理(顶点颜色 / 亮度),而非真正的逐方块光照贴图。
  • 如果 FarView 更新重命名了内部类/方法,部分 mixin 可能需要本模组进行对应的更新。
  • PaperDoll(可选): 还包含小型客户端修复,使角落人偶在绘制时隐藏所骑乘的载具并保持身体缩放归一化(包括 Pehkui)——仅在安装了 PaperDoll 时生效。

致谢

  • Far View —— 远景 LOD 地形(版本:至 0.1.7)
  • Oculus(可选) —— 光影支持(版本:任意)

简短一句话(摘要字段): 针对 Iris 水面、水下 LOD 亮度以及区块转为 LOD 时出现空隙的客户端 FarView 修复。