Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kp7742/UE4Dumper

Unreal Engine 4 Dumper - Dump libUE4.so and Generate Structure SDK
https://github.com/kp7742/UE4Dumper

Last synced: 15 days ago
JSON representation

Unreal Engine 4 Dumper - Dump libUE4.so and Generate Structure SDK

Awesome Lists containing this project

README 

        
## UE4Dumper(Unreal Engine 4 Dumper)

Unreal Engine 4 Dumper for Android Devices, Dump Lib libUE4.so from Memory of Game Process and Generate Structure SDK of Supported Game in Android. You can Find Latest Dumped SDK from [HERE](https://github.com/kp7742/UE4Dumper/tree/master/SDKs/)



## Changelog

- v0.1: First Release

- v0.2: Experimental 64bit Support Added

- v0.3:

    - 1) Fix Object Iteration Issue during Dumping SDK 

    - 2) Added Support to Resolve Arrays, Sets and Maps Structure

- v0.4:

    - 1) Expanded 64bit Support,

    - 2) Fixed 64bit Library Rebuilding Not Working

    - 3) Added New Elf Dump Fix for 64bit Library

    - 4) Added Option to Dump SDK with GWorld

    - 5) Updated Usage Text

- v0.5: Added Support to Resolve Functions

- v0.6:

    - 1) Added Support for UE 4.23+ Games for Strings and Objects(Use new Option: --newue)

    - 2) Added 64bit Offsets to Fix 64bit Support

    - 3) Updated SDK Generation Method for Faster Dumping

    - 4) Short Options has been remove due to conflict with new options

- v0.7: Fixed Object Dumping issue for PUBG CN(Tested on GFP v1.8.10)

- v0.8: Fixed 64bit Support for Latest PUBG Version

- v0.9: Fixed Dumping issue with 64bit PUBG

- v0.10:

    - 1) Added Option to Print Actors of Main Level(Use new Option: --actors)

    - 2) Support for PUBG CN(GFP) Fixed(Tested on GFP v1.9.10)

    - 3) Fixed Some Offsets Issues due to Modified UE4 Versions

    - 4) Offsets System Updated to Work with Other games, other then PUBG

- v0.11: Fixed Dumping issue with 64bit PUBG Lite

- v0.12:

    - 1) Fixed Offsets for UE 4.23+ Mode

    - 2) Fixed SDK Dumping for UE 4.23+ Mode

    - 3) Fixed String Dumping for UE 4.23+ Mode

    - 4) Added Offset Support for Apex Legends Mobile

    - 5) Added Option to Detour or De-Reference GNames, GUObject Addresses

    - 6) Added Option to See Verbose Output of String, Object and SDK Dumping

- v0.13:

    - 1) Fixed String Reading for Objects for UE 4.23+ Mode

    - 2) Fixed SDK Dumping Issue Due to Invalid UStruct

    - 3) Added Offset Support for Fortnite Mobile

- v0.14: Fixed Support for Battlegrounds Mobile India

- v0.15:

    - 1) Fixed Struct Property Dumping

    - 2) Experimental Wide String Support Added for UE 4.23+ Mode

- v0.16: Fixed Dumping issue with 64bit PUBG Lite

- v0.17:

    - 1) Fixed Crash with Deref Options

    - 2) Fixed Issue with Wide String Dumping

- v0.18:

    - 1) Fixed Dumping issue with 64bit PUBG CN

    - 2) Fixed Another Issue with String Dumping

- v0.19:

    - 1) Fixed Object Dumping issue with PUBG CN

    - 2) Improved String Dumping Output

    - 3) Fixed Verbose Output Not Showing while String Dumping

    - 4) General Improvements to SDK Dumping

- v0.20:

    - 1) Merged code from private repo

    - 2) Few more improvements to SDK Dumping

    - 3) Added Option to use pointer decryption

    - 4) Added Support for PUBG New State Mobile

    - 5) Added GWorld and GName Workaround for PUBGM Series

    - 6) Offsets are not upto date with latest game versions so please update them yourself

    - 7) And in the end, this is probably last and final update of UE4Dumper



## Features

- No need of Ptrace

- Bypass Anti Debugging

