#mod-manager #minecraft-mod #minecraft #mod #manager

bin+lib modder

Modder-rs is a mod manager for Minecraft. This crate contains the cli and the core logic that is also used by the TUI wrapper.

1 stable release

Uses new Rust 2024

1.0.0 Sep 3, 2025

#1276 in Games


Used in modder_tui

MIT license

93KB
2.5K SLoC

Modder Core

This crate contains the core business logic for the modder command-line tool. It handles interactions with modding APIs, file management, and the implementation of the CLI commands.

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
  • List mods with detailed information
  • Support for modpacks

Core Functionality

The crate is structured into several key modules:

  • modrinth_wrapper: Provides functions for interacting with the Modrinth API (v2), including searching for mods, fetching version information, and handling dependencies.
  • curseforge_wrapper: Contains the logic for interacting with the CurseForge API. Note: This implementation is currently on hold due to API complexity.
  • gh_releases: Handles fetching release information and downloading mod files from GitHub Repositories.
  • actions: Implements the primary logic for each of the CLI subcommands (e.g., add, update, list).
  • cli: Defines the command-line interface structure, arguments, and subcommands using the clap crate.
  • metadata: Manages reading and writing custom metadata to mod JAR files. This is used to track the source of a mod (Modrinth, GitHub, etc.) for future updates.

Usage

While this crate can be used as a library to build other Minecraft-related tools, its primary purpose is to serve as the engine for the modder binary. It is not intended for direct use by end-users.

License

This project is licensed under the MIT License.

Dependencies

~32–55MB
~762K SLoC