ZQ_pumpkin's Far View ai Patch

Overview

A client-side companion for FarView on Minecraft 1.20.1 (Forge).

It improves how FarView’s distant LOD terrain behaves with Iris / Oculus shader packs—especially water and the transition between normal chunks and LOD—without replacing FarView itself.

Requires FarView. Iris/Oculus optional but recommended if you use shaders.

Features

Iris / Oculus water

• Keeps water out of the opaque LOD mesh and draws a separate water surface in the translucent pass so shader packs can shade it properly.
• Seabed stays under the water layer instead of looking like a flat, fully lit “ground top.”

Underwater look

• FarView’s shader path often lights LOD top faces at full brightness (no sky occlusion under water).
• This mod bakes simple depth-based darkening into seabed colour and vertex brightness so underwater LOD reads closer to near terrain (still an approximation—FarView does not carry full lightmaps).

LOD transition gaps

• Reduces empty “holes” when you leave loaded chunks and FarView LOD should take over.
• Holds nearby region meshes a bit longer and prioritises rebuilding empty regions at the render-distance edge.

Safer startup with shaders

• Avoids poking Iris during early title-screen / pipeline setup.
• Avoids Mixin @ModifyArgs patterns that could break resource-pack reload on some setups.

Requirements

Client-side only. Not needed on a dedicated server unless the server also runs the client-style FarView setup (unusual).

Installation

1. Install Forge 1.20.1 and FarView.
2. Drop this mod into the mods folder.
3. (Optional) Install Iris/Oculus and your shader pack.
4. Launch the game.

Notes / limitations

• Does not replace FarView’s mesher or config; it only patches behaviour around water, lighting approximation, and LOD mesh lifetime.
• Underwater brightness is an approximation (vertex colour / brightness), not true per-block lightmaps.
• If a FarView update renames internal classes/methods, some mixins may need a matching update of this mod.
• PaperDoll (optional): also includes small client fixes so the corner doll hides the ridden vehicle and keeps body scale normalized (including Pehkui) while the doll is drawing—only applies if PaperDoll is installed.

Credits

• Far View — distant LOD terrain (version: until 0.1.7 )
• Oculus (optional) — shader support （version : any）

Short one-liner (summary field):
Client-side FarView fixes for Iris water, underwater LOD brightness, and empty gaps when chunks turn into LOD.