RePKG：Wallpaper Engine资源处理工具完全指南

工具概述

RePKG是一款专为Wallpaper Engine用户设计的开源工具集，采用C#语言开发，提供PKG文件提取与TEX图像转换功能。该工具通过逆向工程解析Wallpaper Engine专用格式，帮助用户轻松管理壁纸资源、提取素材并进行格式转换，适用于壁纸定制、资源分析与二次开发场景。

核心功能模块

PKG文件处理

文件提取

RePKG能够递归解析PKG/MPKG文件结构，提取包含的图像、音频、配置等资源文件。这一功能解决了Wallpaper Engine资源包格式封闭的问题，让用户能够完整释放壁纸资源包内容。

操作示例：

repkg extract -o ./extracted_files ./wallpaper.pkg

项目生成

该工具可以将提取的资源自动组织为Wallpaper Engine项目结构，包含必要的配置文件。通过-c参数启用项目复制功能，能够从PKG文件旁的项目配置文件中获取信息，快速搭建可编辑的壁纸项目。

操作示例：

repkg extract -c -n ./workshop_content ./output_projects

TEX图像转换

格式转换

RePKG支持将Wallpaper Engine专用TEX（Texture）文件转换为PNG等通用图像格式。该功能突破了专用图像格式的限制，实现了专用图像格式与通用格式的兼容。

操作示例：

repkg extract -t -s ./tex_files ./output_images

信息导出

工具能够解析并展示TEX文件的详细信息，包括分辨率、格式、Mipmap层级等技术参数，为资源审计和技术分析提供便利。

操作示例：

repkg info -t ./texture.tex

命令详解

提取命令（extract）

提取命令提供丰富的参数选项，满足不同使用场景：

• -o, --output：指定输出目录，默认为./output
• -i, --ignoreexts：排除指定扩展名的文件，多个扩展名用逗号分隔
• -e, --onlyexts：仅提取指定扩展名的文件
• -d, --debuginfo：在提取/解压过程中打印调试信息
• -t, --tex：将指定目录中的所有TEX文件转换为图像
• -s, --singledir：将所有提取的文件放在单个目录中，忽略其在PKG中的路径
• -r, --recursive：在指定目录的所有子文件夹中递归搜索
• -c, --copyproject：从PKG旁复制project.json和preview.jpg到输出目录
• -n, --usename：使用project.json中的名称作为项目子文件夹名称，而不是ID
• --no-tex-convert：提取PKG时不将TEX文件转换为图像，可显著提升纯资源提取速度
• --overwrite：覆盖所有现有文件

信息命令（info）

信息命令用于查看PKG/TEX文件的详细信息：

• -s, --sort：按字母顺序排序条目
• -b, --sortby：按指定字段排序，可选name、extension、size
• -t, --tex：从指定目录转储所有TEX文件的信息
• -p, --projectinfo：从project.json中转储指定键值，使用逗号分隔，*表示全部
• -e, --printentries：打印包中的条目信息
• --title-filter：标题过滤器

使用场景示例

基础资源提取

最简单的使用方式是直接提取PKG文件并自动转换其中的TEX文件为图像：

repkg extract E:\Games\steamapps\workshop\content\123\scene.pkg

批量项目生成

在指定目录的子文件夹中查找PKG文件，并将其转换为Wallpaper Engine项目：

repkg extract -c E:\Games\steamapps\workshop\content\123

选择性提取

仅提取TEX文件并转换为PNG格式，同时忽略原始路径结构：

repkg extract -e tex -s -o ./output E:\Games\steamapps\workshop\content\123

纯图像转换

将指定文件夹中的所有TEX文件转换为图像：

repkg extract -t -s E:\path\to\dir\with\tex\files

环境配置与使用

项目获取与构建

git clone https://gitcode.com/gh_mirrors/re/repkg
cd repkg
dotnet build RePKG.sln

交互模式

RePKG支持交互式控制台模式，通过以下命令启动：

repkg interactive

在交互模式下，用户可以直接输入命令而不需要每次都指定完整的命令行参数。

常见问题处理

提取失败提示"UnknownMagicException"

这种情况通常是因为遇到了不支持的文件格式或魔数。建议确认文件为Wallpaper Engine正版PKG/TEX格式，或尝试更新至最新版本的工具。

转换的图像出现色彩偏差

如果转换后的图像出现色彩偏差，可能是因为TEX文件使用了特殊的色彩空间或压缩算法。可以添加-d参数启用调试模式重新转换，或在遇到问题时提交附带样本文件的issue。

技术架构

RePKG采用分层架构设计，包含三个主要层次：

• 应用层（RePKG.Application）：实现命令解析与用户交互逻辑
• 核心层（RePKG.Core）：提供格式解析与转换的核心算法
• 接口层：定义统一的数据访问与处理契约

关键技术实现

• 格式解析：基于逆向工程实现的PKG文件格式解析器
• 图像压缩：支持DXT（DirectX Texture Compression）格式编解码
• Mipmap处理：实现多级纹理的生成与解压

总结

RePKG作为一款专业的Wallpaper Engine资源处理工具，通过逆向工程破解了官方的资源封装格式，为用户提供了强大的资源提取和格式转换能力。无论是进行壁纸定制、资源分析还是二次开发，RePKG都能提供可靠的技术支持。