valheim-mod-manager

Crates.io	valheim-mod-manager
lib.rs	valheim-mod-manager
version
source	src
created_at	2025-04-14 01:07:23.156066+00
updated_at	2025-04-14 03:37:28.096154+00
description	Mod manager for Valheim game
homepage	https://github.com/Endoze/valheim-mod-manager
repository	https://github.com/Endoze/valheim-mod-manager
max_upload_size
id	1632285
Cargo.toml error:	TOML parse error at line 22, column 1 \| 22 \| autolib = false \| ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size	0

Endoze (endoze)

documentation

https://docs.rs/valheim-mod-manager

README

Valheim Mod Manager (vmm)

A command-line tool for managing and automatically downloading Valheim mods and their dependencies.

Features

Automatically downloads mods from Thunderstore
Resolves and downloads all dependencies
Tracks downloaded mod versions
Only updates when new versions are available
Displays download progress with intuitive UI

Installation

From Source

# Clone the repository
git clone https://github.com/Endoze/valheim-mod-manager.git
cd valheim-mod-manager

# Install the application
cargo install --path .

# The binary will be installed in your Cargo bin directory

Configuration

The first time you run vmm, it will create a default configuration file at vmm_config.toml in your current directory. You can edit this file to customize:

mod_list: List of mods to install (in the format "Owner-ModName")
log_level: Logging verbosity (error, warn, info, debug, trace)
cache_dir: Directory to store cached mod information (default: ~/.config/vmm)
install_dir: Optional directory where unzipped mods will be copied (e.g., your Valheim mods folder)

Example configuration:

mod_list = ["denikson-BepInExPack_Valheim", "ValheimModding-Jotunn"]
log_level = "info"
cache_dir = "~/.config/vmm"
install_dir = "~/some/path/to/Valheim/BepInEx/plugins"

Usage

Update Mod Manifest

Fetches the latest information about available mods from Thunderstore:

vmm update manifest

Update Mods

Downloads all mods in your configuration, including their dependencies:

vmm update mods

Search for Mods

Searches available mods by name:

vmm search <term>

This performs a case-insensitive search for mods containing the specified term in their name, displaying matching mods with their owner, name, version, and description.

How It Works

Reads your configuration to determine which mods to download
Downloads the mod manifest from Thunderstore
Builds a dependency graph for all required mods
Downloads required mods and their dependencies
Extracts mod files, skipping those already downloaded with matching versions
If install_dir is configured, copies the extracted mods to that directory

Directory Structure

~/.config/vmm/ (or custom cache_dir setting in config): Cache directory for mod information
~/.config/vmm/downloads/ (or custom cache_dir/downloads): Location for downloaded mod archives and extracted files

Advanced Features

Troubleshooting

If you encounter issues:

Increase log verbosity in your config:
```
log_level = "debug"
```
Run the command again to see more detailed output

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Thunderstore for hosting Valheim mods
The amazing Valheim modding community

Commit count: 0