server pack builder

A Python CLI tool for filtering Minecraft modpacks to create server-compatible mod sets. It supports both local directory processing and direct Modrinth modpack integration.

Installation

Ensure Python 3.8+ is installed. Install dependencies:

pip install -r requirements.txt

Usage

The tool operates in two modes: Local and Modrinth.

Local Mode

Process a local directory of mods:

python server_pack_builder.py --source /path/to/mods --destination /path/to/server_mods

Modrinth Mode

Download and filter a Modrinth modpack directly from a URL or slug:

# Download latest version
python server_pack_builder.py --modrinth-url https://modrinth.com/modpack/fabric-boosted

# Download specific version
python server_pack_builder.py --modrinth-url fabric-boosted --pack-version "1.2.3"

GUI Mode

Launch the graphical user interface for an easy-to-use experience:

python server_pack_builder.py --gui

Arguments

Common

• --dry-run: Simulate the process without copying or writing files.
• --verbose, -v: Enable verbose logging.

Local Mode

• --source, -s: Path to the source 'mods' directory.
• --destination, -d: Path to the destination 'mods' directory.

Modrinth Mode

• --modrinth-url, -m: Modrinth Modpack URL or Slug.
• --pack-version: Specific version ID or Number to download (overrides latest).
• --output-file, -o: Output path for the generated .mrpack (optional, defaults to {PackName}-server.mrpack).

Features

• Client-Side Filtering: Automatically detects and removes client-only mods by inspecting JAR metadata.
• Modrinth Integration: Downloads, filters, and repacks .mrpack files.
• Modrinth Search: Search for modpacks and view their details/logos within the GUI.
• Version Selection: Choose between the latest release or specific versions of a modpack.
• Multi-Loader Support: Works with Fabric and Forge mod loaders.
• Overrides Preservation: Keeps configuration and other data from the modpack's overrides folder.

Screenshots

Main Application Window

The main interface allowing selection between Local and Modrinth modes.

Modrinth Search Dialog

Search for modpacks directly from Modrinth with logo previews.

Version Selection

Select specific versions or stick to the latest release.

Development

For linting and testing:

python -m black . && python -m isort . && python -m flake8 . && python -m mypy .
python -m pytest