Difference between revisions of "RPF archive"
| (22 intermediate revisions by 9 users not shown) | |||
| Line 1: | Line 1: | ||
| − | '''RPF''' (''' | + | '''RPF''' ('''Rockstar Pack File''') is the format of [[Archive|game archive]]s used in [[RAGE Engine]]. They can be edited with [[SparkIV]] or [[OpenIV]]. |
| + | [[File:Rockstar_RPF_Viewer.png|right|thumb|300px|The internal software used by Rockstar to view these files]] | ||
| − | ==Header== | + | |
| − | The RPF | + | ==RPF Versions== |
| + | The RPF Version tells us the version of the RPF Archive: | ||
| + | Version 0: 0x52504630 - Rockstar Games Presents Table Tennis | ||
| + | Version 2: 0x52504632 - Grand Theft Auto IV | ||
| + | Version 3: 0x52504633 - Grand Theft Auto IV Audio & Midnight Club: Los Angeles | ||
| + | Version 4: 0x52504634 - Max Payne 3 | ||
| + | Version 6: 0x52504636 - Red Dead Redemption | ||
| + | Version 7: 0x52504637 - Grand Theft Auto V | ||
| + | Version 8: 0x52504638 - Red Dead Redemption 2 | ||
| + | |||
| + | ==RPF Version 0== | ||
| + | |||
| + | ===Header=== | ||
| + | The RPF files all contain the same header. The header tells us the version of the archive and how many entries there are. | ||
| + | |||
| + | 4b - INT32 - RPF Version | ||
| + | 4b - INT32 - Table of Contents Size (in bytes) | ||
| + | 4b - INT32 - Number of Entries (root entry '/' included) | ||
| + | |||
| + | The Table of Contents Size tells us the size of the table of contents (toc) segment in the file. | ||
| + | The Number of Entries tells us the number of files contained in the archive. | ||
| + | |||
| + | ===Table of Contents=== | ||
| + | The Table of contents size is determined by the header of the RPF archive. It starts after 2048 bytes from the file origin. The Table of contents contains both Directories and File Entries. One entry takes up 16 bytes. The minimum toc size is 2048 bytes. | ||
| + | |||
| + | ====Directory Entry==== | ||
| + | Directory entries follow this structure: | ||
| + | |||
| + | 3b - INT24 - Name Offset | ||
| + | 1b - bool - Entry type ("80" if it is a directory / 0 if it is a file) | ||
| + | 4b - UINT32 - First toc filesystem-entry entry Index in the directory (zero-based) | ||
| + | 4b - UINT32 - Count of filesystem-entries in the directory | ||
| + | 4b - UINT32 - Count of filesystem-entries in the directory (identical, probably to keep the structure to 16 bytes per entry) | ||
| + | |||
| + | Name offset: Stores the offset of the first char of the name of the filesystem-entry within the filename-section. | ||
| + | First toc filesystem-entry entry Index in the directory: Folders can contain either other folders or files. Here the offset of the first object within the directory is stored. | ||
| + | |||
| + | ====File Entry==== | ||
| + | The File entries follow this structure: | ||
| + | |||
| + | 3b - INT24 - Name Offset | ||
| + | 1b - bool - Entry type ("80" if it is a directory / 0 if it is a file) | ||
| + | 4b - INT32 - Offset (zero-based) | ||
| + | 4b - INT32 - Size (bytes) | ||
| + | 4b - INT32 - Uncompressed size (bytes) | ||
| + | |||
| + | Name offset: Stores the offset of the first char of the name of the filesystem-entry within the filename-section. | ||
| + | Offset: Offset of the data of the file within the RPF (zero-based). | ||
| + | Size: Size of the file within the RPF (compressed) | ||
| + | Uncompressed size: Size of the file after decompression | ||
| + | |||
| + | Note that the file is stored uncompressed within the RPF if Size equals the Uncompressed size. | ||
| + | The files are always compressed using zlib without a deflate header. | ||
| + | |||
| + | ==Filename-Section== | ||
| + | The name section starts after 2048+(16*number of toc entries) bytes. The file names are seperated with "00". | ||
| + | |||
| + | ===Tools=== | ||
| + | The following tools can be used to import & export files into RPF archives. | ||
| + | * [[OpenIV]] | ||
| + | * [[SparkIV]] | ||
| + | * [https://www.gta5-mods.com/tools/codewalker-gtav-interactive-3d-map CodeWalker] | ||
| + | |||
| + | ==RPF Version 2== | ||
| + | |||
| + | ===Header=== | ||
| + | The RPF files all contain the same header. The header tells us the version of the archive, how many entries there are and whether or not the archive is encrypted. | ||
4b - INT32 - RPF Version | 4b - INT32 - RPF Version | ||
| Line 10: | Line 77: | ||
4b - INT32 - Encrypted | 4b - INT32 - Encrypted | ||
| − | |||
The Table of Contents Size tells us the size of the table of contents segment in the file. | The Table of Contents Size tells us the size of the table of contents segment in the file. | ||
The Number of Entries tells us the number of files contained in the archive. | The Number of Entries tells us the number of files contained in the archive. | ||
| − | The Encryption flag tells us if the archive is encrypted, if the archive is unencrypted it is set to 0 | + | The Encryption flag tells us if the archive is encrypted, if the archive is unencrypted it is set to 0, otherwise it is non-zero. |
| − | ==Table of Contents== | + | ===Table of Contents=== |
The Table of contents size is determined by the Table of Contents Size integer in the Header of the RPF archive. It starts after 2048 bytes from the file origin, and is encrypted depending on the encryption flag in the header. The Table of contents contains both Directories and File Entries. Both are different structures and take up different amounts of space. | The Table of contents size is determined by the Table of Contents Size integer in the Header of the RPF archive. It starts after 2048 bytes from the file origin, and is encrypted depending on the encryption flag in the header. The Table of contents contains both Directories and File Entries. Both are different structures and take up different amounts of space. | ||
| − | ===Directory Entry=== | + | ====Directory Entry==== |
Directory entries follow this structure: | Directory entries follow this structure: | ||
| Line 31: | Line 97: | ||
The Content Entry Count describes how many entries are under this directory, and is generally defined in the first 4 bits of the unsigned integer. | The Content Entry Count describes how many entries are under this directory, and is generally defined in the first 4 bits of the unsigned integer. | ||
| − | ===File Entry=== | + | ====File Entry==== |
The File entries follow this structure: | The File entries follow this structure: | ||
| Line 48: | Line 114: | ||
{{Incomplete}} | {{Incomplete}} | ||
| − | ==Tools== | + | ===Tools=== |
The following tools can be used to import & export files into RPF archives. | The following tools can be used to import & export files into RPF archives. | ||
| − | * | + | * [[OpenIV]] |
| − | * | + | * [[SparkIV]] |
| − | {{ | + | {{N|5|4}} |
Latest revision as of 22:11, 2 March 2024
RPF (Rockstar Pack File) is the format of game archives used in RAGE Engine. They can be edited with SparkIV or OpenIV.
Contents
RPF Versions
The RPF Version tells us the version of the RPF Archive:
Version 0: 0x52504630 - Rockstar Games Presents Table Tennis Version 2: 0x52504632 - Grand Theft Auto IV Version 3: 0x52504633 - Grand Theft Auto IV Audio & Midnight Club: Los Angeles Version 4: 0x52504634 - Max Payne 3 Version 6: 0x52504636 - Red Dead Redemption Version 7: 0x52504637 - Grand Theft Auto V Version 8: 0x52504638 - Red Dead Redemption 2
RPF Version 0
Header
The RPF files all contain the same header. The header tells us the version of the archive and how many entries there are.
4b - INT32 - RPF Version 4b - INT32 - Table of Contents Size (in bytes) 4b - INT32 - Number of Entries (root entry '/' included)
The Table of Contents Size tells us the size of the table of contents (toc) segment in the file. The Number of Entries tells us the number of files contained in the archive.
Table of Contents
The Table of contents size is determined by the header of the RPF archive. It starts after 2048 bytes from the file origin. The Table of contents contains both Directories and File Entries. One entry takes up 16 bytes. The minimum toc size is 2048 bytes.
Directory Entry
Directory entries follow this structure:
3b - INT24 - Name Offset
1b - bool - Entry type ("80" if it is a directory / 0 if it is a file)
4b - UINT32 - First toc filesystem-entry entry Index in the directory (zero-based)
4b - UINT32 - Count of filesystem-entries in the directory
4b - UINT32 - Count of filesystem-entries in the directory (identical, probably to keep the structure to 16 bytes per entry)
Name offset: Stores the offset of the first char of the name of the filesystem-entry within the filename-section. First toc filesystem-entry entry Index in the directory: Folders can contain either other folders or files. Here the offset of the first object within the directory is stored.
File Entry
The File entries follow this structure:
3b - INT24 - Name Offset
1b - bool - Entry type ("80" if it is a directory / 0 if it is a file)
4b - INT32 - Offset (zero-based)
4b - INT32 - Size (bytes)
4b - INT32 - Uncompressed size (bytes)
Name offset: Stores the offset of the first char of the name of the filesystem-entry within the filename-section. Offset: Offset of the data of the file within the RPF (zero-based). Size: Size of the file within the RPF (compressed) Uncompressed size: Size of the file after decompression
Note that the file is stored uncompressed within the RPF if Size equals the Uncompressed size. The files are always compressed using zlib without a deflate header.
Filename-Section
The name section starts after 2048+(16*number of toc entries) bytes. The file names are seperated with "00".
Tools
The following tools can be used to import & export files into RPF archives.
RPF Version 2
Header
The RPF files all contain the same header. The header tells us the version of the archive, how many entries there are and whether or not the archive is encrypted.
4b - INT32 - RPF Version 4b - INT32 - Table of Contents Size 4b - INT32 - Number of Entries 4b - INT32 - Unknown 4b - INT32 - Encrypted
The Table of Contents Size tells us the size of the table of contents segment in the file. The Number of Entries tells us the number of files contained in the archive. The Encryption flag tells us if the archive is encrypted, if the archive is unencrypted it is set to 0, otherwise it is non-zero.
Table of Contents
The Table of contents size is determined by the Table of Contents Size integer in the Header of the RPF archive. It starts after 2048 bytes from the file origin, and is encrypted depending on the encryption flag in the header. The Table of contents contains both Directories and File Entries. Both are different structures and take up different amounts of space.
Directory Entry
Directory entries follow this structure:
4b - INT32 - Name Offset 4b - INT32 - Flags 4b - UINT32 - Content Entry Index 4b - UINT32 - Content Entry Count
The Name Offset refers to the file offset that stores the name of the directory. The Flags just give information about the directory. The Content Entry Index is generally described in the first bit of the unsigned integer. The Content Entry Count describes how many entries are under this directory, and is generally defined in the first 4 bits of the unsigned integer.
File Entry
The File entries follow this structure:
4b - INT32 - Name Offset 4b - INT32 - Size 3b - UINT24 - Offset 1b - UCHAR8 - Resource Type 4b - UINT32 - Flags
The Name Offset refers to the file offset that stores the name of the file. The Size tells us the size of the file. The Offset tells us the file offset the file is stored in. The Resource Type tells us the type of resource that the file is. In the resource flag, the first bit tells us whether the file is compressed or not.
This section is incomplete. You can help by fixing and expanding it.
Tools
The following tools can be used to import & export files into RPF archives.
 Grand Theft Auto V | |
|---|---|
| File Formats | .awc • .dat • .gfx • .gxt2 • .ide • .meta/.ymt/.xml • .mrf • .patch • .rpf • .ybn/.ybd • .ycd • .ydd • .ydr • .yed • .yfd • .yft • .yld • .ymap • .ymf • .ynd • .ynv • .ypdb • .ysc • .ytd • .ytyp • .yvr |
| Documentation | Bink Video • Native functions • Weather types |
| Tools | OpenIV • GIMS Evo • CodeWalker |
| Multiplayer |  GTAForums: GTA Online |
| Useful links | Community portal • Discussion forums • GTA V Modding Forum • GTA5-Mods • Native Functions Database (alloc8or) |
 Grand Theft Auto IV | |
|---|---|
| File Formats | .dat • .gxt • .ide • .img • .ipl • .nod • .sco • .rpf • .rrr • .wad • .wbd/.wbn • .wdd • .wdr • .wft • .whm • .wpl • .wtd |
| Documentation | Audio • Bink Video • Cryptography • Cutscenes • GXT Text • Image listing • Keycodes • Map Listing • Native functions • Paths • Radar Blips • Radio Stations • Saves • Scenarios • VTable • Weapons |
| Tools | ASI Loader • ENBSeries • G-Texture • GIMS IV • Ingame WPL Editor • IV Needle • OpenIV • SparkIV • XLiveLess • WPL Manager • X Mod Installer Alice • C++ Script Hook • .NET Script Hook • Scocl |
| Tutorials | Importing Textures with OpenIV • Importing Textures with SparkIV |
| Modifications | GTA Connected • Gostown IV • Four Multiplayer • IV Multiplayer • CitizenMP:IV Reloaded |
| Useful links | Community portal • Discussion forums • Modding forums • Mods on GTAGarage.com |