- Dumping of Lib from Memory of Game

- Fix and Regenerate So(Elf) File from Dump

- Dumping of Game Structure SDK file(Need to Find Pointers Manually)

- Support Fast Dumping(Might Miss some data)

- Support SDK Dumping for UE4 Based Android Games

- Tested on 32bit and 64bit PUBG Mobile Series



## Note

- Only for Educational or Learning Purpose.

- Project is Deprecated, No more updates in Future.

- Use 32bit and 64bit Version on Respected Arch of Game.

- Recommend to use in Training Mode for PUBG Mobile.

- Some Games with Modified UE4 Might not Dump Correctly.

- For Modified Engines, You May Need Put Your Custom Offsets For That Game.

- If it stuck during Generating SDK, Then Simply Stop it, Check Dump file and If needed then Try again.

 

## How to use

- You can Use latest precompiled Binaries from [HERE](https://github.com/kp7742/UE4Dumper/tree/master/libs/) or You Can build your Own.

- Needs Either Root Access or Virtual Space

- Put Executable in folder like /data/local/tmp (/sdcard not allow to execute binary so don't put it there)

- Get Either Root Shell through Adb or Terminal Apps(type and run: 'su') or Normal Shell into Virtual Space via Terminal Apps in that folder

- Give it executable permission with either 'chmod +x ue4dumper' or 'chmod 755 ue4dumper'

- Run './ue4dumper -h' For Usage Help

	```

    ./ue4dumper -h

	 

    UE4Dumper v0.20 <==> Made By KMODs(kp7742)

    Usage: ./ue4dumper 

    Dump Lib libUE4.so from Memory of Game Process and Generate structure SDK for UE4 Engine

    Tested on PUBG Mobile Series and Other UE4 Based Games

    Options:

    --SDK Dump With GObjectArray Args--------------------------------------------------------

      --sdku                              Dump SDK with GUObject

      --gname 
                   GNames Pointer Address

      --guobj 
                   GUObject Pointer Address

    --SDK Dump With GWorld Args--------------------------------------------------------------

      --sdkw                              Dump SDK with GWorld

      --gname 
                   GNames Pointer Address

      --gworld 
                  GWorld Pointer Address

    --Dump Strings Args----------------------------------------------------------------------

      --strings                           Dump Strings

      --gname 
                   GNames Pointer Address

    --Dump Objects Args----------------------------------------------------------------------

      --objs                              Dumping Object List

      --gname 
                   GNames Pointer Address

      --guobj 
                   GUObject Pointer Address

    --Lib Dump Args--------------------------------------------------------------------------

      --lib                               Dump libUE4.so from Memory

      --raw(Optional)                     Output Raw Lib and Not Rebuild It

      --fast(Optional)                    Enable Fast Dumping(May Miss Some Bytes in Dump)

    --Show ActorList With GWorld Args--------------------------------------------------------

      --actors                            Show Actors with GWorld

      --gname 
                   GNames Pointer Address

      --gworld 
                  GWorld Pointer Address

    --Other Args-----------------------------------------------------------------------------

      --newue(Optional)                   Run in UE 4.23+ Mode

      --ptrdec(Optional)                  Use Pointer Decryption Mode

      --verbose(Optional)                 Show Verbose Output of Dumping

      --derefgname(Optional)  De-Reference GNames Address(Default: true)

      --derefguobj(Optional)  De-Reference GUObject Address(Default: false)

      --package              Package Name of App(Default: com.tencent.ig)

      --output                File Output path(Default: /sdcard)

      --help                              Display this information

	```

	

## How to Build

- Clone this repo

- Install Android NDK, if not already.

- Open Shell/CMD in Project Folder

- Drag ndk-build from NDK in Shell or CMD and then Execute

- Output will be in libs Folder.



## Credits

- [SoFixer](https://github.com/F8LEFT/SoFixer): 32bit So(Elf) Rebuilding

- [elf-dump-fix](https://github.com/maiyao1988/elf-dump-fix): 64bit So(Elf) Rebuilding

- [UnrealDumper-4.25](https://github.com/guttir14/UnrealDumper-4.25): UE 4.25+ Support



## Technlogy Communication

> Email: [email protected]