v0.3.0
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-runpreviews 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.
adoptregisters 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 modrinthRequirements
- Bash on Linux or macOS.
curlandjqfor provider commands.sha512sumorshasumfor 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