AutoPacker — Minecraft Resource Pack Generator

AutoPacker takes your raw resource pack folder and generates one .zip per Minecraft version group, automatically handling pack.mcmeta format differences across versions.

Prerequisites

• Python 3.9 or higher — no extra packages needed.

Quick Start

1. Edit autopacker.manifest.apmf with your settings (see below).
2. Open a terminal in the AutoPacker folder.
3. Run py main.py.
4. Finished .zip files are written to the Packs OK folder.

---

Manifest Configuration

All settings live in autopacker.manifest.apmf. Each line follows the key=value format.

pack-folder — source folder of your pack

This is the most important path to get right.

pack-folder must point to a folder that contains only the raw content of your pack — typically the assets/ folder (and any other root-level data folders). It must not contain pack.mcmeta nor the pack icon, because AutoPacker generates pack.mcmeta itself and injects the icon separately.

Expected folder layout:

your-pack-source/
└── assets/
    └── minecraft/
        ├── blockstates/
        ├── models/
        ├── textures/
        └── ...

The path can be relative (from the AutoPacker folder) or absolute.

# relative path — folder is next to AutoPacker
pack-folder=../my-pack-source

# relative path — folder is inside AutoPacker
pack-folder=./my-pack-source

# absolute path
pack-folder=C:\Users\you\Desktop\my-pack-source

Do not point pack-folder to the root of an already-built pack (one that already has a pack.mcmeta). AutoPacker will ignore it anyway, but the correct source is the raw content folder only.

---

pack-image — pack icon

Path to a .png file used as the pack icon in the Minecraft resource pack menu. Can be relative or absolute.

pack-image=./pack.png          # file in the AutoPacker folder
pack-image=../pack.png         # file one level above AutoPacker
pack-image=C:\icons\pack.png   # absolute path

---

Other fields

Key	Description
pack-version	Version label for your pack (any string, e.g. 2.0.1)
pack-title	Pack name shown in Minecraft (supports § color codes)
pack-description	Pack description shown in Minecraft (supports § color codes)
minecraft-versions	Target Minecraft versions (see syntax below)

Version syntax (no spaces allowed)

Format	Example	Meaning
Range	1.20-1.20.6	All versions from 1.20 to 1.20.6
List	1.17.1;1.20.2	Only 1.17.1 and 1.20.2
Mixed	1.17.1;1.20-1.21.4	1.17.1 plus all versions from 1.20 to 1.21.4

---

Full example

pack-version=2.0.1
pack-title=§1Better 3D Blocks
pack-description=§1Play§1 §6Minecraft§6... §2but§2 §fwith§f §5more§5 §93§9§aD§a §4!!§4
pack-image=../pack.png
pack-folder=../v2.0.1
minecraft-versions=1.10-1.21.11

---

Supported Versions

AutoPacker supports all stable Minecraft Java Edition releases from 1.6.1 to 1.21.11.

Starting with Minecraft 1.21.9, the pack.mcmeta format switched from pack_format to min_format / max_format. AutoPacker handles this automatically.

---

CLI Options

Option	Description	Default
--workers N	Parallel workers. -1 = one per pack, 0 = auto (CPU count), N = exact number	4
--dry-run	Preview which packs would be generated without writing any files	—
--output FOLDER	Output folder for generated .zip files	Packs OK
--manifest FILE	Path to an alternative .apmf manifest file	autopacker.manifest.apmf

py main.py --dry-run
py main.py --workers 0
py main.py --output "D:\exports" --manifest other_pack.apmf
py main.py --workers -1 --dry-run

---

Tool originally made for my 3D texture pack "Better 3D Blocks".