使用说明

软件的使用教程和操作说明。

ZeroIV 使用说明

ZeroIV 是一款用于浏览和编辑 GTA V 游戏 RPF 文件的管理工具。您可以打开游戏目录或者单个 RPF 文件,预览模型、贴图和 XML,也可以直接在软件内编辑并写回资源。

本软件与 Rockstar Games 无任何关系。修改游戏文件前,请先自行备份。


系统要求

平台 要求
Windows Windows 10/11 x64;需可用的 WebView2(一般系统已自带)
Linux x86_64;WebKitGTK 4.1、GTK 3(deb/rpm 会声明依赖)

可选:将 HDRI 放在程序旁的 assets/ 目录,用于模型预览环境光。


安装

Windows

  1. 解压发布包(如 ZeroIV-*-windows-amd64.zip)。
  2. 运行 ZeroIV.exe。
  3. 如需密钥,可在同目录创建 keys/ 并放入 gtav_aes_key.dat(见下文)。

Linux(deb / rpm)

# Fedora / RHEL 等
sudo dnf install ./zeroiv-*-*.rpm

# Debian / Ubuntu 等
sudo apt install ./zeroiv_*_*.deb

安装后可在应用菜单启动 ZeroIV,或在终端运行:

zeroiv

Linux(便携包)

解压 ZeroIV-*-linux-amd64.tar.gz,运行其中的 ZeroIV 可执行文件。


快速开始

  1. 启动 ZeroIV,按向导选择语言与外观(之后可在设置中修改)。
  2. 在顶栏打开:
    • 打开文件夹:任意含 .rpf 的目录(不必是游戏根目录);或
    • 打开 RPF 归档:单个 .rpf 文件。
  3. 若顶栏显示「无密钥」,到 设置 → 加密密钥 加载密钥后再打开加密归档。
  4. 默认处于只读。需要写入、导入、删除时,先点亮顶栏的 编辑模式。

界面概览

区域 作用
顶栏 打开 / 工作区、编辑模式、设置、关于
左侧项目树 工作区、文件夹、.rpf 及归档内目录(含嵌套归档)
右侧列表 当前节点下的文件与文件夹;支持搜索、排序、拖出
预览 / 编辑器 贴图、模型、XML、文本、Hex 等

常用操作

浏览与搜索

  • 单击树节点切换右侧内容;支持面包屑、上级、后退 / 前进。
  • 右侧搜索框会递归搜索当前目录及其子目录、子归档;可双击结果打开,或点击位置列跳转。
  • 右键菜单可复制文件名或完整磁盘路径(RPF 视作目录,多选时每行一条)。

贴图(.ytd)

  • 双击打开贴图网格;可筛选、查看尺寸 / Mip / 格式等信息。
  • 双击贴图进入全屏预览(滚轮缩放、拖动平移、←/→ 切换、Esc 关闭)。
  • 可导出单张 / 选中 / 全部为 DDS 或 PNG;也可切换到 XML 视图。
  • 导入(需编辑模式):支持 png / jpg / bmp / dds。.dds 原样写入;其他格式可选 DXT1 / DXT5 / BC7 等,并可配置 mipmap。同名贴图会原位覆盖。

模型(.ydr / .ydd / .yft)

  • 双击打开内嵌 3D 预览;右键可查看 XML。
  • 可附加磁盘上的 .ytd、切换显示模式、载具灯光、喷漆 / 涂装。
  • 载具模型若存在同目录的 .ycd(例如 sentinel2_hi.yft + va_sentinel2.ycd),预览器会出现「载具动画」面板:可播放 / 反向 / 拖动进度,查看敞篷、车门、后备箱等动画。动画字典会自动从同目录识别。
  • 首次预览模型时会自动下载环境贴图(HDRI),缓存于用户目录;也可自行放入程序旁的 assets/ 目录。

其他资源与 XML

  • .ymap / .ytyp / .ymt / .ybn / .ycd / .ypt 等以 XML 打开,可编辑后写回(需编辑模式)。
  • 任意资源可导出为 .xml,也可将 XML 导入并打包为对应资源类型。
  • 文本类可编辑;纯文本 .meta / .xml 带语法高亮;二进制提供 Hex 预览。

RPF 写入(需编辑模式)

  • 新建 RPF(OPEN / NONE / AES / NG)、新建文件夹、导入文件、重命名、删除。
  • 在 RPF 上右键可执行「碎片整理」(需编辑模式)。
  • 重命名 / 删除 RPF 时,会先关闭该归档,再改动磁盘上的 .rpf 文件。
  • 关闭编辑模式时,上述写入类操作全部禁用,避免误改游戏文件。

拖出与系统集成

  • 可将右侧列表中的文件拖到桌面或文件管理器。
  • 树节点右键可「在系统资源管理器中显示」。

设置

在 设置 中可配置:

  • 语言、深色 / 浅色 / 跟随系统、强调色
  • 启动时是否自动进入编辑模式
  • 是否记住并恢复上次打开的文件夹
  • GTA V 安装目录(用于检测版本与提取密钥)
  • 加密密钥管理
  • Gen9 / Enhanced 资源布局开关

加密密钥

读取 AES / NG 加密归档需要 AES 密钥(常见文件名为 gtav_aes_key.dat)。

自动查找顺序

  1. 当前工作目录下的 ./keys/
  2. 可执行文件旁的 keys/
  3. 上次成功使用的密钥目录

手动加载

设置 → 加密密钥 → 管理密钥:

  • 选择含 gtav_aes_key.dat 的目录;或
  • 选择 GTA5.exe / GTA5_Enhanced.exe,由程序尝试提取。

常见问题

打不开加密的 .rpf / 提示无密钥

请先配置正确的 GTA5 安装目录,软件会自动从游戏 EXE 中扫描加密秘钥,得到秘钥后才能解密 RPF 文件。

改不了文件、导入按钮是灰的

默认只读。请先开启顶栏 编辑模式(开启后按钮显示为黄色)。

Enhanced / Gen9 资源显示异常

在设置中打开 Gen9 / Enhanced 资源布局,再重新打开对应目录或归档。

模型预览没有环境光 / HDRI

环境贴图会在首次预览时自动下载并缓存(%LocalAppData%\ZeroIV\envmaps)。若网络不可用,可手动将 .hdr / .exr / .hdri 放到程序同级的 assets/ 目录(系统安装时为 /usr/lib/zeroiv/assets/)。

拖到 Linux 文件管理器失败 / 提示路径不存在

多选拖出时,程序会改为拖出一个暂存文件夹(WebKitGTK 对多行 file:// 列表处理有缺陷)。可改为逐个拖出,或先导出再复制。

修改加密归档后游戏异常

写入会直接改原文件。请先备份;NG 加密首次写入可能较慢(需生成加密表)。


已知限制

  • .ymf / .pso 目前仅支持导出 XML,不支持导入。
  • 含贴图的 .ytd 做 XML 导入时,会从同目录同名文件夹读取 DDS(例如 adder.ytd.xml → adder/)。
  • 归档内大文件首次拖出时,需先解压到缓存,落点可能稍有延迟。
  • 共享载具贴图(vehshare* 等)仅在打开含 GTA5*.exe 的游戏安装目录时从归档索引。