1assets/patpat/
 2├── sounds.json                     # 默认音效注册表
 3├── sounds/
 4│   ├── pat.ogg     (9KB)           # 抚摸音效变体 1
 5│   ├── pat1.ogg    (9KB)           # 抚摸音效变体 2
 6│   ├── pat2.ogg    (9KB)           # 抚摸音效变体 3
 7│   ├── lopi.ogg    (16KB)          # 彩蛋音效变体 1
 8│   ├── lopi1.ogg   (15KB)          # 彩蛋音效变体 2
 9│   ├── lopi2.ogg   (17KB)          # 彩蛋音效变体 3
10│   └── lopi3.ogg   (17KB)          # 彩蛋音效变体 4
11├── textures/
12│   ├── default/patpat.png          # 默认动画纹理（560×112，5帧）
13│   ├── cape/patpat_cape_hand.png   # 披风纹理（64×32）
14│   ├── config/                     # 配置界面图标
15│   └── easter/egg.json             # 内置彩蛋配置（山羊 "Снежа"）
16└── lang/                           # 140+ 语言文件

1{
2    "patpat": { "sounds": ["patpat:pat", "patpat:pat1", "patpat:pat2"] },
3    "lopi":   { "sounds": ["patpat:lopi", "patpat:lopi1", "patpat:lopi2", "patpat:lopi3"] }
4}

1# API 查询（以 26.1 为例）
2curl -s "https://piston-meta.mojang.com/mc/game/version_manifest_v2.json" \
3  | jq -r '.versions[] | select(.id=="26.1") | .url' \
4  | xargs curl -s | jq '.pack_version.resource'
5# 输出: {"resource": 84, "data": 103}

 1from PIL import Image, ImageOps
 2
 3# 加载原版末地烛纹理（16×16）
 4src = Image.open("end_rod.png")
 5
 6# 垂直翻转 → 倒置
 7flipped = ImageOps.flip(src)
 8
 9# 缩放到 112×112（NEAREST 保留像素风格）
10frame = flipped.resize((112, 112), Image.NEAREST)
11
12# 平铺 5 帧 → 560×112
13spritesheet = Image.new("RGBA", (560, 112))
14for i in range(5):
15    spritesheet.paste(frame, (i * 112, 0))
16
17spritesheet.save("patpat.png")

1# 从原版素材复制（以史莱姆音效为例）
2cp slime_big1.ogg   pat.ogg
3cp slime_big2.ogg   pat1.ogg
4cp slime_small1.ogg pat2.ogg

1file pat.ogg
2# 期望: Ogg data, Vorbis audio, mono, 44100 Hz
3# ❌ 如果是 stereo → 用 Audacity 重新导出为 Mono

1{
2  "pack": {
3    "description": "PatPat × 倒置末地烛 + 史莱姆音效",
4    "pack_format": 84,
5    "supported_formats": 84
6  }
7}

 1❌ 错误：
 2my_pack.zip
 3└── MyPack/                  ← 多余！
 4    ├── pack.mcmeta
 5    └── assets/...
 6
 7✅ 正确：
 8my_pack.zip
 9├── pack.mcmeta              ← 必须在 ZIP 根层级
10└── assets/
11    └── patpat/
12        ├── textures/default/patpat.png
13        └── sounds/...

1python3 -c "
2import zipfile
3with zipfile.ZipFile('my_pack.zip', 'r') as zf:
4    for name in zf.namelist():
5        print(name)
6"
7# 第一行必须是 pack.mcmeta

