Where Does UE4SS Store Mods and Settings?
UE4SS keeps mods in Mods with settings in UE4SS-settings.ini inside its working directory, now a ue4ss subfolder by the game exe.
Last updated
UE4SS organizes mods through a working directory that recent versions tuck into a ue4ss subfolder beside the game executable. The Mods folder holds one directory per mod, mods.txt controls which load, and UE4SS-settings.ini tunes the framework itself. The log beside them records every load.
Older installs scattered the same files directly in the game folder and still work, which is why guides disagree about paths. New installs use the subfolder layout; only the proxy DLL stays in the game binary directory. Extra mod folders can be attached through settings or the UE4SS_MODS_PATHS variable.
Where UE4SS stores this, by platform
[GameBinaries]\Win64\ue4ss\Mods
Mods, mods.txt, UE4SS-settings.ini, and UE4SS.log together. The proxy DLL (dwmapi.dll) stays in the binary folder. Legacy installs without the subfolder keep working, so check both layouts.
[GameFolder]/ue4ss/Mods
Same working-directory layout inside the Proton prefix for Steam installs. The log names the failing mod on crashes, which beats guessing from the mod list.
Frequently asked questions
How do I install a UE4SS Lua mod?
Drop the mod folder into Mods and list it in mods.txt. Each mod needs its own folder with an enabled flag; the documented default layout shows the exact nesting UE4SS expects.
Where are UE4SS options configured?
Open UE4SS-settings.ini in the working directory. Hotkeys, auto-reload, console visibility, and extra mod paths all live there with inline comments explaining each option.
Notice an outdated path? Let us know.