Files
horizon-airdef/docs/mod-browser.md
T
Ludovic Marie 784e8f0648 Mod browser (1/3): Modrinth and CurseForge sources, checksum-checked downloads
The launcher's core gains `browser`: search Modrinth for what Horizon loads
(resource packs, Iris/OptiFine shader packs, modpacks; never Java mod jars),
say how well each result runs, pick the newest version that runs, and
download a file only from Modrinth's or CurseForge's file servers, with a
plain file name, kept only when its size and SHA-512 (SHA-1 on CurseForge)
match. CurseForge is a pluggable source that stays off until an API key
exists (HORIZON_CURSEFORGE_API_KEY at run time or build time; the launcher
workflow passes the repository secret). docs/mod-browser.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 03:17:25 +02:00

3.4 KiB

The launcher's mod browser

Search Modrinth (and CurseForge, once the launcher has a key) for packs Horizon loads, see how well each one runs, and install it with its checksum checked. This is item 16 of the roadmap and issue #577. The code is in launcher/src/browser.rs and launcher/src/browser/.

What it offers

Only what Horizon actually loads is offered. Java mod jars (Fabric, NeoForge, Forge) don't run in Horizon (mods.md, research/java-mod-compat.md), so they are never searched. Horizon .hmod mods aren't on Modrinth or CurseForge yet (Modrinth has no horizon loader).

Kind Goes to How well it runs
Resource packs resourcepacks/ beside options.txt Works when made for 26.3 (resource-packs.md lists what Horizon reads). Older packs are Partly: they load with vanilla's compatibility warning
Shader packs (Iris, OptiFine) shaderpacks/ Partly: translated to WGSL, the full-screen passes draw and the world and shadow passes don't yet (shader-packs.md). Packs for other loaders (Canvas, core-shader packs) don't run and can't be installed
Modpacks (.mrpack, CurseForge zip) the Modpacks page's import Partly: Horizon runs the mods it can port, from the player's own downloads (modpacks.md)

By default a search shows only what runs: resource packs made for 26.3, shader packs for Iris or OptiFine, and every modpack. Show everything lists the rest of the kind too, each marked with how well it runs; what doesn't run is never offered for install.

Checks on every download

  • The file must come from Modrinth's or CurseForge's file servers (cdn.modrinth.com, edge.forgecdn.net, mediafilez.forgecdn.net), over HTTPS.
  • Its name must be one plain file name (no folders, .., hidden names or reserved characters).
  • It is written as .<name>.part, hashed as it arrives, and renamed into place only when its size and checksum match what the source lists: SHA-512 on Modrinth, SHA-1 on CurseForge (the strongest hash CurseForge publishes). Anything else removes the part file and installs nothing.
  • A file whose source lists no checksum is refused.

Sources

Modrinth. The public API (api.modrinth.com/v2) needs no key. The launcher names itself in its user agent, as Modrinth asks.

CurseForge

CurseForge's API (api.curseforge.com/v1) needs an API key from its developer console. Ludovic approved CurseForge for the browser on 2026-10-21; the key is his (agents never sign up for him). Until a key exists the CurseForge source is off and the browser searches Modrinth only.

To turn it on:

  1. Ludovic gets a key at https://console.curseforge.com/ (sign in, API keys). CurseForge's terms for a launcher that ships the key apply: the key is built into the binary, so anyone with the binary can read it.
  2. He stores it in the 1Password Agents vault as an item CurseForge API, field credential.
  3. It goes into the repository secret HORIZON_CURSEFORGE_API_KEY (~/fleet/op read "op://Agents/CurseForge API/credential" | gh secret set HORIZON_CURSEFORGE_API_KEY). The launcher workflow passes it to the build, which builds it in (option_env!).

At run time HORIZON_CURSEFORGE_API_KEY in the environment overrides the built-in key; empty means none. A file whose author allows downloads from CurseForge's own site only (no downloadUrl in the API) is shown but can't be installed.