Руководство

Как пользоваться программой, шаг за шагом.

Сейчас документация есть только на китайском и английском.

ZeroIV User Guide

ZeroIV is a manager for browsing and editing RPF files in GTA V. You can open the game folder or a single RPF file, preview models, textures and XML, and edit resources inside the app itself.

This software has no connection to Rockstar Games. Back up your game files before changing anything.


Requirements

Platform Requirements
Windows Windows 10/11 x64; WebView2 (usually preinstalled)
Linux x86_64; WebKitGTK 4.1 and GTK 3 (pulled in by deb/rpm)

Optional: environment maps (HDRI) download automatically on the first model preview and are cached in the user profile; you can also place your own under assets/ next to the app.


Install

Windows

  1. Extract the release zip (e.g. ZeroIV-*-windows-amd64.zip).
  2. Run ZeroIV.exe.
  3. Optionally create a keys/ folder beside the exe and add gtav_aes_key.dat (see below).

Linux (deb / rpm)

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

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

After install, launch ZeroIV from the app menu, or run:

zeroiv

Linux (portable)

Extract ZeroIV-*-linux-amd64.tar.gz and run the ZeroIV binary inside.


Quick start

  1. Start ZeroIV and complete the language / appearance welcome wizard (changeable later in Settings).
  2. From the top bar, choose:
    • Open folder — any directory that contains .rpf files (game root not required); or
    • Open RPF archive — a single .rpf file.
  3. If the top bar shows No keys, open Settings → Encryption keys before reading encrypted archives.
  4. The app starts read-only. Enable Edit mode in the top bar before saving, importing, or deleting.

UI overview

Area Purpose
Top bar Open / workspace, edit mode, settings, about
Left project tree Workspace, folders, .rpf files, and folders inside archives (including nested RPFs)
Right list Files and folders under the current node; search, sort, drag-out
Preview / editor Textures, models, XML, text, hex, and more

Common tasks

Browse and search

  • Click a tree node to browse it on the right; use breadcrumbs, up, back, and forward.
  • The search box searches the current folder recursively, including nested archives. Double-click a hit to open it, or click the location column to jump there.
  • The right-click menu copies a file name or its full disk path (RPF containers count as folders, one line per item for a multi-selection).

Textures (.ytd)

  • Double-click to open the texture grid; filter and inspect size / mip / format metadata.
  • Double-click a texture for fullscreen preview (wheel zoom, pan, ←/→, Esc).
  • Export one, selected, or all textures as DDS or PNG; switch to the XML view anytime.
  • Import (edit mode): png / jpg / bmp / dds. .dds is stored as-is; other formats can target DXT1 / DXT5 / BC7 / etc., with mipmap options. Same-name textures are replaced in place.

Models (.ydr / .ydd / .yft)

  • Double-click for the built-in 3D viewer; right-click for XML.
  • Attach on-disk .ytd files, change display modes, vehicle lights, and paint / liveries.
  • Vehicle fragments with a companion .ycd (e.g. sentinel2_hi.yft + va_sentinel2.ycd) get an Animation panel: play / reverse / scrub convertible roof, door and boot clips. The dictionary is picked up automatically from the same folder.
  • HDRIs in a sibling assets/ folder are picked up automatically when present.

Other resources and XML

  • Types such as .ymap / .ytyp / .ymt / .ybn / .ycd / .ypt open as XML and can be saved back (edit mode).
  • Export any resource to .xml, or import XML and repack to the matching resource type.
  • Text files are editable; plain .meta / .xml get syntax highlighting; binaries get a hex view.

RPF writes (edit mode)

  • Create RPF (OPEN / NONE / AES / NG), create folders, import, rename, delete.
  • Right-click an RPF to defragment it (edit mode required).
  • Renaming or deleting an RPF closes the archive first, then touches the .rpf on disk.
  • With edit mode off, all write operations stay disabled.

Drag-out and OS integration

  • Drag files from the right list to the desktop or a file manager.
  • Right-click a tree node to reveal it in the system file manager.

Settings

Configure:

  • Language, dark / light / system theme, accent color
  • Whether to enter edit mode on launch
  • Whether to remember and restore previously opened folders
  • GTA V install folder (version detection and key extraction)
  • Encryption key management
  • Gen9 / Enhanced resource layout

Encryption keys

AES / NG encrypted archives need an AES key file (commonly gtav_aes_key.dat).

Lookup order

  1. ./keys/ under the current working directory
  2. keys/ next to the executable
  3. The last directory that successfully loaded keys

Manual load

Settings → Encryption keys → Manage keys:

  • Pick a folder that contains gtav_aes_key.dat; or
  • Pick GTA5.exe / GTA5_Enhanced.exe and let ZeroIV try to extract keys.

FAQ

Encrypted .rpf will not open / “No keys”

Set the correct GTA 5 install folder first. ZeroIV scans the game executable for the encryption key, and only then can it decrypt RPF files.

I cannot save or import; buttons are disabled

The app is read-only by default. Turn on Edit mode in the top bar (the button turns yellow when active).

Enhanced / Gen9 resources look wrong

Enable Gen9 / Enhanced resource layout in Settings, then reopen the folder or archive.

Model preview has no environment lighting

Environment maps download automatically on the first preview and are cached in %LocalAppData%\ZeroIV\envmaps. Offline, put .hdr / .exr / .hdri files in an assets/ folder next to the binary (system install path: /usr/lib/zeroiv/assets/).

Drag-and-drop fails on Linux file managers

For multi-select drag-out, ZeroIV exports a temporary folder instead (WebKitGTK mishandles multi-line file:// lists). Drag one file at a time, or export then copy.

Game breaks after editing an encrypted archive

Writes modify the original file. Back up first. The first NG write can be slow while encryption tables are generated.


Known limitations

  • .ymf / .pso support XML export only (no import yet).
  • When importing texture XML for a .ytd, DDS files are read from a same-named folder beside the XML (e.g. adder.ytd.xml → adder/).
  • Large entries inside archives are extracted to a cache on first drag-out, so the drop target may appear slightly later.
  • Shared vehicle textures (vehshare*, etc.) are indexed only when the workspace is a game install that contains GTA5*.exe.