PUBG DataTable Repaker

A generic binary patcher and repaker for PUBG Unreal Engine 4 DataTable assets. Fixes obfuscated RowStruct property hashes to make any DataTable readable in FModel and CUE4Parse.

---

The Problem

When PUBG updates, the developers periodically obfuscate property names across engine structs. For UDataTable, the internal RowStruct property name is replaced with a dynamically generated hash (e.g. *94e90f7066, *8148d9ac28).

Because CUE4Parse and FModel rely on the literal string "RowStruct" to deserialize table rows, opening an affected DataTable yields:

"Properties": {
  "*8148d9ac28": {
    "ObjectName": "ScriptStruct'DBDataRow'",
    "ObjectPath": "/Script/TslGame"
  }
},
"Rows": null

Until CUE4Parse's internal name map is updated, the table rows cannot be read. Once you find the new hash, it is advised to make a PR and update the CUE4Parse/PUBGNameHashMap to be available for everyone via the FModel.

The Solution

PUBG DataTable Repaker automates the workaround:

1. Size-Preserving In-Place Patching: Replaces the obfuscated hash in the .uasset binary with the literal RowStruct, adjusting string length prefixes and compensating length differences by padding adjacent internal package paths (/Game/...). This prevents file offset corruption.
2. Auto Path Detection: Parses the internal package path directly from the .uasset headers to construct the correct Unreal Engine folder hierarchy (e.g., TslGame/Content/...).
3. Automated Repacking: Uses repak to pack all patched .uasset, .uexp, and .ubulk files into a single patch pak (patch_DataTable_P.pak).

---

Features

• Generic: Works with any PUBG DataTable, not just a single asset.
• Batch Processing: Place multiple .uasset + .uexp files in input/ to pack them all into a single .pak.
• Zero Hex Editing: No manual byte calculation or hex editing required.
• Easy Maintenance: When PUBG updates its hash, change one line in config.json and re-run.

---

Quick Start

Prerequisites

• Windows 10/11
• Python 3.8+ (ensure Python is added to PATH)
• repak.exe (included in the repository, or available from trumank/repak)

Usage

1. Extract the desired DataTable assets (.uasset and .uexp) from FModel.
2. Copy the extracted files into the input/ folder.
3. Run:
   • Double-click run.bat, or
   • Run via terminal:

     python repak.py

4. Output: Your patched .pak file will be created in output/patch_DataTable_P.pak.

Loading in FModel

You can load the generated .pak into FModel in two ways depending on your workflow:

Method 1: Full Game Context (Recommended)

Allows FModel to resolve complete in-game references, StringTables, localized text, and asset paths using the base game archives:

1. Copy output/patch_DataTable_P.pak to your PUBG game directory:

   C:\Program Files (x86)\Steam\SteamApps\common\PUBG\TslGame\Content\Paks
   

2. Open FModel and set Settings -> Directory to your game's Paks folder.
3. In the Archives list, find patch_DataTable_P.pak (located at the bottom of the list) and load only this patch file.
4. Export the desired DataTable as JSON into exported_json/.
5. Run translate.bat to de-obfuscate all property keys and enum values.

Method 2: Standalone Mode (Quick Preview)

1. Open FModel and set Settings -> Directory to the project's output/ folder.
2. Load patch_DataTable_P.pak and export your DataTable.

Note: All row data, properties, numbers, and IDs deserialize properly, but external game references such as StringTables and localized text remain unresolved.

---

Translating Exported JSONs

If exported DataTable JSON files contain obfuscated property names, enums, or asset hashes (e.g. *3845ea526d, *d85827e15a::*7b78d477a5), you can translate them automatically to clean English names using PUBGNameHashMap.json:

1. Drop your exported JSON files into the exported_json/ folder.
2. Run:
   • Double-click translate.bat, or
   • Run via terminal:

     python translate.py

(You can also pass a custom file/folder path directly: python translate.py path/to/file.json or drag-and-drop a file onto translate.bat).

