custom_pack.mcpack └── custom_pack/ ├── manifest.json ├── pack_icon.png └── textures/ └── blocks/ └── custom_texture.png The converter dynamically writes this file. Example:
"format_version": 2, "header": "name": "PNG Import Pack", "description": "Auto-converted from source_image.png", "uuid": "<generated-UUID>", "version": [1, 0, 0], "min_engine_version": [1, 19, 0] , "modules": [ "type": "resources", "uuid": "<generated-UUID-2>", "version": [1, 0, 0] ]
# 4. Create pack icon pack_icon = img.resize((256, 256)) pack_icon.save(os.path.join(temp_dir, "pack_icon.png")) png to mcpack converter
Uses a deterministic or random v4 UUID to ensure uniqueness. 3.2 Pack Icon The input PNG is resized to 256x256 and saved as pack_icon.png (the pack’s thumbnail in Minecraft’s settings menu). 4. Texture Assignment Logic (The "Mapping" Problem) A raw PNG does not know which block or item to replace. The converter must decide. We propose three user-selectable modes:
# 3. Generate manifest manifest = create_manifest(input_png, target_block) with open(os.path.join(temp_dir, "manifest.json"), "w") as f: json.dump(manifest, f) custom_pack
converter.py logo.png --mode item --target apple
| Mode | Decision Logic | Output Location | |------|----------------|----------------| | | Always valid. No JSON mapping needed; just replace textures/painting/kz.png | Overwrites painting kz (the 1x2 "Aztec" painting slot). | | Block Mode | Replace a common block (e.g., dirt.png ). User selects from a dropdown: dirt, stone, brick, glass. | textures/blocks/dirt.png | | Item Mode | Replace an item icon (e.g., compass_item.png ). | textures/items/compass_item.png | The converter must decide
If resolution is not a power of two, the converter resizes using nearest-neighbor (pixel art) or Lanczos (photorealistic) interpolation. 3. Output Format: .mcpack Structure An .mcpack file is a .zip archive containing a specific folder tree. The converter generates: