#include #include #include #include #include #include "Memory.hpp"; #include "Maths.hpp"; #include "UEngine.hpp"; #include "SDK/Basic.hpp" #include "SDK/Engine_classes.hpp" #include "ObfuscateString.h" using namespace SDK; // Constants const std::string PLUGIN_NAME = "HellIsUs"; const std::string PLUGIN_LOG = PLUGIN_NAME + ".log"; const std::string gameExecutable = "HellIsUs-Win64-Shipping.exe"; const float baseAspect = 1.777777791; const float PDA_FOV = 21; // FOV must not be modified when switching to PDA to keep reading possible // 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_aspect_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; // Shared values static float g_FOV_In = 0; static float g_Compensated_FOV = 0; static float g_FOV_Out = 0; static bool g_Console_Enabled = false; // AOB Unreal Engine offsets addresses static uint8_t* GObjectsaddress = nullptr; static uint8_t* GNamesaddress = nullptr; static uint8_t* AppendStringaddress = nullptr; static uint8_t* ProcessEventaddress = nullptr; // AOB Scan pointers static uint8_t* FOVaddress = nullptr; static uint8_t* FOVOtheraddress = nullptr; static uint8_t* Aspectaddress = 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(bool fix_enabled); static void AspectFixEnabled(bool fix_enabled); static void DOFFixEnabled(bool fix_enabled); static void CAFixEnabled(bool fix_enabled); static void VignettingFixEnabled(bool fix_enabled); static void FogFixEnabled(bool fix_enabled); static void EnableConsole(); extern "C" __declspec(dllexport) void SetFixEnabled(bool enabled) { 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(gameExecutable, FOVStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 3C8E924 - 48 8B 01 - mov rax, [rcx] //"HellIsUs-Win64-Shipping.exe" + 3C8E927 - FF 90 60 07 00 00 - call qword ptr[rax + 00000760] //"HellIsUs-Win64-Shipping.exe" + 3C8E92D - F3 0F 10 40 30 - movss xmm0, [rax + 30] //"HellIsUs-Win64-Shipping.exe" + 3C8E932 - 48 83 C4 28 - add rsp, 28 //"HellIsUs-Win64-Shipping.exe" + 3C8E936 - C3 - ret 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)); FOVaddress += 0x10; } } if (Aspectaddress == nullptr) { constexpr auto AspectStringObfuscated = make_obfuscated<0x4A>("E9 ?? ?? ?? ?? CC CC CC CC CC CC 48 89 ?? ?? ?? 57 48 83 ?? ?? 0F ?? ?? 48 ?? ?? 48"); Aspectaddress = Memory::AOBScan(gameExecutable, AspectStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 3453EBA - 89 41 58 - mov[rcx + 58], eax //"HellIsUs-Win64-Shipping.exe" + 3453EBD - 8B 42 5C - mov eax, [rdx + 5C] //"HellIsUs-Win64-Shipping.exe" + 3453EC0 - 89 41 5C - mov[rcx + 5C], eax <<= Aspect ratio //"HellIsUs-Win64-Shipping.exe" + 3453EC3 - 48 8D 42 60 - lea rax, [rdx + 60] //"HellIsUs-Win64-Shipping.exe" + 3453EC7 - 48 83 C1 60 - add rcx, 60 if (!Aspectaddress) logger->warn("Aspect ratio ratio signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else { logger->info("Aspect ratio signature found at address: 0x{:X}.", reinterpret_cast(Aspectaddress)); Aspectaddress = Aspectaddress + 0x8b; } } if (DOFaddress == nullptr) { constexpr auto DOFStringObfuscated = make_obfuscated<0x4A>("74 ?? 48 ?? ?? 8B ?? ?? 48 ?? ?? E8"); DOFaddress = Memory::AOBScan(gameExecutable, DOFStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 26ABA27 - 74 03 - je "HellIsUs-Win64-Shipping.exe" + 26ABA2C //"HellIsUs-Win64-Shipping.exe" + 26ABA29 - 48 8B C3 - mov rax, rbx //"HellIsUs-Win64-Shipping.exe" + 26ABA2C - 8B 34 30 - mov esi, [rax + rsi] //"HellIsUs-Win64-Shipping.exe" + 26ABA2F - 48 8B CF - mov rcx, rdi //"HellIsUs-Win64-Shipping.exe" + 26ABA32 - E8 D9 C4 6C 01 - call "HellIsUs-Win64-Shipping.exe" + 3D77F10 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)); DOFaddress += 0x5; } } if (CAaddress == nullptr) { constexpr auto CAStringObfuscated = make_obfuscated<0x4A>("7F ?? 44 89 ?? ?? ?? ?? ?? 43 ?? ?? ?? 39 05"); CAaddress = Memory::AOBScan(gameExecutable, CAStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 3D73BC2 - 48 8B 05 D7 F7 6E 05 - mov rax, ["HellIsUs-Win64-Shipping.exe" + 94633A0] //"HellIsUs-Win64-Shipping.exe" + 3D73BC9 - 44 39 38 - cmp[rax], r15d //"HellIsUs-Win64-Shipping.exe" + 3D73BCC - 7F 07 - jg "HellIsUs-Win64-Shipping.exe" + 3D73BD5 //"HellIsUs-Win64-Shipping.exe" + 3D73BCE - 44 89 BB 1C 20 00 00 - mov[rbx + 0000201C], r15d //"HellIsUs-Win64-Shipping.exe" + 3D73BD5 - 43 8B 04 26 - mov eax, [r14 + r12] 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(gameExecutable, VignettingStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 3D73C64 - 8B 08 - mov ecx, [rax] //"HellIsUs-Win64-Shipping.exe" + 3D73C66 - 83 F9 02 - cmp ecx, 02 //"HellIsUs-Win64-Shipping.exe" + 3D73C69 - 7D 09 - jnl "HellIsUs-Win64-Shipping.exe" + 3D73C74 //"HellIsUs-Win64-Shipping.exe" + 3D73C6B - 44 89 BB C8 22 00 00 - mov[rbx + 000022C8], r15d //"HellIsUs-Win64-Shipping.exe" + 3D73C72 - EB 05 - jmp "HellIsUs-Win64-Shipping.exe" + 3D73C79 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)); Vignettingaddress += 0x5; } } if (Fogaddress == nullptr) { constexpr auto FogStringObfuscated = make_obfuscated<0x4A>("F6 ?? ?? ?? ?? 74 ?? 48 8B ?? ?? ?? ?? ?? 83 78 ?? ?? 75 ?? B3"); Fogaddress = Memory::AOBScan(gameExecutable, FogStringObfuscated.decrypt(), PAGE_EXECUTE_READ); //"HellIsUs-Win64-Shipping.exe" + 22B77C8 - 74 11 - je "HellIsUs-Win64-Shipping.exe" + 22B77DB //"HellIsUs-Win64-Shipping.exe" + 22B77CA - 48 8B 05 8F 23 08 07 - mov rax, ["HellIsUs-Win64-Shipping.exe" + 9339B60] //"HellIsUs-Win64-Shipping.exe" + 22B77D1 - 83 78 04 01 - cmp dword ptr[rax + 04], 01 //"HellIsUs-Win64-Shipping.exe" + 22B77D5 - 75 04 - jne "HellIsUs-Win64-Shipping.exe" + 22B77DB //"HellIsUs-Win64-Shipping.exe" + 22B77D7 - B3 01 - mov bl, 01 //"HellIsUs-Win64-Shipping.exe" + 22B77D9 - EB 02 - jmp "HellIsUs-Win64-Shipping.exe" + 22B77DD //"HellIsUs-Win64-Shipping.exe" + 22B77DB - 32 DB - xor bl, bl 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)); Fogaddress += 0x12; } } if (FOVaddress && FOVOtheraddress && Aspectaddress && DOFaddress && CAaddress && Vignettingaddress && Fogaddress) { logger->info("All AOB signatures found. Ready to patch..."); AOBScanDone = true; } if (!GObjectsaddress || !AppendStringaddress || !ProcessEventaddress) { logger->info("------------ UEngine offsets search ------------"); constexpr auto GObjetcsStringObfuscated = make_obfuscated<0x4A>("48 8B ?? ?? ?? ?? ?? 48 8B ?? ?? 48 8D ?? ?? EB ?? 33"); GObjectsaddress = Memory::AOBScan(gameExecutable, GObjetcsStringObfuscated.decrypt(), PAGE_EXECUTE_READ); constexpr auto GNamesStringObfuscated = make_obfuscated<0x4A>("48 8D ?? ?? ?? ?? ?? EB ?? 48 8D ?? ?? ?? ?? ?? E8 ?? ?? ?? ?? C6 05 ?? ?? ?? ?? ?? 0F ?? ?? 4C"); GNamesaddress = Memory::AOBScan(gameExecutable, GNamesStringObfuscated.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(gameExecutable, 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(gameExecutable, 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) - reinterpret_cast(GetModuleHandleA(gameExecutable.c_str()))); logger->info("GObjects offset is: 0x{:X}.", gObjectsOffset); Offsets::GObjects = static_cast(gObjectsOffset); // Update GObjects offset } if (!GNamesaddress) logger->warn("GNames signature not found. Maybe your game has been updated and is no more compatible with this plugin."); else { uint32_t gNamesOffset = static_cast(Memory::GetOffsetFromOpcode(GNamesaddress + 0x3) - reinterpret_cast(GetModuleHandleA(gameExecutable.c_str()))); logger->info("GNames offset is: 0x{:X}.", gNamesOffset); Offsets::GNames = static_cast(gNamesOffset); // Update GNames 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(gameExecutable, 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(gameExecutable, ProcessEventaddress); uint32_t gProcessEventOffset = *gProcessEventOffsetOpt; logger->info("Process Event offset is: 0x{:X}.", gProcessEventOffset); Offsets::ProcessEvent = static_cast(gProcessEventOffset);// Update ProcessEvent offset } } logger->info("-------------- Fixes initialisation -------------"); } if (g_fix_enabled) { if (FOVaddress) FOVFixEnabled(g_fov_fix_enabled || g_aspect_fix_enabled); if (Aspectaddress) AspectFixEnabled(g_aspect_fix_enabled); if (DOFaddress) DOFFixEnabled(g_DOF_fix_enabled); if (CAaddress) CAFixEnabled(g_CA_fix_enabled); if (Vignettingaddress) VignettingFixEnabled(g_Vignetting_fix_enabled); if (Fogaddress) FogFixEnabled(g_Fog_fix_enabled); } else { if (FOVaddress) FOVFixEnabled(false); if (Aspectaddress) AspectFixEnabled(false); if (DOFaddress) DOFFixEnabled(false); if (CAaddress) CAFixEnabled(false); if (Vignettingaddress) VignettingFixEnabled(false); if (Fogaddress) FogFixEnabled(false); logger->info("All fixes disabled."); } } // Setters for Reshade addon call extern "C" __declspec(dllexport) void SetFOVFixEnabled(bool enabled, bool init) { g_fov_fix_enabled = enabled; if (!init) FOVFixEnabled(g_fov_fix_enabled || g_aspect_fix_enabled); } extern "C" __declspec(dllexport) void SetAspectRatioFixEnabled(bool enabled, bool init) { g_aspect_fix_enabled = enabled; if (!init) AspectFixEnabled(g_aspect_fix_enabled); } extern "C" __declspec(dllexport) void SetDOFFixEnabled(bool enabled, bool init) { g_DOF_fix_enabled = enabled; if (!init) DOFFixEnabled(g_DOF_fix_enabled); } extern "C" __declspec(dllexport) void SetCAFixEnabled(bool enabled, bool init) { g_CA_fix_enabled = enabled; if (!init) CAFixEnabled(g_CA_fix_enabled); } extern "C" __declspec(dllexport) void SetVignettingFixEnabled(bool enabled, bool init) { g_Vignetting_fix_enabled = enabled; if (!init) VignettingFixEnabled(g_Vignetting_fix_enabled); } extern "C" __declspec(dllexport) void SetFogFixEnabled(bool enabled, bool init) { g_Fog_fix_enabled = enabled; if (!init) FogFixEnabled(g_Fog_fix_enabled); } extern "C" __declspec(dllexport) void SetFOV(int fov) { g_AdditionalFOVValue = fov; } extern "C" __declspec(dllexport) void SetConsole() { EnableConsole(); } // Getters for Reshade addon call extern "C" __declspec(dllexport) float GetFOVIn() { return g_FOV_In; } extern "C" __declspec(dllexport) float GetCompensatedFOV() { return g_Compensated_FOV; } extern "C" __declspec(dllexport) float GetFOVOut() { return g_FOV_Out; } extern "C" __declspec(dllexport) bool GetConsoleEnabled() { return g_Console_Enabled; } // Code injection functions static void FOVFixEnabled(bool fix_enabled) { if (g_fix_enabled && fix_enabled && FOVaddress != nullptr) { if (!FOVHook) { // Hook only once FOVHook = safetyhook::create_mid(FOVaddress, [](SafetyHookContext& ctx) { g_FOV_In = ctx.xmm0.f32[0]; if (g_aspect_fix_enabled) g_Compensated_FOV = ctx.xmm0.f32[0] = Maths::CompensateHorizontalFOV(g_FOV_In, baseAspect, aspectRatio); else g_Compensated_FOV = ctx.xmm0.f32[0]; if (g_FOV_In != PDA_FOV) g_FOV_Out = ctx.xmm0.f32[0] += (g_fov_fix_enabled ? g_AdditionalFOVValue : 0); else g_FOV_Out = ctx.xmm0.f32[0]; }); } else FOVHook.enable(); logger->info("FOV fix enabled"); } if (!fix_enabled) { if (FOVHook) FOVHook.disable(); logger->info("FOV fix disabled"); } } static void AspectFixEnabled(bool fix_enabled) { if (g_fix_enabled && fix_enabled && Aspectaddress) { if (!AspectHook) { AspectHook = safetyhook::create_mid(Aspectaddress, [](SafetyHookContext& ctx) { ctx.rax = *reinterpret_cast(&aspectRatio); }); } else AspectHook.enable(); logger->info("Aspect fix enabled"); } if (!fix_enabled) { if (AspectHook) AspectHook.disable(); logger->info("Aspect ratio fix disabled"); } } // Memory patch fixes static void DOFFixEnabled(bool fix_enabled) { if (g_fix_enabled && fix_enabled && DOFaddress) { Memory::PatchBytes(DOFaddress, "\x31\xF6\x90", 3); // xor esi,esi r.DepthOfFieldQuality = 0 logger->info("Depth of field fix enabled"); } if (!fix_enabled && DOFaddress) { Memory::RestoreBytes(DOFaddress); logger->info("Depth of field fix disabled"); } } static void CAFixEnabled(bool fix_enabled) { if (g_CA_fix_enabled && fix_enabled && CAaddress) { Memory::PatchBytes(CAaddress, "\x90\x90", 2); // NOP jg "HellIsUs-Win64-Shipping.exe"+3D73BD5 logger->info("Chromatics aberrations fix enabled"); } if (!fix_enabled && CAaddress) { Memory::RestoreBytes(CAaddress); logger->info("Chromatics aberrations fix disabled"); } } static void VignettingFixEnabled(bool fix_enabled) { if (g_fix_enabled && fix_enabled && Vignettingaddress) { Memory::PatchBytes(Vignettingaddress, "\x31\xC9", 2); // xor ecx,ecx r.Tonemapper.Quality=0 logger->info("Vignetting fix enabled"); } if (!fix_enabled && Vignettingaddress) { Memory::RestoreBytes(Vignettingaddress); logger->info("Vignetting fix disabled"); } } static void FogFixEnabled(bool fix_enabled) { if (g_fix_enabled && fix_enabled && Fogaddress) { if (!FogHook) { // Hook only once FogHook = safetyhook::create_mid(Fogaddress, [](SafetyHookContext& ctx) { ctx.rflags &= ~0x40; // ZF=0 }); } logger->info("Fog fix enabled"); } } // UE Console creation static void EnableConsole() { logger->info("-------------- Console re-enabling --------------"); if (!GObjectsaddress || !AppendStringaddress || !ProcessEventaddress) { logger->warn("Could not re-enable console"); logger->info("------------------ User inputs ------------------"); return; } std::thread([&]() { auto start = std::chrono::high_resolution_clock::now(); // Measure the time to renable console UEngine* Engine = nullptr; for (int i = 0; i < 100; ++i) { // gives 10 seconds to find UE Engine std::this_thread::sleep_for(std::chrono::milliseconds(100)); 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); 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"); } }).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("Hell Is Us", std::make_shared(PLUGIN_LOG, 10 * 1024 * 1024, 1)); 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; }