ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

RePKG 实战指南:如何解包 Wallpaper Engine PKG 包并转换 TEX 纹理为图片

RePKG 实战指南:如何解包 Wallpaper Engine PKG 包并转换 TEX 纹理为图片 RePKG 实战指南如何解包 Wallpaper Engine PKG 包并转换 TEX 纹理为图片【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkgRePKG 是一个命令行工具专门做两件事解包 Wallpaper Engine 的 .pkg 包以及把 TEX 纹理转成可看的图片。如果你手上有工坊下载的 .pkg 想拆出内容、想提取纹理做二次创作、或者要批量处理一整个目录的壁纸看这篇就够了如果你只是想在游戏里直接播放壁纸可以跳过。 能力速览解包 .pkg 文件 → 还原包内全部文件纹理、音频、着色器、配置保留包内目录结构解码未压缩 TEX 纹理 → PNG 图片并同步生成 Wallpaper Engine 可直接使用的 .tex-json 元数据解码动态 TEXsprite sheet 序列→ 带旋转、裁剪、帧延迟的动图 GIF用 info 命令列出包内条目的路径与大小 → 不写任何文件纯查看接受目录作为输入 → 批量处理目录下的 .pkg / .tex 三步跑通第一条命令RePKG 编译目标是 .NET Framework 4.7.2Windows 10 自带该运行时可以直接跑Linux/macOS 需要用 Mono。从源码编译git clone https://gitcode.com/gh_mirrors/re/repkg cd repkg dotnet build RePKG.sln -c Release # 产物在 bin/Release/net472/确认程序能正常响应这条命令会列出全部选项等于读了一遍手册RePKG.exe --help输出里能看到extract和info两个子命令说明跑对了。Linux 用户把后面所有示例里的RePKG.exe换成mono RePKG.exe即可。现在解一个包。TEX 条目在解包时会自动转成图片RePKG.exe extract 路径\to\scene.pkg -o ./out # -o 指定输出目录预期输出以Done结尾out目录下能看到解出来的文件就通了。️ 场景实战快速查看包内有什么拿到一个 .pkg 还没把握内容时先用 info 摸底不产生任何输出文件。这条命令列出包内所有条目按大小排序RePKG.exe info scene.pkg -e -s -b size # -e 打印包内条目列表 # -s 排序 # -b size 排序依据name / extension / size预期结果### Package info: scene.pkg Package entries: * 000/bg.tex - 9216000 bytes * 000/scene.png - 183421 bytes进阶如果 .pkg 旁边有 project.json工坊目录里通常都有可以顺带把壁纸的标题、预览等元数据打出来RePKG.exe info scene.pkg -p * --title-filter sunset # -p * 打印 project.json 全部字段--title-filter 只处理标题含 sunset 的包完整解包并自动转换 TEX最常用的路径把包内所有文件拿出来TEX 纹理顺带转成能直接看的图片。这条命令不加任何过滤全量解包RePKG.exe extract scene.pkg -o ./out输出结构保持包内路径每个 TEX 条目会同时得到原始文件、转换图片、元数据三份out/ └── 000/ ├── bg.tex ├── bg.png └── bg.tex-json注意.tex-json这个文件它记录了 format、nomip、nonpoweroftwo、clampuvs 等字段和 Wallpaper Engine 项目里 tex.json 的要求一致。以后要把纹理重新装回项目缺它不行。进阶只想要原始文件、不做转换比如做格式分析加一个参数RePKG.exe extract scene.pkg -o ./out --no-tex-convert转换的具体逻辑包括动态纹理逐帧旋转、裁剪的计算可以看 TEX 转换实现。按扩展名筛选提取包里两三百个文件但你只关心纹理或者想甩掉音频和着色器这些不需要的部分。只提取 .tex 和 .png并拍平到一个目录RePKG.exe extract scene.pkg -e tex,png -s -o ./out # -e 白名单只提取指定扩展名的条目逗号分隔 # -s 拍平到单一目录不保留包内路径预期结果out里直接躺着一堆 .tex/.png 和转换出的图片没有嵌套子目录。反过来用黑名单更省事-i --ignoreexts指定要跳过的扩展名比如-i shd,txt跳过着色器和文本配置。批量解包整个工坊目录Steam 的 workshop content 目录里每个壁纸一个文件夹里面有 .pkg 和 project.json。想一次性把每个壁纸都建成完整项目。递归扫描目录并逐个建项目RePKG.exe extract -r -c -n -o ./projects E:\Games\steamapps\workshop\content\123 # -r 递归扫描所有子目录里的 .pkg # -c 把 pkg 同目录下的 project.json 和预览图一并拷进输出 # -n 用 project.json 里的标题命名项目文件夹而不是数字 ID预期结果./projects下每个壁纸一个以标题命名的文件夹内含 project.json、预览图和全部解包资源可以直接丢进 Wallpaper Editor 打开修改。进阶如果批量只想要纹理、全堆一个目录比如做素材库RePKG.exe extract -r -e tex -s -o ./textures E:\Games\steamapps\workshop\content\123PKG 文件的头、条目表、数据块是怎么解析的见 PKG 解析实现。单独 TEX 与 TEX 目录转换手上已经有不在包里的 .tex 文件要批量变成可看的图。单个 .tex 可以直接当输入传给 extractRePKG.exe extract logo.tex -o ./out这条命令会同时产出logo.png和logo.tex-json。一整个目录用-t模式RePKG.exe extract -t -r 某tex目录 -s -o ./out # -t 目录模式把目录下所有 .tex 转成图片 # -r 递归子目录预期结果每个 .tex 变成一张图和一份 .tex-json动态纹理sprite sheet 序列会被解码成 GIF逐帧的旋转角度、裁剪区域和帧延迟都按帧信息还原。有一个坑要知道当前版本只解码 RGBA8888、R8、RG88 这类未压缩像素格式以及内嵌的图片。如果纹理是 DXT1/3/5 压缩的转换会抛Raw mipmap format must be uncompressed。这种文件不用硬转用--no-tex-convert保留 .tex 原样塞进 Wallpaper Engine 项目即可无损失。⚙️ 参数速查以下参数覆盖了 90% 的使用场景其余保持默认即可。参数作用何时需要调整-o, --output输出目录默认./output每次指定放哪-e, --onlyexts白名单只提取指定扩展名只要纹理/图片时-i, --ignoreexts黑名单跳过指定扩展名要排除音频/着色器/配置时-s, --singledir全部文件拍平到单一目录不需要包内目录结构时-r, --recursive递归扫描子目录输入是嵌套目录时-c, --copyproject拷贝 project.json 与预览图要构建可再编辑的项目时-n, --usename用 project.json 标题命名文件夹配合-c让目录名可读--overwrite覆盖已存在的文件重复提取被跳过机制挡住时info命令的参数少一些-e/--printentries、-s/--sort、-b/--sortby、-p/--projectinfo、--title-filter用法见上面的场景。 排错转换时报 Raw mipmap format must be uncompressed原因纹理使用 DXT1/3/5 压缩当前版本不解码压缩 mipmap。 解法用--no-tex-convert保留 .tex 原样直接放进 Wallpaper Engine 项目使用无损。转换时报 Failed to read texture / Failed to write texture原因该 TEX 的结构不在已知格式范围内较新版本或非标文件。 解法先用info 包.pkg -e确认包内容然后把出问题的 TEX 提交给项目维护者。重复执行 extract输出目录没变化原因默认行为是跳过已存在的文件。 解法加--overwrite。提示 Input file not found原因路径含空格没加引号或路径本身写错。 解法路径用双引号包起来再执行。Linux 下 RePKG.exe 无法启动原因可执行文件目标是 .NET Framework 4.7.2只有 Windows 能直接运行。 解法安装 Mono 后用mono RePKG.exe ...执行或者在 Windows 上构建。RePKG 就是干三件事的工具PKG 解包、TEX 转换、重建可编辑的 Wallpaper Engine 项目结构全部一条命令完成。完整参数列表和更多示例见 README.md想动手改解析逻辑的话入口在 RePKG.Application/。【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表