#include "CommonHeaders.h" #include "GameFixes.h" #include "GameInformations.h" #include "ObfuscateString.h" #include "Memory.hpp" #include "Maths.hpp" #include "UEngine.hpp"; #include "SDK/Basic.hpp" #include "SDK/Engine_classes.hpp" using namespace SDK; // Constants const std::string PLUGIN_NAME = "Keeper"; const std::string PLUGIN_LOG = PLUGIN_NAME + ".log"; const float BASE_ASPECT = 1.777777791; const float DEFAULT_WORLD_FOV = 90.f; // Logger std::shared_ptr logger; // Screen informations static int screenWidth = GetSystemMetrics(SM_CXSCREEN); static int screenHeight = GetSystemMetrics(SM_CYSCREEN); static float aspectRatio = (float)screenWidth / screenHeight; // Plugin states static bool AOBScanDone = false; static bool g_fix_enabled = false; static bool g_fov_fix_enabled = false; static bool g_ultrawide_fix_enabled = false; static bool g_DOF_fix_enabled = false; static bool g_CA_fix_enabled = false; static bool g_Vignetting_fix_enabled = false; static bool g_Fog_fix_enabled = false; static int g_AdditionalFOVValue = 0; static bool g_Console = false; // Shared values static float g_FOV_In = 70.f; static float g_Compensated_FOV = 70.f; static float g_FOV_Out = 70.f; static bool g_Console_Enabled = false; // AOB Unreal Engine offsets addresses static uint8_t* GObjectsaddress = nullptr; static uint8_t* AppendStringaddress = nullptr; static uint8_t* ProcessEventaddress = nullptr; // AOB Scan pointers static uint8_t* FOVaddress = nullptr; static uint8_t* Ultrawideaddress = nullptr; static uint8_t* DOFaddress = nullptr; static uint8_t* CAaddress = nullptr; static uint8_t* Vignettingaddress = nullptr; static uint8_t* Fogaddress = nullptr; // Hooking static SafetyHookMid FOVHook{}; static SafetyHookMid AspectHook{}; static SafetyHookMid FogHook{}; // Prototypes static void FOVFixEnabled(); static void UltrawideFixEnabled(); static void DOFFixEnabled(); static void CAFixEnabled(); static void VignettingFixEnabled(); static void FogFixEnabled(); static void EnableConsole(); extern "C" __declspec(dllexport) void SetFixEnabled(bool enabled, bool init) { g_fix_enabled = enabled; if (g_fix_enabled && !AOBScanDone) { logger->info("--------------- AOB scan started ---------------"); if (FOVaddress == nullptr) { constexpr auto FOVStringObfuscated = make_obfuscated<0x4A>("77 ?? 48 ?? ?? FF ?? ?? ?? ?? ?? F3 0F ?? ?? ?? 48"); FOVaddress = Memory::AOBScan("", FOVStringObfuscated.decrypt(), PAGE_EXECUTE_READ, logger); if (!FOVaddress) logger->warn("FOV signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("FOV signature found at address: 0x{:X}.", reinterpret_cast(FOVaddress)); } if (Ultrawideaddress == nullptr) { constexpr auto AspectStringObfuscated = make_obfuscated<0x4A>("F3 0F ?? ?? ?? ?? ?? ?? 48 8D ?? ?? ?? 83 8C ?? ?? ?? ?? ?? ?? 48"); Ultrawideaddress = Memory::AOBScan("", AspectStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!Ultrawideaddress) logger->warn("Ultrawide ratio signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("Ultrawide signature found at address: 0x{:X}.", reinterpret_cast(Ultrawideaddress)); } if (DOFaddress == nullptr) { constexpr auto DOFStringObfuscated = make_obfuscated<0x4A>("8B ?? ?? 48 ?? ?? E8 ?? ?? ?? ?? 0F ?? ?? 48 ?? ?? ?? 48 8D"); DOFaddress = Memory::AOBScan("", DOFStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!DOFaddress) logger->warn("DOF signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("DOF signature found at address: 0x{:X}.", reinterpret_cast(DOFaddress)); } if (CAaddress == nullptr) { constexpr auto CAStringObfuscated = make_obfuscated<0x4A>("7F ?? 44 89 ?? ?? ?? ?? ?? 43 ?? ?? ?? 39 05"); CAaddress = Memory::AOBScan("", CAStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!CAaddress) logger->warn("Chromatic aberrations signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("Chromatic aberrations signature found at address: 0x{:X}.", reinterpret_cast(CAaddress)); } if (Vignettingaddress == nullptr) { constexpr auto VignettingStringObfuscated = make_obfuscated<0x4A>("8B ?? 83 ?? ?? 7D ?? 44 89"); Vignettingaddress = Memory::AOBScan("", VignettingStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!Vignettingaddress) logger->warn("Vignetting signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("Vignetting signature found at address: 0x{:X}.", reinterpret_cast(Vignettingaddress)); } if (Fogaddress == nullptr) { constexpr auto FogStringObfuscated = make_obfuscated<0x4A>("40 ?? 48 83 ?? ?? 48 8B ?? ?? ?? ?? ?? 48 ?? ?? 48 89 ?? ?? ?? 48 8D ?? ?? 48 8D ?? ?? ?? E8"); Fogaddress = Memory::AOBScan("", FogStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!Fogaddress) logger->warn("Fog signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else logger->info("Fog signature found at address: 0x{:X}.", reinterpret_cast(Fogaddress)); } if (FOVaddress && Ultrawideaddress && DOFaddress && CAaddress && Vignettingaddress && Fogaddress) logger->info("All AOB signatures found. Ready to patch..."); AOBScanDone = true; if (!GObjectsaddress || !AppendStringaddress || !ProcessEventaddress) { logger->info("------------ UEngine offsets search ------------"); uint8_t* baseModule = reinterpret_cast(GetModuleHandleA(nullptr)); // Get game base address constexpr auto GObjetcsStringObfuscated = make_obfuscated<0x4A>("48 8B ?? ?? ?? ?? ?? 48 8B ?? ?? 48 8D ?? ?? EB ?? 33"); GObjectsaddress = Memory::AOBScan("", GObjetcsStringObfuscated.decrypt(), PAGE_EXECUTE_READ); constexpr auto AppendStringStringObfuscated = make_obfuscated<0x4A>("48 89 ?? ?? ?? 48 89 ?? ?? ?? 57 48 83 ?? ?? 80 3D ?? ?? ?? ?? ?? 48 8B F2 8B ?? 48"); AppendStringaddress = Memory::AOBScan("", AppendStringStringObfuscated.decrypt(), PAGE_EXECUTE_READ); constexpr auto ProcessEventStringObfuscated = make_obfuscated<0x4A>("40 ?? 56 57 41 ?? 41 ?? 41 ?? 41 ?? 48 81 ?? ?? ?? ?? ?? 48 8D ?? ?? ?? 48 89 ?? ?? ?? ?? ?? 48 8B ?? ?? ?? ?? ?? 48 33 ?? 48 89 ?? ?? ?? ?? ?? 4D ?? ?? 48"); ProcessEventaddress = Memory::AOBScan("", ProcessEventStringObfuscated.decrypt(), PAGE_EXECUTE_READ); if (!GObjectsaddress) logger->warn("GObjects signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else { uint32_t gObjectsOffset = static_cast(Memory::GetOffsetFromOpcode(GObjectsaddress + 0x3) - baseModule); logger->info("GObjects offset is: 0x{:X}.", gObjectsOffset); Offsets::GObjects = static_cast(gObjectsOffset); // Update GObjects offset } if (!AppendStringaddress) logger->warn("AppendString signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else { std::optional gAppendStringOffsetOpt = UE::CalculateOffset("", AppendStringaddress); // Get Offset from opcode uint32_t gAppendStringOffset = *gAppendStringOffsetOpt; logger->info("AppendString offset is: 0x{:X}.", gAppendStringOffset); Offsets::AppendString = static_cast(gAppendStringOffset); // Update AppendString offset } if (!ProcessEventaddress) logger->warn("Process Event signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else { std::optional gProcessEventOffsetOpt = UE::CalculateOffset("", ProcessEventaddress); uint32_t gProcessEventOffset = *gProcessEventOffsetOpt; logger->info("Process Event offset is: 0x{:X}.", gProcessEventOffset); Offsets::ProcessEvent = static_cast(gProcessEventOffset);// Update ProcessEvent offset } } } if (g_fix_enabled) logger->info("-------------- Fixes initialisation -------------"); if (!init && FOVaddress) FOVFixEnabled(); if (!init && Ultrawideaddress) UltrawideFixEnabled(); if (!init && DOFaddress) DOFFixEnabled(); if (!init && CAaddress) CAFixEnabled(); if (!init && Vignettingaddress) VignettingFixEnabled(); if (!init && Fogaddress) FogFixEnabled(); if (!init && GObjectsaddress && AppendStringaddress && ProcessEventaddress) EnableConsole(); } // Setters for Reshade addon call extern "C" __declspec(dllexport) void SetFixesEnabled(GameFixes fix, bool enabled) { if (fix == GameFixes::DevConsole) { g_Console = enabled; EnableConsole(); }; if (fix == GameFixes::FOV) { g_fov_fix_enabled = enabled; FOVFixEnabled(); } if (fix == GameFixes::UltraWide) { g_ultrawide_fix_enabled = enabled; UltrawideFixEnabled(); } if (fix == GameFixes::DOF) { g_DOF_fix_enabled = enabled; DOFFixEnabled(); } if (fix == GameFixes::ChromaticAberrations) { g_CA_fix_enabled = enabled; CAFixEnabled(); } if (fix == GameFixes::Vignetting) { g_Vignetting_fix_enabled = enabled; VignettingFixEnabled(); } if (fix == GameFixes::Fog) { g_Fog_fix_enabled = enabled; FogFixEnabled(); } } extern "C" __declspec(dllexport) void SetFOV(int fov) { g_AdditionalFOVValue = fov; } // Getters for Reshade addon call extern "C" __declspec(dllexport) void GetGameInfos(GameInfos* infos) { if (!infos) return; infos->FOVIn = g_FOV_In; infos->CompensatedFOV = g_Compensated_FOV; infos->FOVOut = g_FOV_Out; infos->consoleEnabled = g_Console_Enabled; } // Code injection functions static void FOVFixEnabled() { if (FOVaddress) { if (g_fix_enabled && (g_fov_fix_enabled || g_ultrawide_fix_enabled) && FOVaddress) { if (!FOVHook) { // Hook only once FOVHook = safetyhook::create_mid(FOVaddress + 0x10, [](SafetyHookContext& ctx) { g_FOV_In = ctx.xmm0.f32[0]; // FOV compensation when ultrawide is checked if (aspectRatio > BASE_ASPECT && g_ultrawide_fix_enabled) ctx.xmm0.f32[0] = Maths::CompensateHorizontalFOV(g_FOV_In, BASE_ASPECT, aspectRatio); g_Compensated_FOV = ctx.xmm0.f32[0]; // Additional FOV ctx.xmm0.f32[0] += (g_fix_enabled && g_fov_fix_enabled ? g_AdditionalFOVValue : 0); g_FOV_Out = ctx.xmm0.f32[0]; }); } else FOVHook.enable(); logger->info("FOV fix enabled"); } if (!(g_fix_enabled && (g_fov_fix_enabled || g_ultrawide_fix_enabled)) && FOVaddress) { if (FOVHook) FOVHook.disable(); logger->info("FOV fix disabled"); } } } static void UltrawideFixEnabled() { if (g_fix_enabled && g_ultrawide_fix_enabled && Ultrawideaddress) { if (!AspectHook) { AspectHook = safetyhook::create_mid(Ultrawideaddress + 0x8, [](SafetyHookContext& ctx) { ctx.xmm0.f32[0] = aspectRatio; }); } else AspectHook.enable(); FOVFixEnabled(); logger->info("Aspect fix enabled"); } if (!(g_fix_enabled && g_ultrawide_fix_enabled) && Ultrawideaddress) { if (AspectHook) AspectHook.disable(); logger->info("Aspect ratio fix disabled"); } } // Memory patch fixes static void DOFFixEnabled() { if (g_fix_enabled && g_DOF_fix_enabled && DOFaddress) { Memory::PatchBytes(DOFaddress, "\x31\xFF\x90", 3); // xor edi,edi r.DepthOfFieldQuality = 0 logger->info("Depth of field fix enabled"); } if (!(g_fix_enabled && g_DOF_fix_enabled) && DOFaddress) { Memory::RestoreBytes(DOFaddress); logger->info("Depth of field fix disabled"); } } static void CAFixEnabled() { if (g_fix_enabled && g_CA_fix_enabled && CAaddress) { Memory::PatchBytes(CAaddress, "\x90\x90", 2); // NOP jg "HellIsUs-Win64-Shipping.exe"+3D73BD5 r.SceneColorFringeQuality = 0 logger->info("Chromatic aberrations fix enabled"); } if (!(g_fix_enabled && g_CA_fix_enabled) && CAaddress) { Memory::RestoreBytes(CAaddress); logger->info("Chromatic aberrations fix disabled"); } } static void VignettingFixEnabled() { if (g_fix_enabled && g_Vignetting_fix_enabled && Vignettingaddress) { Memory::PatchBytes(Vignettingaddress, "\x31\xC9", 2); // xor ecx,ecx r.Tonemapper.Quality=0 logger->info("Vignetting fix enabled"); } if (!(g_fix_enabled && g_Vignetting_fix_enabled) && Vignettingaddress) { Memory::RestoreBytes(Vignettingaddress); logger->info("Vignetting fix disabled"); } } static void FogFixEnabled() { if (g_fix_enabled && g_Fog_fix_enabled && Fogaddress) { if (!FogHook) { FogHook = safetyhook::create_mid(Fogaddress + 0x31, [](SafetyHookContext& ctx) { if (!ctx.rax) return; uintptr_t* rax = reinterpret_cast(ctx.rax); bool* bFog = reinterpret_cast(reinterpret_cast(rax) + 0x04); *bFog = g_fix_enabled && g_Fog_fix_enabled ? false : true; }); } logger->info("Fog fix enabled"); } if (!(g_fix_enabled && g_Fog_fix_enabled) && Fogaddress) logger->info("Fog fix disabled"); } // UE Console creation static void EnableConsole() { if (g_Console_Enabled || !g_Console || !GObjectsaddress || !AppendStringaddress || !ProcessEventaddress) return; logger->info("-------------- Console re-enabling --------------"); std::thread([&]() { auto start = std::chrono::high_resolution_clock::now(); // Measure the time to renable console UEngine* Engine = nullptr; for (int i = 0; i < 10; ++i) { // gives 10 seconds to find UE Engine std::this_thread::sleep_for(std::chrono::milliseconds(1000)); Engine = UEngine::GetEngine(); if (Engine && Engine->ConsoleClass && Engine->GameViewport) break; } if (!Engine || !Engine->ConsoleClass || !Engine->GameViewport) { logger->error("Console could not be found in engine."); return; } logger->info("Console found in engine"); /* Creates a new UObject of class-type specified by Engine->ConsoleClass */ UObject* NewObject = UGameplayStatics::SpawnObject(Engine->ConsoleClass, Engine->GameViewport); if (NewObject) { logger->info("Successfully spawned console object"); // Set the console viewport so that it will be displayed Engine->GameViewport->ViewportConsole = static_cast(NewObject); // Compute console enabling duration auto end = std::chrono::high_resolution_clock::now(); std::chrono::duration elapsed = end - start; // Set the all the console shortkey to F2 for (int i = 0; i < UInputSettings::GetDefaultObj()->ConsoleKeys.Num(); i++) { UInputSettings::GetDefaultObj()->ConsoleKeys[i].KeyName = UKismetStringLibrary::Conv_StringToName(L"F2"); } logger->info("Console fully reactivated in {:.3f}s and bound to key F2", elapsed.count()); logger->info("------------------ User inputs ------------------"); g_Console_Enabled = true; } else { logger->error("Could not spawn console object"); logger->info("------------------ User inputs ------------------"); } }).detach(); } static void InitializeLogger() { try { std::filesystem::path log_path = std::filesystem::absolute(PLUGIN_LOG); if (std::filesystem::exists(log_path)) std::filesystem::remove(log_path); logger = std::make_shared("Keeper", std::make_shared(PLUGIN_LOG, 10 * 1024 * 1024, 1)); logger->set_level(spdlog::level::debug); logger->flush_on(spdlog::level::debug); // Flush automatically } catch (const spdlog::spdlog_ex& ex) { std::string plugin_error_message = "Could not open " + PLUGIN_LOG; MessageBoxA(nullptr, plugin_error_message.c_str(), "Logger Error", MB_ICONERROR | MB_OK); } } // Standard dll entry BOOL APIENTRY DllMain(HMODULE hModule, DWORD reason, LPVOID) { if (reason == DLL_PROCESS_ATTACH) { InitializeLogger(); logger->info("Plugin {} loaded.", PLUGIN_NAME); } else if (reason == DLL_PROCESS_DETACH) { logger->info("Plugin {} unloaded.", PLUGIN_NAME); spdlog::drop_all(); } return TRUE; }