Skip to content

v0.3.0

Choose a tag to compare

@3nderXP 3nderXP released this 11 Jul 12:58
· 18 commits to main since this release
7bab5d8

Elo can now search, install, inspect, adopt, and remove Minecraft addons while
keeping launcher-compatible instance folders.

Highlights

  • Public Modrinth integration with no account or API token required.
  • Addon search filtered by an instance's Minecraft version and loader.
  • Installation support for mods, resource packs, and shaders.
  • Recursive installation planning for required dependencies.
  • --dry-run previews downloads, verified reuse, existing addons, and
    collisions without changing files.
  • SHA-512 verification for downloaded and reused files.
  • Local addon registry with managed, modified, missing, and external states.
  • adopt registers an existing file without moving or copying it.
  • Exact-file uninstall for external or modified addons.
  • Optional orphan dependency cleanup based on known required-dependency edges.
  • Configurable preferred provider, with Modrinth as the initial default.

Examples

elo search sodium --type mod --instance fabric-1_21
elo install fabric-1_21 sodium --dry-run
elo install fabric-1_21 sodium
elo addons fabric-1_21
elo adopt fabric-1_21 mods/manual-addon.jar
elo uninstall fabric-1_21 sodium
elo provider set modrinth

Requirements

  • Bash on Linux or macOS.
  • curl and jq for provider commands.
  • sha512sum or shasum for addon integrity verification.

Safety

  • Existing files are never overwritten.
  • A matching existing file is reused only after SHA-512 verification.
  • Modified managed files require explicit exact-file removal.
  • External files remain unmanaged until explicitly adopted.
  • Addon filenames and target paths are validated before filesystem changes.

Known limitations

  • Modrinth is the only provider currently implemented.
  • Modpacks (.mrpack) are not supported.
  • Elo does not install Minecraft versions or mod loaders.
  • Orphan cleanup cannot infer optional relationships or usage by external
    addons. Review the proposed list before confirming removal.
  • Search results are filtered by the active or selected instance; unfiltered
    search is not currently available when an instance is active.

What's Changed

  • Feat: Add provider-based management and install planning for addons by @3nderXP in #7
  • Release v0.3.0 by @3nderXP in #8

Full Changelog: v0.2.0...v0.3.0