RePKG：Wallpaper Engine资源提取与转换工具完整指南

RePKG是一款专为Wallpaper Engine设计的免费开源工具，能够轻松提取PKG文件并将TEX格式转换为常见图像格式。无论是自定义壁纸制作还是资源备份，这款工具都能帮你高效完成任务，让壁纸创作变得简单便捷。

工具概述

RePKG是基于C#开发的轻量级命令行工具，具备以下核心功能：

• 提取Wallpaper Engine的PKG资源包
• 将PKG转换为Wallpaper Engine项目格式
• 将TEX纹理文件转换为PNG/JPG等图像格式
• 支持批量处理多个文件
• 提供PKG/TEX信息转储功能

环境准备

系统要求

• Windows 7及以上操作系统
• .NET Framework 4.6.1或更高版本

获取与编译

1. 下载源代码

打开命令提示符，执行以下命令获取项目：

git clone https://gitcode.com/gh_mirrors/re/repkg

2. 构建应用程序

1. 使用Visual Studio打开RePKG.sln解决方案文件
2. 选择"生成" → "生成解决方案"
3. 编译完成后，在RePKG/bin/Debug目录中找到可执行文件

核心命令详解

extract命令

提取指定的PKG/TEX文件或文件夹中的文件

repkg extract 文件路径.pkg

主要选项：

• -o, --output：输出目录（默认：./output）
• -i, --ignoreexts：忽略指定扩展名的文件（用逗号分隔）
• -e, --onlyexts：仅提取指定扩展名的文件（用逗号分隔）
• -d, --debuginfo：提取/反编译时打印调试信息
• -t, --tex：将指定输入目录中的所有TEX文件转换为图像
• -s, --singledir：将所有提取的文件放在一个目录中，而不是它们的入口路径
• -r, --recursive：在指定目录的所有子文件夹中递归搜索
• -c, --copyproject：将PKG旁边的project.json和preview.jpg复制到输出目录
• -n, --usename：使用project.json中的名称作为项目子文件夹名称，而不是ID
• --no-tex-convert：提取PKG时不将TEX文件转换为图像
• --overwrite：覆盖所有现有文件

info命令

转储PKG/TEX信息

repkg info 文件路径

主要选项：

• -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转换

在指定目录的子文件夹中查找PKG文件，仅将TEX条目转换为png，然后将它们放在./output中，忽略它们在PKG中的路径：

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

纯TEX文件转换

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

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

项目架构说明

核心模块结构

• RePKG.Core/：包含基础数据模型和接口定义
  • Package/：包处理相关类和枚举
  • Texture/：纹理处理相关组件
• RePKG.Application/：实现具体的业务逻辑
  • Package/：包读写器实现
  • Texture/：纹理转换和处理组件
• RePKG/：命令行接口和程序入口

常见问题解决

问题：运行时提示缺少依赖？ 解决方案：确认已正确安装.NET Framework 4.6.1或更高版本

问题：转换后的图片显示异常？ 解决方案：尝试更新工具到最新版本，或检查TEX文件是否损坏

问题：如何处理特定类型的文件？ 解决方案：使用-e参数仅提取特定扩展名的文件，或使用-i参数忽略不需要的文件类型

使用注意事项

• 仅限于处理个人拥有或获得授权的文件
• 建议在操作前备份原始文件
• 对于复杂的壁纸项目，可能需要多次尝试不同的提取选项

通过本指南，你已经全面掌握了RePKG工具的使用方法。这款强大的工具能够帮助你解锁Wallpaper Engine的创意潜力，无论是资源提取、格式转换还是项目创建，都能轻松应对。开始你的壁纸定制之旅，释放无限创意！