RePKG：Wallpaper Engine资源全能处理工具，让开发者轻松驾驭PKG与TEX文件

RePKG是一款专为Wallpaper Engine设计的开源资源处理工具，采用C#语言编写，能够高效解压PKG资源包并将TEX纹理文件转换为通用图片格式。该工具支持批量处理、格式筛选、元数据提取等强大功能，是游戏开发者和壁纸制作者的得力助手。

核心功能与应用场景

RePKG提供四大核心功能模块，满足不同资源处理需求：

功能模块	核心能力	技术实现	适用场景
PKG提取器	批量解压资源包，支持按扩展名筛选	PackageReader类读取文件结构，Extract命令处理提取逻辑	壁纸资源备份、素材分析
TEX转换器	将专用纹理格式转为通用图片格式	TexToImageConverter类实现格式转换，支持PNG/GIF输出	自定义壁纸制作、纹理编辑
信息查询器	提取文件元数据与格式信息	Info命令解析project.json，输出资源统计数据	资源兼容性检查、格式验证
批量处理器	递归处理目录下所有文件，支持条件过滤	ExtractOptions类提供--recursive参数实现目录遍历	多资源包批量处理

扩展技巧：高级参数组合应用

• 精准筛选：使用--onlyexts参数仅提取特定格式，如repkg extract input.pkg --onlyexts=tex,png只处理纹理和图片文件
• 排除干扰：通过--ignoreexts忽略不需要的格式，如--ignoreexts=json,xml跳过配置文件
• 目录递归：添加-r参数实现嵌套文件夹处理，结合-o指定输出目录：repkg extract ./wallpapers -r -o ./output

技术原理：核心功能实现机制

PKG文件解析工作流程

PKG文件采用自定义二进制格式，解析过程分为三步：

1. 文件头验证：PackageReader读取前4字节"magic"标识，确认是否为有效PKG文件
2. 条目表解析：读取文件偏移量和长度信息，构建PackageEntry对象列表
3. 数据提取：根据偏移量定位文件内容，写入目标目录保持原目录结构

纹理转换格式处理机制

TEX文件转换通过TexToImageConverter类实现，支持两种处理路径：

1. 静态纹理流程：

   • 读取Mipmap层级（默认取最高清层级）
   • 处理像素格式转换（如DXT压缩格式解码）
   • 应用裁剪区域（根据ImageWidth/ImageHeight属性）
   • 输出为PNG格式

2. 动画纹理流程：

   • 识别GIF标志位（IsGif属性）
   • 解析FrameInfoContainer获取序列帧数据
   • 处理旋转与裁剪变换
   • 合成GIF动画并设置帧延迟

环境准备与基础使用

安装要求

1. 安装.NET 6.0运行时：

   # Ubuntu系统
   sudo apt install dotnet-runtime-6.0
   

2. 获取工具并构建：

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

基础命令速查

功能	命令示例	关键参数说明
提取PKG	repkg extract input.pkg -o ./out	-o指定输出目录
TEX转PNG	repkg extract texture.tex --no-tex-convert=false	禁用纹理转换
查看信息	repkg info scene.pkg -p	-p显示文件条目
批量处理	repkg extract ./pkgdir -r --onlyexts=tex	-r递归处理目录

常见问题解答

• Q：转换大型TEX文件时内存溢出？
  A：使用--ignoreexts排除其他格式，或增加系统交换空间

• Q：提取的JSON文件无法解析？
  A：添加--projectinfo=*参数重新提取完整元数据，或使用在线JSON验证工具检查格式

• Q：Linux系统下中文路径乱码？
  A：确保终端使用UTF-8编码：export LANG=en_US.UTF-8后重试

RePKG凭借其开源特性、跨平台支持和强大的功能集，成为处理Wallpaper Engine资源的首选工具。无论是游戏开发者需要分析壁纸资源，还是壁纸制作者希望自定义纹理，RePKG都能提供高效可靠的解决方案。