Tool:UE4SS
| On this wiki | Facts · Code · Notes · Topics |
|---|
RE-UE4SS, an MIT-licensed injectable framework for Unreal Engine 4 and 5 games (Lua and C++ mods, object dumpers, live property viewer, SDK and header generators) that finds the engine globals in the running game by signatures and per-version layout templates.
Overview
UE4SS (RE-UE4SS) is a proxy DLL placed next to the game's shipping executable. At start it scans the executable for the engine's globals (see Library:Unreal Engine/Reflection data#How tools find the globals), reads class layouts for the detected engine version from MemberVariableLayout.ini and VTableLayout.ini templates, and then exposes UObjects to Lua and C++ mods, dumps the object array (GUObjectArray) to text, generates C++ headers/SDK, and offers a live view of objects and properties.
Compatibility files
UE4SS_Signatures/*.lua: user-supplied byte patterns when the built-in ones fail.Register()returns the pattern (nibble wildcards allowed);OnMatchFound(addr)returns the final address and may callDerefToInt32.MemberVariableLayout.ini,VTableLayout.ini: per-game offsets for classes and virtual-function slots; templates for 4.07 to 5.08 ship in the repository.UE4SS-settings.ini:[EngineVersionOverride],DefaultFNameToStringMethod,bForceGUObjectArrayForIteration.assets/CustomGameConfigs/<Game>/: configs for games with modified engines (public list in the repository).docs/patternsleuth-games.md: games for which all patterns were found by the Patternsleuth scanner.
Required symbols
GUObjectArray, FName::ToString, FName::FName (constructor), StaticConstructObject_Internal, GMalloc; optional GNatives, GUObjectHashTables, ConsoleManager; rarely ProcessLocalScriptFunction, ProcessInternal, CallFunctionByNameWithArguments. The documented way to derive a missing pattern is to package a blank Shipping game of the same engine version with PDB files, find the function by name in a debugger and generalise its first bytes.
See also
Code & repositories
See Library:Unreal Engine/Reflection data.
- https://github.com/UE4SS-RE/RE-UE4SS @
97adba01e9fcb3c208376581e54edb9ef466f233· license: MIT
UE4SS source (MIT); layout templates, signature examples and compatibility guides are read without building.
Tested on: source read, not run: source read, not built · checked 2026-10-18; last activity 2026-10-17; Note: the latest release ships binaries; the wiki links only the source, never the binaries