Modder-rs

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.