Distant Horizons & Iris: A Compatibility Guide

Distant Horizons (DH) is a mod that significantly extends render distances in Minecraft by utilizing Level of Detail (LODs). This guide provides information on achieving compatibility between Distant Horizons and Iris shaders, covering setup, optimization, and troubleshooting.

Note: Distant Horizons compatibility with Iris is currently in early testing, so it may be unstable and require some modding knowledge to use. Early betas may cause damage to your worlds and/or computer.

Key Considerations

• RAM Allocation:
  • 6GB (Recommended): This is the optimal amount of RAM for running Distant Horizons smoothly.
  • 10GB (Careful): Allocating this much RAM can sometimes negatively impact the Java Garbage Collector.
• Shader Compatibility: Not every shader is compatible with Distant Horizons. However, most shaders are likely to support it.
• LODs Explained: LODs are pregenerated chunks at a lower quality, allowing for far greater render distances without significant performance impact.

Server Usage

As of Distant Horizons 2.3, you can now use DH on servers. For fast terrain generation, increase the CPU load and AFK, then reduce it to minimal or low impact to play the game.

Performance Optimization

While DH has become more efficient and less RAM-intensive, using more than 320 chunks is not recommended.

Troubleshooting Common Issues

• Batching World Generator Timed Out Errors: These errors are normal and can be ignored. If they are bothersome, hide the chat.
• Visual Doppler Effect: This effect can occur when switching off the DH renderer while shaders are enabled.

Incompatible Mods

The following mods are known to have compatibility issues with Distant Horizons:

Read also: 1151 to 1200 Cooler Adapters

• Shoulder Surfing Reloaded (Breaks with Bliss, removing it doesn't help you need to make a whole new instance. Note: I haven't tried it in a while, it may or may not be fixed.
• Tectonic.
• Terraforged.
• Pregenerate a world in an older version of the game, don't use TF 1.18.2, has a fatal memory leak bug.
• Lithosphere.
• William Wyther's Expanded Ecosphere.
• HUGE overhaul to make THE MOST BEAUTIFUL TERRAIN in Minecraft.
• Big Globe.
• Another MASSIVE overhaul to the game, but also having some smaller, finer details.
• JJThunder To The Max.
• If you like big mountains, you will love this.

Shader Development Information

The following information is useful for shader developers looking to optimize their shaders for Distant Horizons:

• Programs:
  • dh_terrain: Used for terrain.
  • dh_water: Used for water.
  • dh_shadow: Used for the shadow pass (automatically enabled).
• Uniforms:
  • dhDepthTex0 and dhDepthTex1
  • Specifies the near plane of DH’s projection.
  • Specifies the far plane of DH’s projection.
  • Projection matrix for the non-shadow pass of Distant Horizons.

Block Definitions for Shaders

Here is a list of block definitions that can be used in shaders to optimize rendering with Distant Horizons:

• DH_BLOCK_UNKNOWN // Any block not in this list that does not emit light
• DH_BLOCK_LEAVES // All types of leaves, bamboo, or cactus
• DH_BLOCK_STONE // Stone or ore
• DH_BLOCK_WOOD // Any wooden item
• DH_BLOCK_METAL // Any block that emits a metal or copper sound.
• DH_BLOCK_DIRT // Dirt, podzol, and coarse dirt.
• DH_BLOCK_GRASS // Grass.
• DH_BLOCK_LAVA // Lava.
• DH_BLOCK_DEEPSLATE // Deepslate, and all it's forms.
• DH_BLOCK_SNOW // Snow.
• DH_BLOCK_SAND // Sand and red sand.
• DH_BLOCK_TERRACOTTA // Terracotta.
• DH_BLOCK_NETHER_STONE // Blocks that have the "base_stone_nether" tag.
• DH_BLOCK_WATER // Water...
• DH_BLOCK_AIR // Air. This should never be accessible/used.
• DH_BLOCK_ILLUMINATED // Any block not in this list that emits light

Troubleshooting Checklist

Before seeking further assistance, ensure the following:

• You have the correct Iris version.
• You have the correct DH version.

By following this guide, you should be able to achieve a balance between visual quality and performance when using Distant Horizons with Iris shaders in Minecraft.

Read also: Sagittarius Relationships

Read also: Understanding April Zodiac Compatibility

tags: #distant #horizons #iris #compatibility