By name: packwiz description: Create and manage Minecraft modpacks using packwiz CLI. Use when working with pack.toml, .pw.toml files, adding/removing mods from CurseForge or Modrinth, exporting packs, or when the user mentions packwiz, modpacks, or Minecraft mod management.
packwiz
File Structure
- pack.toml - Pack metadata: name, author, version, pack-format, index path, Minecraft/loader versions
- index.toml - File manifest with
[[files]]entries (file path + hash); regenerated bypackwiz refresh - *.pw.toml - Per-file metadata in
mods/,resourcepacks/, etc.:name,filename,side,[download],[update]
Core Commands
| Task | Command |
|---|---|
| Init pack | packwiz init (use --pack-file, --mc-version, --fabric-version, etc. for non-interactive) |
| Add mod (CurseForge) | packwiz curseforge add <URL or slug or search> |
| Add mod (Modrinth) | packwiz modrinth add <URL or slug or search> |
| Add from URL | packwiz url add <name> <url> |
| Remove mod | packwiz remove (interactive) or delete .pw.toml + run refresh |
| Update mods | packwiz update or packwiz update -a |
| Rebuild index | packwiz refresh |
| List mods | packwiz list |
| Local server | packwiz serve -p 8080 |
| Export CurseForge | packwiz curseforge export -o output.zip |
| Export Modrinth | packwiz modrinth export -o output.mrpack |
| Migrate versions | packwiz migrate minecraft / packwiz migrate loader |
Global Flags
--pack-file- Override pack.toml path (default:pack.toml)--meta-folder-base- Base for resolving meta folders (e.g. subfolder packs)-y- Non-interactive (accept defaults)
.pw.toml Format
side:"both","client", or"server"[download]:url,hash,hash-format(sha512, sha256, sha1, md5)[update]:[update.modrinth](mod-id, version) or[update.curseforge](project-id, file-id)
Workflows
Add mod: cd <pack-dir>, packwiz curseforge add <slug> or packwiz modrinth add <slug>, then packwiz refresh
Remove mod: Delete the .pw.toml and physical file, run packwiz refresh
Multi-pack workspace: Use --pack-file path/to/pack.toml when not in pack root
Export for distribution: Run packwiz refresh first, then packwiz modrinth export or packwiz curseforge export
Workspace Conventions
- Packs live in subfolders (e.g.
cobbleverse/,sunlit_valey/) each with ownpack.toml scripts/_check_hashes.py- Validates hash lengths in .pw.toml filesscripts/mrpack_to_packwiz.py- Converts .mrpack to packwiz format