How to Install Distant Horizons Mod in Minecraft 1.21.5
Distant Horizons is one of the most visually transformative mods available for Minecraft — it extends your visible render distance far beyond what vanilla settings allow by generating simplified Level of Detail (LOD) geometry for chunks outside your normal view. Instead of fog cutting off at 12–16 chunks, you can see mountains, forests, and terrain features hundreds of chunks away. Installing it on 1.21.5 requires a few specific steps, and the right setup depends heavily on your hardware and existing mod loader configuration.
What Distant Horizons Actually Does
In standard Minecraft, the game fully loads and renders every visible chunk — meaning higher render distances demand significantly more RAM and GPU power. Distant Horizons works differently. It builds a lower-polygon representation of distant terrain and renders that instead of full chunk geometry. This lets you achieve the visual impression of a 64–128 chunk view distance without the same performance penalty as rendering everything at full detail.
The tradeoff: distant terrain won't show individual blocks, moving entities, or animated details at range. It's a visual LOD system, not a true chunk loader.
What You Need Before Installing
Before downloading anything, confirm a few things about your setup:
- Minecraft version: You need a Minecraft installation running exactly 1.21.5. Mods are version-specific, and a build for 1.21.4 or 1.21 won't load correctly.
- Mod loader: Distant Horizons requires either Fabric or NeoForge. It does not support vanilla Minecraft or the legacy Forge loader on modern versions. Check which loader you're running — they are not interchangeable.
- Java version: Minecraft 1.21.5 requires Java 21. If you're launching through the official launcher, Java is bundled. If using a third-party launcher, verify manually.
- RAM allocation: A minimum of 4GB allocated to Minecraft is generally recommended. For serious LOD rendering at long distances, 6–8GB is more realistic.
Step-by-Step Installation for Fabric (1.21.5)
1. Install Fabric Loader Download the Fabric installer from the official Fabric website. Run it, select Minecraft version 1.21.5, and install. This creates a new profile in your launcher.
2. Add the Fabric API Distant Horizons depends on the Fabric API as a library. Download the version matching 1.21.5 from Modrinth or CurseForge and place the .jar file in your .minecraft/mods folder.
3. Download Distant Horizons Get the Distant Horizons .jar for Fabric 1.21.5 from the official Modrinth page or the project's GitLab releases. Always verify you're downloading from the official source — third-party mirrors are a common vector for modified files. Place the .jar in the same mods folder.
4. Optional but common: install a shader-compatible renderer Distant Horizons works best visually when paired with Sodium (a performance-focused rendering engine for Fabric). If you plan to use shaders, you'll also want Iris — but note that shader compatibility with Distant Horizons depends on the specific shader pack and the mod version. Not all shaders support LOD rendering.
5. Launch using the Fabric profile Open your launcher, select the Fabric 1.21.5 profile, and start the game. If the mod loaded correctly, you'll find a Distant Horizons settings menu within the in-game options screen.
Step-by-Step Installation for NeoForge (1.21.5)
1. Install NeoForge Download the NeoForge installer for 1.21.5 from the official NeoForge site. Run the installer — it will create a new launcher profile automatically.
2. Download the NeoForge build of Distant Horizons The mod has separate builds for Fabric and NeoForge. Make sure you download the correct .jar variant for your loader. Place it in your .minecraft/mods folder.
3. Check for dependency mods NeoForge builds may require additional libraries depending on the release. Check the mod's description page for listed dependencies before launching.
4. Launch and verify Select the NeoForge 1.21.5 profile and launch. Confirm the mod appears in the in-game mod list if your loader provides one.
Key Settings to Configure After Installation 🎮
Once installed, Distant Horizons adds its own configuration panel. A few settings significantly affect performance and appearance:
| Setting | What It Does | Impact |
|---|---|---|
| LOD Render Distance | How far simplified terrain renders | Higher = more GPU/CPU load |
| LOD Quality | Detail level of distant geometry | Higher = more VRAM usage |
| Generation Mode | Whether LOD data generates in background | Affects CPU usage over time |
| Fade Length | Transition zone between full and LOD chunks | Visual smoothness |
Start conservatively — lower LOD quality at moderate distances — and increase gradually while monitoring frame rate.
What Affects Your Experience Most
No two installations perform identically. The variables that matter most:
- GPU VRAM: LOD geometry at long distances consumes significant video memory. Cards with less than 6GB VRAM may need to cap LOD distance.
- CPU speed: Background LOD generation is CPU-intensive. Slower processors will take longer to populate distant terrain.
- Whether you're using shaders: Shader compatibility adds another layer of variables. Some shader packs integrate Distant Horizons support explicitly; others do not.
- World age and pre-explored chunks: LOD data generates from already-explored chunks faster than generating for new terrain.
- Other mods in your stack: Conflicts with rendering mods, chunk loaders, or dimension mods can produce visual artifacts or crashes. Test with a minimal mod list first.
A Note on Version Timing ⚠️
Mod development follows Minecraft releases with some delay. If 1.21.5 is a recent release, check whether the Distant Horizons team has published a stable build for that version versus a beta or development snapshot. Running a development build is functional for many users but may introduce instability. The mod's changelog and issue tracker give the clearest picture of the current build's reliability on any given version.
The gap between a working installation and a great experience comes down to your specific hardware, your mod list, and how aggressively you push the LOD settings — which only your own setup can answer. 🖥️