Dumper-7

Dumper-7 is an SDK Generator for Unreal Engine games (UE4 and UE5). To use it, follow these steps:

1. Compile: Build the project as a x64-Release DLL.
2. Inject: Inject the resulting DLL into your target game process.
3. Locate SDK: The generated SDK will be saved to the path defined by Settings::SDKGenerationPath. By default, this is C:\Dumper-7.

For detailed instructions on using the generated SDK or migrating from older versions, refer to the UsingTheSDK.md guide.

Compile the dll in x64-Release

To use CMake in Visual Studio:

1. Open the project folder in Visual Studio.
2. Select a configure preset.
3. Compile the project using the shortcut Ctrl+B.

You can install CMake using either a native installer or the Visual Studio Installer.

Using the Native Installer

1. Download the appropriate installer from the official CMake website (e.g., Windows x64 Installer).
2. Run the installer.
3. Important: Select "Add CMake to the system PATH" during the installation process.
4. Verify the installation by running cmake --version in a terminal.

Using the Visual Studio Installer

1. Open the Visual Studio Installer.
2. Select your installed product (Build Tools or Visual Studio) and click Modify.
3. Navigate to the Individual components tab.
4. Search for "cmake".
5. Check C++ CMake tools for Windows and/or CMake tools for Windows.
6. Click Modify to complete the installation.

If you prefer using Visual Studio instead of the Xmake CLI for building, you can generate project files using the xmake project command. Use the -k flag to specify the generator type and -m to specify the build configurations.

Available generators:

• vs: Standard Visual Studio project.
• vsxmake2022: Visual Studio 2022 specific project.

xmake project -k vs -m "debug;release"
# Or for VS 2022
xmake project -k vsxmake2022 -m "debug;release"

To integrate the SDK, copy the contents of your CppSDK folder (e.g., C:\Dumper-7\GameName-GameVersion\CppSDK) into your Visual Studio project directory.

Header Inclusion

• For simplicity: Add #include "SDK.hpp" at the top of your Main.cpp. This includes everything but increases compilation time.
• For performance: Include only the specific files you need, such as #include "SDK/Engine_classes.hpp".

Source File Requirements

• You must add Basic.cpp and CoreUObject_functions.cpp to your Visual Studio project.
• If you call a function from the SDK, you must also add the .cpp file containing that function's body to your project. For example, calling GetViewportSize() from APlayerController requires adding Engine_functions.cpp to your project.

Note: When building, ensure your Error List is set to Build Only to avoid unnecessary noise.

Use the xmake f command to configure the project settings, such as the platform, architecture, and build mode.

Commonly used flags:

• -p: Platform (e.g., windows)
• -a: Architecture (e.g., x64)
• -m: Build mode (e.g., release or debug)

xmake f -p windows -a x64 -m release
# Or for debug mode
xmake f -p windows -a x64 -m debug

To use CMake in Visual Studio Code, follow these steps:

1. Install Required Extensions:

   • C/C++ Extension Pack
   • CMake Tools

2. Configure a Project:

   • Open the folder containing your CMakeLists.txt file.
   • VS Code should automatically detect the project.
   • Use the CMake icon in the sidebar to access tools.
   • Select a compiler/kit when prompted by the editor.

If GObjects are not automatically detected, you must manually add a layout in ObjectArray.cpp (around line 30).

• UE4.11 to UE4.20: Add the layout to the FFixedUObjectArrayLayouts struct.
• UE4.21 and higher: Add the layout to the FChunkedFixedUObjectArrayLayouts struct.

Layout Formats:

Fixed Layout (UE4.11 - UE4.20):

FFixedUObjectArrayLayout
{
    .ObjectsOffset = 0x0,
    .MaxObjectsOffset = 0x8,
    .NumObjectsOffset = 0xC
}

Chunked Layout (UE4.21+):

FChunkedFixedUObjectArrayLayout
{
    .ObjectsOffset = 0x00,
    .MaxElementsOffset = 0x10,
    .NumElementsOffset = 0x14,
    .MaxChunksOffset = 0x18,
    .NumChunksOffset = 0x1C,
}

FFixedUObjectArrayLayout // Default UE4.11 - UE4.20
{
    .ObjectsOffset = 0x0,
    .MaxObjectsOffset = 0x8,
    .NumObjectsOffset = 0xC
}