RePKG工具完整使用指南：轻松提取Wallpaper Engine资源

RePKG是一款专为Wallpaper Engine设计的免费开源工具，能够快速提取PKG资源包并将TEX格式转换为常见图片格式。无论是制作个性化壁纸还是备份素材资源，这款工具都能帮你轻松完成任务，让创意实现变得简单高效。

工具概述

RePKG是基于C#开发的轻量级命令行实用程序，主要特色包括：

• 快速解压Wallpaper Engine的PKG资源文件
• 将TEX纹理格式批量转换为PNG/JPG等通用图片
• 支持多文件同时处理
• 完全开源免费使用

环境准备与安装

系统配置要求

• 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文件夹中找到RePKG.exe

基础操作指南

提取PKG文件

repkg extract -o 输出目录 你的文件.pkg

转换TEX文件

repkg extract -t -s 你的文件.tex

命令详解

extract命令选项

• -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命令选项

• -s, --sort - 按字母顺序排序条目
• -b, --sortby - 排序依据（默认：name，可用选项：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

批量转换示例

在指定目录的子文件夹中查找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

高级应用技巧

批量自动化处理

创建批处理脚本实现多文件一键处理：

for %f in (*.pkg) do repkg extract -o output "%f"

图形界面替代方案

对于偏好可视化操作的用户，可以选用基于RePKG开发的图形界面版本，简化操作步骤。

重要使用说明

• 仅限处理个人拥有或已获授权的文件
• 核心代码模块位于RePKG.Core/文件夹
• 纹理处理功能在RePKG.Application/Texture/目录
• 项目采用反向工程方式解析PKG和TEX格式

常见疑难解答

Q: 运行时报错提示依赖缺失？
A: 请确认已正确安装.NET Framework 4.6.1或更新版本

Q: 转换后的图片显示不正常？
A: 尝试更新工具至最新版本，或检查TEX文件是否完整

Q: 如何获取更多帮助信息？
A: 使用repkg help命令查看所有可用命令，或使用repkg help "extract"和repkg help "info"查看具体选项

通过本指南，你已经全面掌握了RePKG的实用方法。这款高效工具将助你充分释放Wallpaper Engine的创作潜能，立即开启你的壁纸定制探索之旅吧！