Launcher M5a: mods, resource packs and shaders - #482

Milestone 5a of Lodestone Launcher: the Mods tab becomes Content, with Mods, Resource packs and Shaders, managed the way the dashboard manages server mods.

What's in it

• Content model:
  • Lists mods, resource packs and shader packs, as zips or folders, with their metadata and icons.
  • Provenance is kept in <instance>/content.json. Unknown files are matched to Modrinth by SHA-1 in one batched call.
  • Delete moves files to the Trash.
  • .mrpack export now lists Modrinth files by CDN URL instead of copying them into overrides.
• Browse and install from Modrinth:
  • Search, sort and paging, with default filters for the instance's version and loader. Mods are client-compatible only.
  • Pasting a Modrinth link opens the project.
  • Version choice and required dependencies (up to 3 levels) follow the dashboard's rules.
  • Downloads come only from cdn.modrinth.com and are checked by SHA-1, size and SHA-512 before an atomic rename.
  • Updates and "Update all".
• Enable, disable and order:
  • Mods use the .disabled suffix.
  • Resource packs are enabled, disabled and ordered in options.txt. Every other line is kept, and each pack gets a compatibility badge from pack_format.
  • Shaders are a radio list plus "Shaders off", written to Iris's config/iris.properties, Oculus's config/oculus.properties or OptiFine's optionsshaders.txt. Unknown keys are kept.
• Shader mod:
  • The Shaders section detects Iris, Oculus or OptiFine.
  • If none is installed, it offers the right one for the loader and version: Iris + Sodium on Fabric/Quilt, Iris or Oculus on NeoForge, Oculus + Embeddium on Forge. Availability is checked live on Modrinth.
  • Vanilla instances get "Switch to Fabric".
  • OptiFine is never downloaded.
• Locked while running: every change is locked while the instance is running, because the game rewrites options.txt and the shader configs when it exits.
• Loader change in Settings: if enabled mods won't load on the new loader, Save lists them first. It offers "Turn them off and save" (reversible), "Save and keep them" or "Cancel", and warns about modded blocks in worlds.

Verification (local macOS arm64)

• cargo fmt --check, cargo clippy --workspace --all-targets -D warnings and cargo test --workspace pass: 298 tests. crates/lodestone-minecraft passes 48. All offline against a loopback Modrinth mock.
• No new crates. The only lock change is one zip dependency edge (zip 0.6.6 was already locked). image's webp and gif features were already in the lock.
• Live, against real Modrinth and a real game, on a Fabric 0.20.1 / 1.20.1 instance:
  • the Shaders offer installed Iris 1.7.6 and Sodium 0.5.12 as one plan;
  • Complementary Reimagined r5.9.3 installed and was selected, and iris.properties was written;
  • on launch, Iris logged Using shaderpack: ComplementaryReimagined_r5.9.3.zip and the game reached the menu;
  • content.json recorded the Modrinth project, version and hashes for each file.
• UI: checked through offscreen renders of every new scene (content-mods, browse, project, resource packs, shaders, missing shader mod, vanilla, loader-change dialog).

Not yet: Markdown project bodies (there's a "View on Modrinth" link instead), .mrpack import, world backup and screenshots (M5b).

🤖 Generated with Claude Code