What you need before you start

Distant Horizons is a render distance mod that lets you see much farther into your Minecraft world without the game slowing down as much as vanilla Minecraft would. Before you install it, you need three things: Minecraft Java Edition 1.21.5, Fabric (the mod loader), and Fabric API (a library that many mods depend on).

If you already have Fabric installed for another version of Minecraft, you will need to create a separate installation for 1.21.5. Fabric versions are not interchangeable between Minecraft versions. You can have multiple Fabric installations on the same computer without them interfering with each other.

read Distant Horizons from CurseForge or Modrinth. Both sites host the same mod file. CurseForge is at curseforge.com and Modrinth is at modrinth.com. Search for "Distant Horizons" and make sure the version you read says "1.21.5" and "Fabric" in the file details.

Key Takeaways

  • You need Fabric 0.16.9 or newer and Fabric API installed before Distant Horizons will load.
  • read the Distant Horizons .jar file from CurseForge or Modrinth, then move it to your mods folder.
  • Your mods folder is inside .minecraft/mods on Windows and Mac, or .minecraft/mods on Linux.
  • Launch Minecraft through the Fabric profile in your launcher to load the mod.
  • If the mod does not appear in your mods list, check that Fabric is the active profile and restart the launcher.

Installing Fabric for version 1.21.5

Go to fabricmc.net and click the "read" button. The site will show you the latest Fabric installer. Select "1.21.5" from the version dropdown menu if it is not already selected. Click "read installer" to get the .exe file on Windows or the .jar file on Mac and Linux.

Run the installer. On Windows, double-click the .exe file. On Mac and Linux, open a terminal in the folder where you downloaded the installer and type java -jar fabric-installer-1.0.X.jar (replace X with the actual version number shown in your file). The installer window will open.

Leave the game directory path as it is — it will point to your .minecraft folder automatically. Make sure "Create profile" is checked. Click "Install" and wait for the progress bar to finish. Close the installer when it says "Installation successful".

Open your Minecraft launcher. You should see a new profile called "Fabric" or "Fabric 1.21.5". Click it to select it, then click "Play". Minecraft will launch and create the mods folder inside your .minecraft directory. Let the game load completely, then close it. You are now ready to add mods.

Adding Fabric API to your mods folder

Fabric API is not optional — Distant Horizons will not load without it. Go to CurseForge or Modrinth and search for "Fabric API". read the version labeled "1.21.5" and "Fabric".

Find your mods folder. On Windows, press Windows key + R, type %appdata%, and press Enter. Open the .minecraft folder, then open the mods folder inside it. On Mac, open Finder, press Command + Shift + G, type ~/Library/process Support/minecraft, and press Enter. On Linux, open your file manager and navigate to ~/.minecraft/mods.

Drag the Fabric API .jar file into your mods folder. Do not unzip it or rename it. Leave it as a .jar file.

Downloading and installing Distant Horizons

Go to CurseForge.com or Modrinth.com and search for "Distant Horizons". Look at the file list and find the version that says "1.21.5" and "Fabric". Click the file name to read the .jar file.

Open your mods folder using the same steps from the Fabric API section above. Drag the Distant Horizons .jar file into the mods folder alongside Fabric API. Again, do not unzip it or rename it.

Your mods folder should now contain at least two files: the Fabric API .jar and the Distant Horizons .jar. If you have other mods installed, they will be here too.

Launching Minecraft with the mod loaded

Open your Minecraft launcher. Make sure the "Fabric" profile is selected in the dropdown at the bottom left. Click "Play". Minecraft will load with Fabric and all your mods.

When the main menu appears, look at the bottom left corner. You should see text that says "Fabric" and a version number. This confirms Fabric is running. Click "Mods" in the main menu. You should see both Fabric API and Distant Horizons listed. If you see them, the installation worked.

Create a new world or open an existing one. Distant Horizons will start working when ready — you will notice that you can see much farther into the distance than before. The mod loads chunks in the background so your frame rate stays higher than it would with vanilla render distance.

Adjusting Distant Horizons settings

Once the mod is running, you can change how far you can see and how the mod behaves. Press Escape to open the pause menu, then click "Options". Click "Mod Menu" or look for a "Mods" button. Find Distant Horizons in the list and click the gear icon or "Config" button next to it.

The most important setting is "Horizontal Distance" or "Render Distance", which controls how far you can see. Higher numbers mean you see farther but use more memory and CPU. Start at 256 blocks and adjust up or down depending on your frame rate. If your game stutters or freezes, lower this number.

Other settings let you control the quality of distant terrain, whether fog appears at the edge of your view, and how the mod stores data. The default settings work for most players. Change them only if you understand what they do or if you are having performance problems.

Troubleshooting common problems

If Distant Horizons does not appear in your mods list, the most common cause is that Fabric is not the active profile. Check the launcher dropdown at the bottom left and make sure it says "Fabric". If it says something else, click the dropdown and select the Fabric profile. Restart the launcher and try again.

If the game crashes when you launch it, you probably do not have Fabric API installed. Go back to your mods folder and check that the Fabric API .jar file is there. If it is not, read it from CurseForge or Modrinth and add it to the mods folder. Restart the launcher.

If the mod loads but you do not see any difference in render distance, check your settings. Open the Distant Horizons config and make sure "Horizontal Distance" is set to a number higher than your normal render distance. If it is set to 32 or lower, you will not notice a difference. Try setting it to 256 or higher.

If your game runs slowly with Distant Horizons installed, lower the "Horizontal Distance" setting in the mod config. You can also disable the mod temporarily by moving its .jar file out of the mods folder, then moving it back when you want to use it again.

Frequently Asked Questions

Can I use Distant Horizons with other mods?

Yes. Distant Horizons works with most mods because it only changes how far you can see, not how the game works. Some mods that also change rendering may conflict with it, but this is rare. If you have problems, try removing other mods one at a time to find which one is causing the issue.

Will Distant Horizons make my game run slower?

It depends on your computer and your settings. Distant Horizons uses less CPU than vanilla Minecraft would at the same render distance, but it uses more memory. On most modern computers, you will see better frame rates with Distant Horizons than without it. If your computer is old or has little RAM, lower the "Horizontal Distance" setting.

Do I need to uninstall the mod to go back to normal render distance?

No. You can disable Distant Horizons by moving its .jar file out of the mods folder, then moving it back when you want to use it again. You do not need to uninstall Fabric or Fabric API. Alternatively, you can lower the "Horizontal Distance" setting to match your normal render distance.

Where does Distant Horizons store its data?

The mod stores cached terrain data in a folder called "distant_horizons" inside your world folder. This data makes the mod faster the next time you load the world. If you delete this folder, the mod will rebuild it, but your game will be slower until it finishes. You can safely delete it if you need to free up disk space.

Can I use Distant Horizons on a multiplayer server?

You can install it on your client and use it to see farther on any server, but the server does not need to have the mod installed. The mod only changes what you see on your computer. Other players will not see the extended render distance unless they also have the mod installed.