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
- 解压发布包(如
ZeroIV-*-windows-amd64.zip)。 - 运行
ZeroIV.exe。 - 如需密钥,可在同目录创建
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 可执行文件。
快速开始
- 启动 ZeroIV,按向导选择语言与外观(之后可在设置中修改)。
- 在顶栏打开:
- 打开文件夹:任意含
.rpf的目录(不必是游戏根目录);或 - 打开 RPF 归档:单个
.rpf文件。
- 打开文件夹:任意含
- 若顶栏显示「无密钥」,到 设置 → 加密密钥 加载密钥后再打开加密归档。
- 默认处于只读。需要写入、导入、删除时,先点亮顶栏的 编辑模式。
界面概览
| 区域 | 作用 |
|---|---|
| 顶栏 | 打开 / 工作区、编辑模式、设置、关于 |
| 左侧项目树 | 工作区、文件夹、.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)。
自动查找顺序
- 当前工作目录下的
./keys/ - 可执行文件旁的
keys/ - 上次成功使用的密钥目录
手动加载
设置 → 加密密钥 → 管理密钥:
- 选择含
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的游戏安装目录时从归档索引。