PCSX2 Cheat Development Kit

PCSX2 Menu Trainer Development Kit is a C++ library designed to simplify the process of creating cheats for the PCSX2 emulator. It aims to bridge the gap between modern cheat development practices and the classic era of cheat codes. This framework provides tools to port older codes to a more modern approach, using additional libraries such as dear imgui and minhook.

FEATURES

• Easily Read & Write to virtual PS2 Memory
• PCSX2 Emulator Process Virtual Method Hooking
• Rendering API Helpers
• Access EE & IOP Registers during execution

USAGE

1. include the SDK header as well as any required packages.
   NOTE: Engine_Package.h is a required package and needs to be manually included.

• CDK.h // Including the SDK header will provide access to all the most necessary features.
• Core_Package.cpp // Main Package and must be included for basic usage
• PCSX2_Package.cpp // PCSX2 specific members and functions. Like the rendering API's for instance

2. Initialize the SDK

• PlayStation2::InitCDK(); // Basic CDK Initialization

3. Do Stuff

   PCSX2-CheatFramework/dllmain.cpp

   Lines 18 to 29 in 70dcf7d

   	PlayStation2::g_Engine->CreateConsole(" PCSX2 Cheat Framework Console "); // Manually spawn a console instance ( this will be an sdk initialization option at some point in the future )
   	auto device = *PlayStation2::CGlobals::g_gs_device; // Obtains the current render api device instance [@TODO: create method of obtaining current api class instance (GSDevice11)]
   	auto renderer = *PlayStation2::CGlobals::g_gs_renderer; // obtains Hardware renderer instance
   	auto emu_thread = *PlayStation2::CGlobals::g_emu_thread; // obtains main emu thread instance
   	printf("[+] PCSX2 Framework Client Initialized!\n- device\t-> 0x%llX\n- renderer\t-> 0x%llX\n- thread\t-> 0x%llX\n- PS2Base\t-> 0x%llX\n"
   	". . . PRESS [END] TO EXIT . . .\n\n",
   	device,
   	renderer,
   	emu_thread,
   	PlayStation2::Memory::BasePS2MemorySpace
   	);

4. (optional) include game package for additional controls

USAGE EXAMPLES

• Access EE Memory

  PCSX2-CheatFramework/examples/GameMemory/dllmain.cpp

  Lines 33 to 34 in b2ae5a4

  	// - Get EE Memory Module Base ( ps2 game ram )
  	const auto eeModuleBase = PS2Memory::GetModuleBase();

• Get Virtual Address

  PCSX2-CheatFramework/examples/GameMemory/dllmain.cpp

  Lines 37 to 38 in b2ae5a4

  	// - retrieve an offsets virtual address in memory
  	long long offsetAddress = PS2Memory::GetAddr(0x1000);

• Read Virtual Memory

  PCSX2-CheatFramework/examples/GameMemory/dllmain.cpp

  Lines 41 to 47 in b2ae5a4

  	// - read 8 bytes from the offset virtual address obtained in the previous step
  	auto read_result_long = PS2Memory::ReadLong<long long>(offsetAddress);
  	Console::LogMsg("[+][%.3f][PS2Memory::ReadLong] 0x%llX\n", t.GetElapsedTime(clock()), read_result_long);
  	// - read 8 bytes from a virtual address in memory using a games offset
  	auto read_result_short = PS2Memory::ReadShort<long long>(0x2000);
  	Console::LogMsg("[+][%.3f][PS2Memory::ReadShort] 0x%llX\n", t.GetElapsedTime(clock()), read_result_short);

• Access Class Members via GamePackages

/// SOCOM 1 -> Access SealObject & Modify Weapon Ammo
{
    // Create an instance of the Offsets Class
    SOCOM1::CZSeal* pLocalSeal = SOCOM1::CZSeal::GetDefaultInstance();
    if (pLocalSeal)
        Console::cLogMsg("[+][PCSX2-CDK][SOCOM] LocalSeal Name: %s\n", EConsoleColors::green, pLocalSeal->GetName().c_str());
}

• Hook Rendering API

  PCSX2-CheatFramework/examples/Rendering/dllmain.cpp

  Lines 44 to 51 in 7c786cd

  	auto d3d11 = static_cast<PlayStation2::GSDevice11*>(PlayStation2::CGlobals::g_gs_device);
  	if (d3d11)
  	{
  	// Get SwapChain & Hook
  	pSwapChain = d3d11->GetSwapChain();
  	if (pSwapChain)
  	PlayStation2::hkVFunction(pSwapChain, 8, oIDXGISwapChainPresent, hkPresent);
  	}

References & Credits

• PCSX2
• GameHacking.org
• Sly Cooper Modding Community
• SOCOM Modding Community
• A General Guide for Making Cheats & Trainers for PCSX2

License

This framework is distributed under the MIT License.

Disclaimer

1. This framework is intended for educational and single-player use.
2. Use cheats responsibly and respect the terms of use of the games you are modifying.