1import zipfile, os
2
3src_dir = "my_pack_folder"  # 源文件夹
4with zipfile.ZipFile("my_pack.zip", "w", zipfile.ZIP_DEFLATED) as zf:
5    for root, dirs, files in os.walk(src_dir):
6        for f in files:
7            fp = os.path.join(root, f)
8            arcname = os.path.relpath(fp, src_dir)
9            zf.write(fp, arcname)

 1// animated_piston.json5（文件名随意，后缀 .json 或 .json5）
 2{
 3    "version": "1.0.0",           // 配置版本（必需）
 4    "priority": 10,               // 优先级（可选，默认 0）
 5    "blacklist": false,           // true=黑名单 / false=白名单（可选，默认 false）
 6    "animation": {
 7        "texture": "patpat:textures/animated_piston.png",
 8        "duration": 300,          // 动画时长（ms）
 9        "frame": {
10            "totalFrames": 5,     // 总帧数
11            "scaleX": 1.0,        // X 轴缩放（默认 0.9）
12            "scaleY": 1.0,        // Y 轴缩放（默认 0.9）
13            "offsetX": 0.0,       // X 轴偏移（默认 0）
14            "offsetY": 0.0,       // Y 轴偏移（默认 0）
15            "offsetZ": 0.0        // Z 轴偏移（默认 0）
16        },
17        "sound": {
18            "id": "patpat:my_custom_sound_id",
19            "minPitch": 0.5,
20            "maxPitch": 1.5,
21            "volume": 0.8
22        }
23    },
24    "entities": [
25        // 指定实体（可以是类型字符串或 entity 对象）
26        "minecraft:zombie",
27        {
28            "id": "minecraft:sheep",
29            "name": "Jeb_",                       // 仅匹配名为 "Jeb_" 的羊
30            "from": {
31                "name": "LopyMine"                // 仅 LopyMine 抚摸时触发
32            }
33        }
34    ]
35}

1{
2    "my_custom_sound_id": {
3        "sounds": ["patpat:my_sound_file_name"]
4    }
5}

1"sound": {
2    "id": "patpat:my_custom_sound_id",
3    "minPitch": 0.8,
4    "maxPitch": 1.2,
5    "volume": 1.0
6}

 1MyPatPatAnimation/
 2├── pack.mcmeta
 3└── assets/
 4    └── patpat/
 5        ├── textures/
 6        │   └── animated_piston.png         # 活塞精灵图
 7        ├── sounds/
 8        │   └── piston_sound.ogg             # 自定义音效
 9        ├── sounds.json                       # 音效注册
10        └── my_animations/
11            └── animated_piston.json5         # 动画配置

1{
2  "pack": {
3    "description": "PatPat × 自定义活塞动画",
4    "pack_format": 84,
5    "supported_formats": 84
6  }
7}

 1# 1. 获取版本元数据
 2VER="26.1"
 3VER_URL=$(curl -s "https://piston-meta.mojang.com/mc/game/version_manifest_v2.json" \
 4  | python3 -c "import sys,json; d=json.load(sys.stdin); \
 5    [print(v['url']) for v in d['versions'] if v['id']=='$VER']")
 6
 7# 2. 获取 asset index URL
 8ASSET_IDX=$(curl -s "$VER_URL" \
 9  | python3 -c "import sys,json; print(json.load(sys.stdin)['assetIndex']['url'])")
10
11# 3. 搜索目标文件
12curl -s "$ASSET_IDX" | python3 -c "
13import sys,json
14d=json.load(sys.stdin)
15for path, info in d['objects'].items():
16    if 'end_rod' in path or 'slime' in path:
17        print(f'{path} -> {info[\"hash\"]}')
18"

1minecraft/textures/block/end_rod.png -> <sha1_hash>
2minecraft/sounds/mob/slime/big1.ogg -> b5eca1979e69271b2065ac67ba2c37b5afac0f98

1https://resources.download.minecraft.net/{hash前2位}/{完整hash}

1# 例
2curl -o big1.ogg \
3  "https://resources.download.minecraft.net/b5/b5eca1979e69271b2065ac67ba2c37b5afac0f98"

1curl -o client.jar "<version.json 中 downloads.client.url>"
2unzip client.jar "assets/minecraft/textures/block/end_rod.png"

1Template Custom Animation/
2├── pack.mcmeta
3└── assets/
4    └── patpat/
5        ├── sounds.json
6        ├── sounds/
7        └── texture/