Valheim Packager

Valheim Packager is a small command-line helper for preparing Valheim mod releases. It creates, validates, and packages Thunderstore-ready release files from your mod project folder, so you do not need to manually rebuild the same folder structure every time you release or update a mod.

The tool is mainly built around the common Valheim BepInEx modding workflow: develop and test your mod in a local BepInEx plugins folder, keep your Thunderstore files in your project, then generate a clean release folder and upload-ready zip when the mod is ready.

It helps catch common packaging mistakes, such as missing manifest files, missing README, invalid icon size, missing DLLs, and zip files with the wrong root structure.

• []Creates starter Thunderstore package files with the init command.[/]

  []Validates the required release files before packaging.[/]

  []Checks manifest, README, icon, changelog, and mod DLL files.[/]

  []Verifies that icon.png is a valid 256x256 PNG.[/]

  []Checks common manifest fields such as mod name, version, website URL, description, and dependencies.[/]

  []Creates a clean release folder inside dist.[/]

  []Creates a matching upload-ready zip file.[/]

  []Uses the correct Thunderstore root structure, so files are placed directly inside the zip instead of inside an extra parent folder.[/]

  []Can copy the mod DLL automatically from your local BepInEx plugins folder.[/]

  []Supports project-specific settings through valheim-packager.json.[/]

  []Supports a global config file for your local BepInEx plugins path.[/]

  []Designed for repeatable release commands from inside your mod project folder.[/]

  Valheim Packager is a standalone Windows command-line tool.

  Recommended:

  • []Windows 10 or Windows 11[/]

    []A Valheim mod project you want to package[/]

    []A terminal, such as Command Prompt, PowerShell, or Windows Terminal[/]

    []Optional: r2modman or another local BepInEx setup if you want Valheim Packager to copy your DLL automatically from your development plugins folder[/]

  PowerShell is only needed if you want to use the provided PATH setup snippet.

  BepInEx is only needed for developing and testing Valheim mods. Valheim Packager itself does not require BepInEx to run.

  Download Valheim Packager and extract it to a permanent folder on your computer.

  Recommended example location:

  C:\Tools\ValheimPackager

  The folder should contain:ValheimPackager.exe

  Optional but recommended: add the folder to your Windows PATH. This allows you to run Valheim Packager from any mod project folder. You can add it to your user PATH with PowerShell: