Modder-rs

September 20, 2025 ยท View on GitHub

CI

A simple, fast tool for managing Minecraft mods from the command line.

Modder is a tool for managing mods for Minecraft. It can add mods from Modrinth, CurseForge, and Github Releases. Other features include bulk-updating a directory of mods to a specified version, listing detailed information about the mods in a directory, and toggling mods on or off without deleting the files.

cargo install --locked modder_tui

Features

  • Bulk-update a directory of mods
  • Add mods via Modrinth
  • Add mods via CurseForge
  • Add mods via Github Releases
  • Toggle mods in a directory (enables/disables them by renaming the file extension)
  • List mods with details like version, source, and category
  • Support for modpacks

Workspace Structure

This repository is a cargo workspace containing two main crates:

  • core: The primary crate that contains all the command-line logic, API wrappers, and file management code.
  • tui: A work-in-progress crate for a Terminal User Interface (TUI) for modder.

Installation

  1. Ensure you have Rust and Cargo installed.
  2. Clone the repository: 
    git clone https://github.com/jayansunil/modder.git
cd modder
  3. Install the binary: 
    cargo install --path .
    This will install the modder binary in your cargo bin path.

Usage

Modder provides several commands to manage your mods.

add

Add a mod from Modrinth, CurseForge, or GitHub.

modder add <MOD_NAME> --version <GAME_VERSION> --loader <LOADER>
  • Example (Modrinth): 
    modder add sodium --version 1.21 --loader fabric
  • Example (GitHub): If the mod is on GitHub, modder will infer it. 
    modder add fabricmc/fabric-api --version 1.21
  • Example (CurseForge): 
    modder add create --version 1.20.1 --loader forge --source curseforge

update

Bulk-update all mods in a directory to a specific game version.

modder update --dir ./mods --version <NEW_GAME_VERSION>
  • Example: 
    modder update --dir ./mods --version 1.21 --delete-previous

list

List all mods in a directory with detailed information.

modder list [--dir ./mods] [--verbose]
  • Example: 
    modder list --dir ./mods --verbose

toggle

Enable or disable mods in a directory interactively.

modder toggle [--dir ./mods]

quick-add

Interactively select from a list of popular mods to add.

modder quick-add --version <GAME_VERSION> --loader <LOADER>

License

This project is licensed under the MIT License. See the LICENSE file for details.