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 是一款用 C# 编写的命令行工具专门用于解开 Wallpaper Engine 的 PKG 资源包并把其中的 TEX 纹理文件转成常见的图片格式。它适合三类人想查看已订阅壁纸内部结构的使用者、想做二次创作的 Modder以及研究该格式的实现者。典型场景就是拿到一个scene.pkg几秒钟后得到可编辑的图片和project.json工程文件。能力边界RePKG 具体能做什么 它能做的提取单个 PKG 文件或递归扫描整个目录里的所有 PKG将 TEX 纹理转换为 PNG、JPEG、GIF 等图片并附带生成一份.tex-json技术参数文件用-c参数把 PKG 旁边的project.json和预览图一并复制出来凑成一个可编辑的工程目录通过info命令列出包内条目、文件大小或直接读取project.json里的指定字段支持extract、info两个命令另有一个interactive交互模式它不做的没有图形界面所有操作都通过命令行完成不提供反向压缩即不能把普通图片重新打包回 TEX 或 PKG不负责把修改后的内容重新写回壁纸工程这一步需要你在 Wallpaper Engine 里完成最适合的场景快速解开 Workshop 订阅的壁纸包取出素材进行分析或二次创作。最小上手路径准备环境 主程序目标是 .NET Framework 4.7.2所以 Windows 上开箱即用在 Windows 下用dotnet build或msbuild构建都最顺畅Linux 环境需要额外配置框架引用不建议。获取项目git clone https://gitcode.com/gh_mirrors/re/repkg cd repkg构建并首次运行dotnet build RePKG.sln构建成功后在RePKG/bin/Release/下会生成可执行文件。用它解开一个 PKGRePKG\bin\Release\RePKG.exe extract E:\Games\steamapps\workshop\content\123\scene.pkg这步成功后你会看到### Extracting package: ...的提示每个文件一行* Extracting:最后打印Done。默认情况下所有输出进入当前目录的./output文件夹TEX 条目会同时生成原始.tex文件和转换后的图片。验证结果用info命令确认包内条目是否符合预期RePKG\bin\Release\RePKG.exe info -e E:\Games\steamapps\workshop\content\123\scene.pkg输出会列出每个条目的完整路径和字节数方便你判断提取结果是否完整。命令速查按目标选参数extract 命令目标命令说明解出单个 PKGextract scene.pkg输出到./output保持包内目录结构文件全部平铺到一个目录extract -s scene.pkg丢弃原始路径适合快速翻找素材只保留特定类型extract -e png,tex scene.pkg逗号分隔扩展名-i则相反排除生成可编辑工程extract -c -n scene.pkg复制project.json和预览图-n用工程名而非目录 ID 作为子文件夹名批量处理 Workshop 目录extract -r -c 路径递归查找子文件夹中的 PKG 并逐个生成工程只转 TEX 不提取 PKGextract -t 目录把目录里所有.tex文件直接转为图片保留 TEX 原文件不转换extract --no-tex-convert scene.pkg只做原始解压速度最快重复运行覆盖旧结果extract --overwrite scene.pkg默认行为是跳过已存在的文件并打印提示info 命令目标命令按大小查看包内条目info -e -s -b size scene.pkg读取 project.json 的指定字段info -p title,preview scene.pkg*表示全部按标题过滤工程info --title-filter 关键词 目录排查与边界常见失败如何判断⚠️提示Input file not found输入路径不存在或者扩展名既不是.pkg也不是.tex。先确认文件确实在那里再确认路径没有拼写错误如果传的是目录注意目录模式下工具只在子文件夹里找*.pkg根目录直接放的文件不会被扫到。抛出UnknownMagicExceptionUnknown magicTEX 文件头中的标识值不在工具已识别的范围内。判断依据是异常信息里会写明 magic 值和所在文件。可能原因是文件损坏或来自不同版本的壁纸。可以先加-d打开调试信息复跑确认是哪个字段触发的再决定是换文件还是向作者反馈。抛出UnsafeTexException表示解析出的数值明显异常例如条目数量远超正常范围通常是文件损坏。这类文件建议直接放弃或重新下载不必继续排查。输出Failed to read texture或提示不支持的 mipmap 格式转换逻辑目前只支持未压缩的原始像素格式和 GIF 帧压缩格式的 mipmap 无法转成图片。此时.tex原文件仍会被正常解出只是没有对应的图片产物属于已知边界而非报错。进阶用法交互模式运行repkg interactive后进入一个常驻的命令行循环可以连续输入多条extract、info命令而不必每次重新启动程序适合反复调试参数。相关实现在 RePKG/Program.cs 中可以查看。批量工程化把-r、-c、-n组合起来配合 Workshop 内容目录可以把整批壁纸一次性转成「工程名 project.json 预览图 素材」的目录结构后续在 Wallpaper Engine 中逐个打开修改。过滤时用info的--title-filter先确认要处理哪些工程再交给extract执行。下一步如果你打算深入这个项目源码按职责分成四层直接看目录名就能理解RePKG/是命令行入口RePKG.Application/负责 PKG 与 TEX 的读写及图片转换RePKG.Core/定义数据模型和接口RePKG.Tests/存放测试用例。从RePKG.Application/Texture/TexToImageConverter.cs入手能看到 TEX 转图片的完整决策过程。对于普通使用者记住两件事就够了单文件用extract批量用extract -r -c看不懂输出时先用info把包内条目列出来。这两条命令基本覆盖了绝大多数壁纸资源提取需求。【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表