Note: Make sure PUBGNameHashMap.json is updated for the latest PUBG version. You can generate an up-to-date mapping file using pubg-namehash-generator.

---

Examples

1. Loading Mode Comparison

Standalone Mode (Project output/ folder)

Row structures and values deserialize, but localized string references remain blank:

"ItemName": {
  "TableId": "/Game/Item/Equip/ST_item_equipment_ItemNames.ST_Item_Equipment_ItemNames",
  "Key": "ItemName_Armor_C_01_Lv3",
  "LocalizedString": ""
}

Full Game Context (Game Paks/ folder)

FModel reads the base game's StringTables and resolves the in-game text:

"ItemName": {
  "TableId": "/Game/Item/Equip/ST_item_equipment_ItemNames.ST_Item_Equipment_ItemNames",
  "Key": "ItemName_Armor_C_01_Lv3",
  "LocalizedString": "Military Vest (Level 3)"
}

---

2. JSON Translation Comparison

Before Translation

"Rows": {
  "0": {
    "*4aa8bfd36a": "None",
    "SkinApplicationType": "*d85827e15a::*7b78d477a5",
    "ItemName": {
      "TableId": "/Game/Item/Equip/ST_item_equipment_ItemNames.ST_Item_Equipment_ItemNames",
      "Key": "ItemName_Armor_C_01_Lv3",
      "LocalizedString": "Military Vest (Level 3)"
    }
  }
}

After Translation

"Rows": {
  "0": {
    "SkinPresetName": "None",
    "SkinApplicationType": "SkinApplicationType::Default",
    "ItemName": {
      "TableId": "/Game/Item/Equip/ST_item_equipment_ItemNames.ST_Item_Equipment_ItemNames",
      "Key": "ItemName_Armor_C_01_Lv3",
      "LocalizedString": "Military Vest (Level 3)"
    }
  }
}

---

Configuration (config.json)

{
  "rowstruct_hash": "*8148d9ac28",
  "repak_exe": "repak.exe",
  "pak_version": "V9",
  "output_pak_name": "patch_DataTable_P.pak"
}

Setting	Description
rowstruct_hash	The current obfuscated hash for RowStruct. Accepts *hash, _hash, or raw hash.
repak_exe	Path or command for the repak CLI binary.
pak_version	Unreal Engine pak format version.
output_pak_name	Name of the output .pak archive.

---

How to Find the New Hash After Game Updates

When PUBG releases a patch and DataTable stop showing rows:

1. Via FModel Export:

   • Export any DataTable to JSON.
   • Look inside "Properties". The key pointing to ScriptStruct is the new hash (e.g., "*8148d9ac28").

2. Via C++ SDK Dump:

   • Open Engine_classes.h in your SDK dump.
   • Locate struct UDataTable : UObject.
   • Find the property of type UScriptStruct* (e.g. UScriptStruct* _8148d9ac28;).
   • Replace the leading _ with * (*8148d9ac28).

3. Update "rowstruct_hash" in config.json and re-run.

---

Repository Structure

pubg-datatable-repaker/
├── config.json               # Configuration file for current hash & pak settings
├── repak.py                  # Main Python patcher & repak pipeline
├── translate.py              # Utility to translate obfuscated JSON exports
├── repak.exe                 # Unreal Engine pak packaging utility
├── run.bat                   # One-click Windows runner for repak
├── translate.bat             # One-click Windows runner for JSON translator
├── input/                    # Drop raw .uasset / .uexp files here
│   └── PUBGNameHashMap.json  # Dictionary mapping hashes to English names
├── output/                   # Patched .pak output destination
├── exported_json/            # Drop exported JSON files here to translate
├── .gitignore
├── LICENSE
└── README.md

---

Acknowledgments

• repak by trumank - High-performance Unreal Engine .pak CLI tool.
• CUE4Parse by FabianFG - Unreal Engine asset parsing library.
• FModel by 4sval - Unreal Engine archive explorer.
• pubg-namehash-generator by moisoni97 - PUBG name hash generation utility.

---

License

This project is licensed under the MIT License.