WzComparerR2 冒险岛WZ提取器终极使用教程：从新手到高手完整指南

WzComparerR2是一款功能强大的冒险岛WZ文件提取器，专为《冒险岛》游戏玩家和爱好者设计。本指南将带你全面了解这个工具的核心功能和使用方法，让你轻松掌握装备模拟、地图查看、数据提取等实用功能。🎮

WzComparerR2主界面预览

📋 核心功能模块详解

1. 主程序模块 (WzComparerR2/)

主程序是整个工具的核心，负责WZ文件的读取、解析和显示。通过MainForm.cs实现的用户界面，你可以：

• 浏览WZ文件目录结构
• 查看各种游戏资源（图片、音频、视频）
• 进行文件比较和搜索

2. 通用功能模块 (WzComparerR2.Common/)

这个模块包含了所有共享的基础功能：

• 动画处理（FrameAnimationData.cs）
• 图形渲染（GraphicsDeviceControl.cs）
• GIF生成（Gif.cs, GifFrame.cs）
• 进度对话框（FrmProgressDialog.cs）

3. WZ文件处理库 (WzComparerR2.WzLib/)

专门负责WZ文件的解密和读取：

• 支持多种加密算法（ChaCha20CryptoTransform.cs）
• WZ文件结构解析（Wz_File.cs, Wz_Image.cs）
• 数据流处理（WzBinaryReader.cs）

🚀 快速开始使用指南

系统要求

• 操作系统: Windows 7 SP1 或更高版本
• 运行环境: .NET Framework 4.6.2+
• 图形支持: DirectX 11.0

安装步骤

1. 克隆项目仓库：

git clone --recurse-submodules -j8 https://gitcode.com/gh_mirrors/wz/WzComparerR2

2. 使用Visual Studio 2022打开解决方案文件 WzComparerR2.sln

3. 编译并运行项目

🎯 实用功能操作教程

装备模拟功能

通过CharaSimControl模块，你可以：

• 查看装备属性详情（GearTooltipRender.cs）
• 模拟装备搭配效果
• 生成装备预览图

装备模拟界面

地图查看器

MapRender模块提供完整的地图浏览功能：

• 3D地图渲染（MapScene.cs）
• 迷你地图显示（MiniMap.cs）
• 光照效果（LightRenderer.cs）

Lua控制台

LuaConsole模块允许你：

• 执行自定义Lua脚本
• 自动化数据提取任务
• 批量处理WZ文件

⚙️ 配置与优化技巧

插件管理

通过PluginBase模块，你可以：

• 加载和管理扩展插件
• 自定义功能模块
• 扩展工具能力

性能优化

• 使用64位版本获得更好的内存管理
• 调整缓存设置优化加载速度
• 合理配置线程数量

🔧 故障排除与常见问题

常见错误解决

• 缺少DLL文件: 确保References目录下的所有依赖库都存在
• 运行崩溃: 检查.NET Framework版本是否为4.6.2或更高
• 显示异常: 更新显卡驱动至最新版本

日志查看

程序会在运行目录生成error.log文件，包含详细的错误信息，便于排查问题。

📊 资源文件类型支持

WzComparerR2支持多种游戏资源格式：

• PNG图标 PNG图像文件
• MP3图标 MP3音频文件
• 视频图标 视频文件
• 文本数据文件

🎮 高级使用技巧

批量处理

利用脚本功能实现：

• 批量导出特定类型的资源
• 自动化数据比较
• 定期备份WZ文件

自定义扩展

通过插件系统：

• 添加新的文件格式支持
• 开发专属功能模块
• 集成外部工具

📝 更新与维护

项目目前处于深度维护状态，主要修复关键bug和适应WZ文件格式变化。建议定期检查更新以获取最新功能和支持。

---

通过本指南，你应该已经对WzComparerR2有了全面的了解。这个强大的冒险岛WZ提取器将为你的游戏研究和数据提取工作提供极大的便利。记得在使用前备份重要数据，享受探索游戏资源的乐趣！✨