60cce66993
Tests / test (push) Has been cancelled
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
141 lines
6.1 KiB
Python
141 lines
6.1 KiB
Python
"""Unpack a .unitypackage without Unity.
|
||
|
||
一个 .unitypackage 只是一个经过 gzip 压缩的 tar 归档文件。每个资源都存放在一个以其 32 位十六进制 GUID 命名的文件夹中,该文件夹包含:
|
||
asset the real file (FBX, prefab, png, ...)
|
||
asset.meta Unity metadata (importer type, guid)
|
||
pathname original path inside Assets/
|
||
preview.png optional thumbnail
|
||
|
||
解包后的落盘规则:
|
||
asset → <输出目录>/<Assets 里的相对路径> 例:.../FBX/model.fbx
|
||
辅助文件 → 与资产同层,名字带上资产名 例:.../FBX/model.fbx.meta
|
||
(asset.meta → <名>.meta,pathname / preview.png → <名>.pathname 等)
|
||
文件夹资源 → 建出同名空文件夹(tar 里没有它的 asset 本体)
|
||
辅助文件之所以带上资产名,是因为同一目录下常有两个以上资产,若统一叫
|
||
asset.meta / pathname 就会互相覆盖,只剩最后一个。
|
||
|
||
Usage:
|
||
python unitypackage_unpack.py <file.unitypackage> [-o OUTDIR] [--list]
|
||
|
||
# 先看包里有什么(不解包)
|
||
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage" --list
|
||
|
||
# 解包到默认目录(<文件名>_extracted)
|
||
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage"
|
||
|
||
# 解包到指定目录
|
||
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage" -o "D:/output/Sapphy"
|
||
|
||
只要路径里带空格或中文,就套一层双引号,否则 shell 会按空格切参数。
|
||
"""
|
||
import argparse
|
||
import os
|
||
import shutil
|
||
import sys
|
||
import tarfile
|
||
|
||
# Windows 超长路径支持:Unity 包里的目录树很深,再叠上输出目录很容易超 260
|
||
# 字符而报 FileNotFoundError。这个模块导入即生效,短路径行为不变。
|
||
# 单独把本文件拷出去用时可能找不到,所以吞掉 ImportError。
|
||
try:
|
||
import longpath # noqa: F401
|
||
except ImportError: # pragma: no cover
|
||
pass
|
||
|
||
|
||
def _members(src):
|
||
"""按包里的顺序逐个给出 (GUID, 文件名, 内容),整个包只解压一遍(流式读 tar)。
|
||
|
||
以前先 getmembers() 走一遍、再按成员回头读 pathname、再逐个解出:gzip 不能往回跳,
|
||
每次回头都从头再解,161 MB 的包要解三遍。"""
|
||
with tarfile.open(src, 'r|gz') as t:
|
||
for m in t:
|
||
if m.isfile():
|
||
guid, fn = m.name.split('/', 1)
|
||
yield guid, fn, t.extractfile(m).read()
|
||
|
||
|
||
def _target(outdir, raw, guid, fn):
|
||
"""一个成员的落盘路径,以及它是不是「文件夹」资源的辅助文件(要建出空文件夹)。"""
|
||
# pathname 以 '/' 结尾 = 这是一个「文件夹」资源(Unity 里文件夹也是资源)。
|
||
# tar 里没有它的 asset 本体,只有 asset.meta / pathname / preview.png。
|
||
is_folder = raw.endswith('/') or not raw or raw == guid
|
||
# 去掉开头的 "Assets/"(以前用 lstrip('Assets/'),那是按字符集剥:
|
||
# "Assets/shaders/x" 会被剥成 "haders/x")
|
||
rel = (raw[len('Assets/'):] if raw.startswith('Assets/') else raw).rstrip('/') or guid
|
||
if fn == 'asset':
|
||
return os.path.join(outdir, rel), rel, False
|
||
# asset.meta / pathname / preview.png 是辅助文件:跟资产放在同一层,
|
||
# 名字里带上资产名(asset.meta 按 Unity 习惯写成 <名>.meta)。
|
||
# 早先直接写 <父目录>/<文件名>,同一目录下有两个以上资产时,
|
||
# 后一个会把前一个**静默覆盖**(实测 172 个输出里 51 个碰撞、
|
||
# 168 个成员被覆盖,其中 92 个 asset.meta + 92 个 pathname)。
|
||
name = os.path.basename(rel) or guid
|
||
aux = name + '.meta' if fn == 'asset.meta' else name + '.' + fn
|
||
return os.path.join(outdir, os.path.dirname(rel), aux), rel, is_folder
|
||
|
||
|
||
def unpack(src, outdir, list_only=False, verbose=True):
|
||
"""解包到 outdir;verbose=False 时不逐个列出文件(界面 / 流水线自己记一行汇总)。
|
||
|
||
一个资源的成员在包里是挨着的(asset、asset.meta、pathname、preview.png),落盘路径要等
|
||
读到 pathname 才知道:之前的成员先留在内存里(最多一个资源的大小),读到它再按原顺序写出。"""
|
||
if list_only:
|
||
paths, sizes = {}, []
|
||
for guid, fn, data in _members(src):
|
||
if fn == 'pathname':
|
||
paths[guid] = data.decode('utf-8', 'replace').strip()
|
||
elif fn == 'asset':
|
||
sizes.append((guid, len(data)))
|
||
for guid, size in sizes:
|
||
print('%10d %s' % (size, paths.get(guid, '?')))
|
||
return 0
|
||
|
||
if os.path.isdir(outdir):
|
||
shutil.rmtree(outdir)
|
||
os.makedirs(outdir)
|
||
paths, pending = {}, {}
|
||
n = 0
|
||
|
||
def write(guid, fn, data):
|
||
dst, rel, folder = _target(outdir, paths.get(guid, ''), guid, fn)
|
||
os.makedirs(os.path.dirname(dst), exist_ok=True)
|
||
if folder:
|
||
# 文件夹资源的 asset 本体不存在,不在这里建的话空文件夹会丢
|
||
os.makedirs(os.path.join(outdir, rel), exist_ok=True)
|
||
with open(dst, 'wb') as w:
|
||
w.write(data)
|
||
if verbose:
|
||
print(' %8.1f KB %s' % (len(data) / 1024, os.path.relpath(dst, outdir)))
|
||
|
||
for guid, fn, data in _members(src):
|
||
if fn == 'pathname':
|
||
paths[guid] = data.decode('utf-8', 'replace').strip()
|
||
if guid in paths:
|
||
for item in pending.pop(guid, ()):
|
||
write(guid, *item)
|
||
write(guid, fn, data)
|
||
else:
|
||
pending.setdefault(guid, []).append((fn, data))
|
||
n += 1
|
||
for guid, items in pending.items(): # 没有 pathname 的资源:按 GUID 落盘
|
||
for item in items:
|
||
write(guid, *item)
|
||
if verbose:
|
||
print('\n%d files -> %s' % (n, outdir))
|
||
return 0
|
||
|
||
|
||
def main():
|
||
ap = argparse.ArgumentParser()
|
||
ap.add_argument('src')
|
||
ap.add_argument('-o', '--out', default=None)
|
||
ap.add_argument('--list', action='store_true')
|
||
a = ap.parse_args()
|
||
out = a.out or os.path.splitext(a.src)[0] + '_extracted'
|
||
return unpack(a.src, out, a.list)
|
||
|
||
|
||
if __name__ == '__main__':
|
||
sys.exit(main())
|