Podzol

A modern package manager for Minecraft modpacks that simplifies creation and management through a clean TOML-based manifest format and direct integration with the Modrinth API.

Features

• Simple TOML-based manifest format
• Direct integration with Modrinth API
• Automatic version management
• Client/server-side awareness
• Support for multiple mod loaders (Fabric, Forge, Quilt, NeoForge)
• Built-in resource pack and shader management
• File override system for custom configurations

Installation

From Crates.io

cargo install podzol

From AUR (Arch Linux)

paru -S podzol

Quick Start

1. Create a new modpack:

podzol init --name "My Cool Pack" --version 1.21.1 --loader fabric

2. Add mods to your pack:

podzol add iris sodium modmenu

3. Export your modpack:

podzol export

Configuration

Podzol uses a clean TOML format for modpack configuration:

[pack]
name = "Cool pack"
version = "0.1.0"
description = "A very cool minecraft modpack"

[enviroment]
minecraft = "1.21.1"
fabric = "0.16.10"

[mods]
iris = { version = "1.8.1+1.21.1-fabric", side = "client" }
sodium = { version = "mc1.21.1-0.6.5-fabric", side = "client" }

Manifest Structure

• Pack Information: Basic metadata about your modpack
• Environment: Minecraft and mod loader versions
• Mods: Mod definitions with automatic version management
• Resource Packs: Optional resource pack configurations
• Shaders: Shader pack configurations
• File Overrides: Custom file management for client/server

Commands

podzol init    # Create a new project
podzol add     # Add components to your modpack
podzol remove  # Remove components
podzol export  # Create a distributable package

Roadmap

• Publishing capabilities
• Package extension support
• Additional mod platform integrations
• Advanced configuration options

Comparison with Other Tools

| Feature | Podzol | Packwiz | Manual Management | | -------------------- | ----------- | ------------ | ----------------- | | Configuration Format | Simple TOML | Complex TOML | N/A | | Version Management | Automatic | Manual | Manual | | Modrinth Integration | Direct API | Limited | None | | Setup Complexity | Minimal | Complex | None | | Learning Curve | Gentle | Steep | N/A |

License

This project is licensed under the Apache-2.0 License. For more information, please see the LICENSE file.