Tutorial

Pack Merger

Intelligently merge multiple resource packs into one optimised pack.

Product page Downloads Documentation Roadmap

Install Pack Merger #

Install Fabric Loader for 1.21 (plus Fabric API if the downloads page asks for it), place the JAR in your mods folder, and launch with the Fabric profile.

  1. Install the Pack Merger mod on the Minecraft version you target — keep the build matched to your version.
  2. Open Options → Resource Packs and press the Merge button to open the visual merger screen.
  3. Add resource packs in your preferred priority order — list order is the default priority per asset.
  4. Review the detected conflicts in the GUI: each colliding asset shows which packs provide it and the current resolution.
  5. Resolve conflicts per-asset (Keep / Lost / Use), bulk-resolve by category, or Resolve All by priority.
  6. Export the merged pack — one clean ZIP with the correct pack_format baked in; no ZIP tools needed.
  7. Apply the exported pack from the Resource Packs screen, enabled near the top of the list.
  8. For scripted or server-side merges, use the /packmerge command suite: scan, merge <a> <b>, export, import, list, conflicts, strategy, resolve and clear.

Working with Pack Merger #

Product-specific steps, separate from the general install guide above.

Merge from the GUI

Open the **Resource Packs** screen and press the **Merge** button to open the visual merger. Add packs in your preferred **priority order** — the list order decides which pack wins per asset by default. The engine scans for conflicts using **BFS/diff-based conflict detection**, finds and classifies every collision across packs, then exports one clean pack. Your **originals are never changed**.

What you'll see. The merger screen lists your selected packs in order, then a conflicts panel: each colliding asset shows which packs provide it and what the current resolution is.

Resolve conflicts

Per-asset choices are **Keep / Lost / Use** — keep a pack's version, drop the asset, or use a specific pack's copy. Bulk resolution works by category, and **Resolve All by priority** applies the list order everywhere at once. Review the detected conflicts in the GUI before exporting — you always know exactly which pack wins per asset.

Export a version-correct pack

Export produces a single ZIP with the correct **pack_format** baked in for your target Minecraft version (1.21 → 1.21.11 and 26.x). No ZIP tools needed — merging and export happen entirely in-game. Enable the exported pack from the Resource Packs screen like any other pack.

What you'll see. The exported pack appears in your resourcepacks folder with a generated name; enable it at the top of the Resource Packs list for highest priority.

Headless merging from chat (power users)

Server-side and scripted merging uses the /packmerge command suite:

  • scan — detect conflicts across imported packs without merging.
  • merge <a> <b> — combine two packs headlessly.
  • export — write the merged pack with the target pack_format.
  • strategy — set the automatic resolution strategy used by merge.
/packmerge scan
/packmerge merge <a> <b>
/packmerge export
/packmerge import | list | conflicts | strategy | resolve | clear

Combine DPT colour themes

The DPT family ships as separate colour packs — stacking resource packs directly causes conflicts. Use **Pack Merger** to combine DPT colours (and any other packs) into one clean pack instead of fighting load order.

Tips

  • Order packs before merging: list order is the default priority.
  • Originals are never modified — re-merge any time.
  • Ships 1.9.1 across 1.21 → 1.21.11 and 26.x.

Common problems

Exported pack shows the wrong pack_format
Fixed in 1.9.1 — update, then re-export. Pick the build matching your target Minecraft version.
Textures look wrong after enabling the merged pack
Conflict resolution chose a different source than you expected — reopen the merger and change the per-asset choice for the affected assets, or use Resolve All by priority.
26.x export warns
26.x builds are experimental (bundled mappings) — keep the mod build matched to your target version.

Folder locations by platform #

Platformmods / resourcepacks folderconfig folder
Windows%appdata%\.minecraft\mods · \resourcepacks%appdata%\.minecraft\config
macOS~/Library/Application Support/minecraft/mods~/Library/Application Support/minecraft/config
Linux~/.minecraft/mods · ~/.minecraft/resourcepacks~/.minecraft/config

MultiMC / Prism users: these folders live inside Instances/<instance>/.minecraft/. Match the build to your exact Minecraft version — the compatibility table in the docs lists every supported version.

Configure #

Settings live in the config folder (JSON5 files you can edit by hand) and, where available, in the in-game settings screen the mod adds. The exact keys and keybinds are listed in the documentation and the FAQ below.

Tips for Pack Merger #

  • Keep Pack Merger on the version range shown on its product page.
  • If it doesn't load, confirm the JAR is in the right mods folder for the launcher and version you chose.
  • Bedrock Edition, mobile, and console can't run Java Edition mods or packs — for a port or custom variant, request a commission.

Pack Merger FAQ #

Does it modify my original packs?
No — originals are untouched; a new merged pack is exported, so you can re-merge any time.
Can I control conflict resolution?
Yes — per-asset Keep/Lost/Use choices, bulk resolution by category, and Resolve All by priority. Review detected conflicts in the GUI before export.
What versions are supported?
1.21 through 1.21.11, with experimental 26.x builds. Keep the mod build matched to your target Minecraft version.
Do I need ZIP tools?
No — merging and export happen entirely in-game, with the correct pack_format baked in.
Is there a headless option?
Yes — the /packmerge command suite supports import, list, conflicts, strategy, resolve, merge and clear for server-side and scripted use.
Can I undo an export?
Your source packs are never changed, so you can re-merge any time — just export a fresh merged pack.
How do I combine DPT colour themes?
Stacking resource packs directly causes conflicts — use Pack Merger to combine DPT packs (and any other packs) into one clean pack instead of fighting load order.
The exported pack looks wrong
Conflict resolution may have chosen a different source than you expected — reopen the merger and change the per-asset choice, or use Resolve All by priority. Exported pack_format staleness was fixed in 1.9.1.
Still stuck? Open a guided request — every message is tagged and answered from support@herostudios.dev. Always include your Minecraft version and product version.