https://github.com/JayanAXHF/modder-rs
A CLI tool to bulk update/download mods from modrinth
https://github.com/JayanAXHF/modder-rs
Last synced: 7 months ago
JSON representation
A CLI tool to bulk update/download mods from modrinth
- Host: GitHub
- URL: https://github.com/JayanAXHF/modder-rs
- Owner: JayanAXHF
- Created: 2025-06-01T10:56:36.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-02T11:21:22.000Z (7 months ago)
- Last Synced: 2025-09-02T13:23:42.437Z (7 months ago)
- Language: Rust
- Size: 313 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-ratatui - modder-rs - A practical TUI to manage and install mods for Minecraft. (đģ Apps / đšī¸ Games and Entertainment)
README
# Modder-rs
[](https://github.com/jayansunil/modder/actions/workflows/rust.yml)
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.
## Features
- [x] Bulk-update a directory of mods
- [x] Add mods via Modrinth
- [ ] Add mods via CurseForge (implementation on hold)
- [x] Add mods via Github Releases
- [x] Toggle mods in a directory (enables/disables them by renaming the file extension)
- [x] 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:
```sh
git clone https://github.com/jayansunil/modder.git
cd modder
```
3. Install the binary:
```sh
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.
```sh
modder add --version --loader
```
- **Example (Modrinth):**
```sh
modder add sodium --version 1.21 --loader fabric
```
- **Example (GitHub):** If the mod is on GitHub, `modder` will infer it.
```sh
modder add fabricmc/fabric-api --version 1.21
```
- **Example (CurseForge):**
```sh
modder add create --version 1.20.1 --loader forge --source curseforge
```
### `update`
Bulk-update all mods in a directory to a specific game version.
```sh
modder update --dir ./mods --version
```
- **Example:**
```sh
modder update --dir ./mods --version 1.21 --delete-previous
```
### `list`
List all mods in a directory with detailed information.
```sh
modder list [--dir ./mods] [--verbose]
```
- **Example:**
```sh
modder list --dir ./mods --verbose
```
### `toggle`
Enable or disable mods in a directory interactively.
```sh
modder toggle [--dir ./mods]
```
### `quick-add`
Interactively select from a list of popular mods to add.
```sh
modder quick-add --version --loader
```
## License
This project is licensed under the MIT License. See the [LICENSE](tui/LICENSE) file for details.