Distant Horizons API

Don't Download Unless You Are A Developer. This is automatically included in the DH mod jar.

1.2M Downloads

fabricforgeneoforgelibrary

Rent Server with this Mod

About this Mod

Don't Download Unless You Are A Developer

Putting this in your Mods folder will do nothing.

Developer Description

This jar includes the source code and classes needed to interact with Distant Horizons in a Minecraft and mod loader independent way.
This jar should be used during development instead of the full Distant Horizons jar to prevent accidentally using unsafe internal methods.

The example projects on GitLab contains all the basics you need to get started using the API.

https://gitlab.com/distant-horizons-team/distant-horizons-api-example

Additional resources

API JavaDocs

https://distant-horizons-team.gitlab.io/distant-horizons/

Developer Wiki

https://gitlab.com/distant-horizons-team/distant-horizons/-/wikis/home

Discord

In case you have any questions or issues not addressed in the above two documents.

https://discord.gg/xAB8G4cENx

Issues

If you find any bugs or want to request a new feature, for the API, please use the main Distant Horizons GitLab issue page.

https://gitlab.com/distant-horizons-team/distant-horizons/-/issues

Available Versions

7.0.0release

MC 1.12.2, 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2fabric, forge, neoforge

June 17, 2026

6.1.0release

MC 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2fabric, forge, neoforge

April 24, 2026

6.0.0release

MC 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2fabric, forge, neoforge

April 18, 2026

5.1.0release

MC 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11fabric, forge, neoforge

December 24, 2025

5.0.0release

MC 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.10, 1.21.11fabric, forge, neoforge

December 13, 2025

How to Install Distant Horizons API on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).

Install Mod

Open the mod browser in the dashboard and search for "Distant Horizons API". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforgeneoforge

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+22 more)

Server-side

~ Optional

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Distant Horizons API server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.

Is Distant Horizons API compatible with fabric and forge and neoforge?

Distant Horizons API officially supports fabric, forge, neoforge for Minecraft 26.2, 26.1.2, 26.1.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Distant Horizons API – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Distant Horizons API consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.