如何用 RePKG 提取 Wallpaper Engine 壁纸包：PKG 解包与 TEX 转图片指南

如何用 RePKG 提取 Wallpaper Engine 壁纸包：PKG 解包与 TEX 转图片指南

【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg

RePKG 是一款用 C# 编写的命令行工具，核心功能就两件事：把 Wallpaper Engine 的 PKG 打包文件解开，把其中的 TEX 纹理转成常见图片格式。它适合两类人：想把成品壁纸里的素材拿出来的普通用户，以及想基于现有壁纸做二次开发的创作者。

三分钟上手体验

先说前提：机器上需要装好 .NET 环境（运行dotnet --version能出版本号即可），再准备一个 PKG 文件——从 Steam 创意工坊下载的壁纸包里就有。

下面这条命令负责克隆源码并编译出可执行文件，编译完成工具就可用了：

git clone https://gitcode.com/gh_mirrors/re/repkg && cd repkg && dotnet build -c Release

再用一条最短的命令跑通第一次解包，把当前目录里的 scene.pkg 解到 ./output：

dotnet run --project RePKG -- extract -o ./output scene.pkg

终端打印 Done 后，打开 ./output 就能看到解出来的文件；TEX 条目除了原文件，还会多出一份同名的图片文件。

什么情况下用它

你遇到的问题	RePKG 能做到的
PKG 是打包格式，资源藏在里面看不到	按包内原始目录结构解包，TEX 条目同时转成可直接打开的图片
拿到的 TEX 文件用任何看图工具都打不开	转成 PNG 图片，并附带 .tex-json 文件，记录分辨率、纹理格式等参数
想基于现有壁纸二次开发，却只有成品没有工程	用 -c 参数把 project.json 和预览图一起复制出来，还原成可编辑的壁纸工程目录
解包前想先确认包里有什么	用 info 命令列出包内全部条目和大小，不向磁盘写任何文件

RePKG 核心命令速查

命令/参数	作用	适用场景
extract <输入>	解包 PKG 或转换 TEX，输入可以是单个文件，也可以是目录	最常用，日常提取都从它开始
-o <目录>	指定输出目录，默认 ./output	把结果放到指定位置
-e <扩展名>	只提取指定扩展名的文件，多个用逗号分隔	只要图片和音频，跳过其他资源
-s	所有文件平铺到一个目录，不按包内路径分文件夹	只想快速把素材捞出来时
-c / -n	复制 PKG 同目录的 project.json 和预览图；-n 用工程名作为子文件夹名	把壁纸包还原成可编辑工程
-r	递归搜索输入目录所有子文件夹里的 PKG 或 TEX	一次性处理整个创意工坊内容目录
--no-tex-convert	提取时跳过 TEX 转图片	只留原始文件，当纯备份用
info -e <输入>	列出包内的文件条目和大小	提取前先摸清包内内容

一次真实完整操作

以"把一个工坊壁纸包还原成可编辑工程"为例，完整走一遍。

起步：确认 PKG 所在目录里有 project.json 和 preview.jpg，工坊下载的默认结构就是这样。如果缺少 project.json，-c 和 -n 就没有意义，只能当普通解包处理。

执行：对目录而不是单个文件运行解包命令，加上 -c -n -r，工具会递归找到所有 PKG，为每个包建一个以工程命名的子文件夹，资源、project.json、预览图全部落进去：

dotnet run --project RePKG -- extract -c -n -r -o ./projects E:\workshop\content\123

验证：打开 ./projects，每个子文件夹就是一份能直接塞回 Wallpaper Engine 工程目录的完整工程。抽查任一图片，同名 .tex-json 里写着分辨率和格式，和原壁纸对得上即说明转换无误。如果只想核对而不落盘，把 extract 换成 info -e 再跑一次，终端会逐条列出包内文件。

常见坑与处理

现象：终端报 "Unknown magic: 'xxxx' in 'xxx.tex'"。 原因：该 TEX 的文件头与工具已验证的格式对不上，可能是较新的纹理版本，也可能是文件本身不完整。 处理：先换一个已知正常的 PKG 验证工具本身没问题，再确认这个文件是否完整；确认无误后把报错信息和样本文件反馈给项目维护者，暂时可用 --no-tex-convert 把原始 TEX 留下来备用。

现象：提示 "Input file not found"，但文件明明就在那。 原因：路径写法有误，最常见的是路径含空格却没加引号。 处理：给整条路径加上双引号，或者直接拖拽文件进终端，让路径自动补全。

现象：第二次运行时输出全是 "Skipping, already exists"，文件没有更新。 原因：默认不覆盖已存在的文件，这是防误删的保护。 处理：确认要覆盖时加 --overwrite 重跑即可。

进阶技巧

• 批量出图时，extract -t -s指向一个放满 TEX 的目录，可以一次性把所有纹理转成图片并平铺保存。
• 启动时加 interactive 参数进入交互模式，可以逐条敲 extract 和 info 命令，适合边看结果边决定下一步提取什么。
• 大目录提取前先跑一遍 info 摸清体量，再决定要不要用 -e 过滤，能省不少磁盘空间。

RePKG 的价值在于把"打包格式 + 私有纹理格式"这两道墙一次拆掉：解包、转图、还原工程，都是同一套参数组合的事。现在就可以把文中第一条命令跑一遍，拿一个手头的 PKG 文件验证 ./output 里的产物是否符合预期。

【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg