Wallpaper Engine 资源提取深度实战：RePKG 如何把 .pkg 变成一张 PNG

Wallpaper Engine 资源提取深度实战RePKG 如何把 .pkg 变成一张 PNG【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkgWallpaper Engine 里收藏的每一张动态壁纸背后都藏着一堆你看不见的资源主纹理、法线贴图、遮罩、UI 素材它们被封装进私有的.pkg容器纹理则使用带 LZ4 压缩与 DXT 块压缩的.tex格式。RePKG 正是通过逆向工程破解了这两种格式的 C# 开源工具——输入一个.pkg你能拿回原始文件、可编辑的 PNG、甚至还原 GIF 动图。本文不只教你怎么敲命令还会带你走进源码看懂 PKG 的 4 个核心字段和 TEX 的完整解码管线。一、先跑通完整链路从壁纸包到可编辑素材与其罗列功能不如先完成一个真实任务把一份创意工坊里的壁纸资源变成你本地可编辑的素材库。环境准备RePKG 是 .NET 项目命令行入口RePKG面向 .NET Framework 4.7.2核心与应用层则是netstandard2.0Windows 上安装 .NET SDK 后即可构建git clone https://gitcode.com/gh_mirrors/re/repkg cd repkg dotnet build构建产物repkg.exe支持两个子命令extract与info还藏着一个少有人知的interactive交互模式见第五节。第一次解包假设你的创意工坊目录下有一个壁纸项目431960其中scene.pkg就是核心资源包repkg extract E:\steamapps\workshop\content\431960\scene.pkg这条命令会在当前目录生成output文件夹PKG 内的每个条目按原始路径落盘凡是 TEX 纹理都会自动多转出一份 PNG旁边还会附带一个.tex-json信息文件把纹理的格式、尺寸、标志位全部结构化导出方便程序化读取。批量处理的关键参数壁纸爱好者通常面对的是几十上百个项目此时单文件操作就不够用了。下表是extract最常用的几个开关参数作用典型用法-r, --recursive递归搜索子目录里所有 PKG一次性处理整个 workshop 目录-e, --onlyexts只提取指定扩展名的条目-e tex只要纹理-i, --ignoreexts跳过指定扩展名的条目-i json不要配置文件-s, --singledir所有文件平铺到同一目录配合-e tex收集全部贴图-c, --copyproject把旁边的 project.json / preview.jpg 一并复制还原完整壁纸项目-n, --usename用 project.json 里的标题命名输出文件夹替代默认的数字 ID--no-tex-convert只提取原始字节不做 TEX 转图先备份、后批量转码两个高频组合示例# 递归提取所有壁纸并还原为可重新导入的项目结构 repkg extract -c -n -r E:\steamapps\workshop\content # 只要纹理全部平铺输出为 PNG去掉 PKG 内部路径 repkg extract -e tex -s -o ./textures E:\壁纸库跑完这一步你已经解锁了壁纸的全部素材。但能跑和懂它之间还差一层——接下来我们把二进制拆开看看。二、把 PKG 拆开看4 个字段讲完整个容器格式PKG 不是 Zip没有压缩、没有目录树表它的结构朴素到令人惊讶。结合PackageReader的源码整个容器可以画成一张图------------------------------ | Magic长度前缀字符串I32 | ← 校验用如 KTSP 之类 ------------------------------ | EntryCountint32 | ← 条目总数 ------------------------------ | 条目列表 × N | | FullPath长度前缀字符串 | | Offsetint32相对数据区 | | Lengthint32 | ------------------------------ | 数据区按条目 Offset 偏移 | ------------------------------读取逻辑在RePKG.Application/Package/PackageReader.cs里只有短短几十行var entryCount reader.ReadInt32(); for (var i 1; i entryCount; i) { var fullPath reader.ReadStringI32Size(maxLength: 255); list.Add(new PackageEntry { FullPath fullPath, Offset reader.ReadInt32(), Length reader.ReadInt32(), Type PackageEntryTypeGetter.GetFromFileName(fullPath) }); } // 数据区起始 头部结束位置 foreach (var entry in entries) { reader.BaseStream.Seek(entry.Offset dataStart, SeekOrigin.Begin); entry.Bytes reader.ReadBytes(entry.Length); }两个值得记下的细节Offset 是相对数据区起点的不是相对文件头。读取时必须先算出dataStart 头部结束位置再Seek(entry.Offset dataStart)否则会错位。条目类型完全由文件名推断PackageEntryTypeGetter.GetFromFileName(fullPath)看扩展名——.tex是纹理、.json是配置、.mp4/.webm是视频。这种约定优于存储的设计让写入端PackageWriter异常简单。想不落盘就看清楚包里有什么用info子命令# 列出所有条目并按大小排序 repkg info scene.pkg -e -s -b size # 顺便导出旁边 project.json 的全部元数据 repkg info scene.pkg -p *info还支持--title-filter按壁纸标题过滤适合在数百个包中定位目标——这正是批量提取前的侦察环节。三、TEX 转换LZ4、DXT 与裁一裁再存的细节如果说 PKG 是简单的集装箱TEX 就是里面最讲究的货物。.tex以两个魔数开头TEXV0005与TEXI0001随后是头信息、图像容器以及仅 GIF 时帧信息容器。TexReader对魔数做了严格校验不匹配直接抛UnknownMagicException。三种原样可用的像素格式TexHeader记录了TextureWidth/Height纹理实际尺寸与ImageWidth/Height图像逻辑尺寸两者往往不一致——纹理为了满足 GPU 的 2 次幂对齐会填充多余像素。mipmap 的像素格式分三类MipmapFormat字节/像素说明RGBA88884标准 RGBA直接可用RG882双通道常用于法线贴图的 XYR81单通道灰度/遮罩这三种格式无需解码读取像素后即可送入 ImageSharp 生成图像。先解 LZ4再解 DXT大多数纹理的 mipmap 走了两条压缩链路TexMipmapDecompressor按顺序处理// 第一步LZ4 块压缩 if (mipmap.IsLZ4Compressed) { mipmap.Bytes Lz4Decompress(mipmap.Bytes, mipmap.DecompressedBytesCount); mipmap.IsLZ4Compressed false; } // 第二步DXT 块压缩 → 还原为 RGBA8888 case MipmapFormat.CompressedDXT5: mipmap.Bytes DXT.DecompressImage(mipmap.Width, mipmap.Height, mipmap.Bytes, DXTFlags.DXT5); mipmap.Format MipmapFormat.RGBA8888; break;LZ4追求极致速度的压缩算法RePKG 通过K4os.Compression.LZ4库解码。注意解压目标长度是已知的DecompressedBytesCount这是格式逆向时的一个重要发现。DXT1/3/5经典的 GPU 块压缩格式每个 4×4 像素块压缩为 8 或 16 字节。RePKG 没有依赖系统解码器而是在RePKG.Application/Texture/Helpers/DXT.cs里手写了一套完整解压实现——从颜色查找表重建、插值到 Alpha 通道提取这正是它能在 .NET 生态里跨平台工作的原因。最后一步裁到逻辑尺寸转换器拿到解压后的 RGBA 像素后还差一道工序——把 2 次幂对齐的画布裁剪回真实图像尺寸if (sourceMipmap.Width ! tex.Header.ImageWidth || sourceMipmap.Height ! tex.Header.ImageHeight) image.Mutate(x x.Crop(tex.Header.ImageWidth, tex.Header.ImageHeight));如果不做这一步你导出的 PNG 边缘会多出一圈透明或脏像素。这个纹理尺寸 vs 图像尺寸的双轨设计是理解 Wallpaper Engine 贴图体系的关键。四、GIF 动图里的旋转魔法帧信息容器在做什么动态壁纸的动画帧不是逐帧 PNG而是一张图集atlas 一叠帧描述。图集里的每帧可能被旋转、裁剪过帧信息容器FrameInfoContainer记录了每个帧的坐标、宽高、所属图集索引和播放时长。重建 GIF 时最精妙的是旋转计算——作者用一条公式从帧的 Width/HeightX 推算出旋转角度// 假定 Width 或 HeightX 中有一个为 0Height 与 WidthY 同理 var rotationAngle -(Math.Atan2(Math.Sign(height), Math.Sign(width)) - Math.PI / 4); var frame sequenceImages[frameInfo.ImageId].Clone( context context.Crop(new Rectangle((int)x, (int)y, (int)Math.Abs(width), (int)Math.Abs(height))) .Rotate((float)Math.Round(rotationAngle * 180 / Math.PI)));裁剪后再按FrameDelay frameInfo.Frametime * 100设置帧间隔最后移除打底的黑色首帧一个可播放的 GIF 就还原出来了。这段代码是全文最逆向工程的部分——没有文档全靠对引擎内部布局的观察与几何推理。五、从命令行到代码库三种姿势扩展 RePKG工具用熟了下一步是让它为你所用。RePKG 的模块化设计给了三条路。姿势一interactive 交互模式启动后进入 REPL 式命令行逐条输入extract/info指令适合调试与临时探索repkg interactive help extract # 查看 extract 参数说明 extract scene.pkg -o ./out姿势二作为库嵌入你的项目RePKG.Application面向netstandard2.0任何现代 .NET 项目都能引用。核心对象只有三个PackageReader、TexReader.Default、TexToImageConvertervar package new PackageReader().ReadFrom(reader); var tex TexReader.Default.ReadFrom(texReader); var image new TexToImageConverter().ConvertToImage(tex); File.WriteAllBytes(out.png, image.Bytes);姿势三实现自己的格式支持架构上 Core 层几乎全是接口ITexReader、ITexMipmapDecompressor、ITexJsonInfoGenerator……想支持新纹理格式只需实现对应接口并注入到TexReader的构造函数链里完全不用碰命令行代码。这种接口驱动的写法是它从一个小工具长成可扩展框架的根基。六、实战避坑文档没告诉你的细节重复提取不会覆盖默认遇到已存在文件会跳过批处理中断后续跑时这是保护若确认要刷新记得加--overwrite。路径带空格Windows 下务必用双引号包裹路径repkg extract E:\my wallpapers\scene.pkg。GIF 转换只支持 raw 格式源码里明确抛错Only raw mipmap formats are supported遇到压缩格式的动图纹理先解压再转是绕不开的步骤。解压超大壁纸的内存问题所有条目字节会被一次性读进内存PopulateEntriesWithData几十 MB 的包还好巨型素材建议用-e过滤、分批处理。info -t的 TEX 目录模式实现尚不完整对 PKG 的信息转储条目、project.json 元数据、标题过滤非常完善但 TEX 目录批量 dump 在源码中仍是空实现——这是它留给社区的一个贡献点。七、进一步探索到这里你已经走完了命令行实战 → 二进制格式逆向 → 源码级解码管线 → 二次开发的完整闭环。想继续深入可以从这几个方向延伸图像处理转换层基于 SixLabors.ImageSharp阅读它的像素格式与 Gif 编码器理解RG88、R8这类小众格式的像素布局。压缩算法LZ4 与 DXT 是游戏资源领域的常客掌握它们等于掌握了读懂一半游戏贴图的能力。格式逆向方法论RePKG 证明了魔数定位 长度前缀猜测 偏移量推算足以还原一个未知容器这套方法可以迁移到任何游戏资源格式。社区协作TEX 目录信息转储、更多 raw 格式的 GIF 支持都是现成的改进入口——读源码、写测试项目自带RePKG.Tests、提 PR开源贡献不过如此。下次再有人问Wallpaper Engine 的壁纸怎么导出你可以不只是甩出一条命令而是讲清楚它先按偏移量拆出条目再解 LZ4、解 DXT、裁边、拼帧——一个.pkg到一张 PNG 的旅程全程不过几毫秒。【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考