Dynamic Patcher work differently from Ares. It can dynamic patch Yuri's Revenge by dynamic compiling the C# code and syringe the binary code to Yuri's Revenge.
It give a completely different way to write our extension features. We can use it to do something below:
- use the very nice reflection technique in C#
- use "*.cs" file as a script, which mean it can be a weapon script, map script and so on.
- coding when the game is running, without restarting the game.
- without building a dll file. instead, we can use "*.cs" file as hotfix.
- Hook Type
- Ares style hook
- Direct jump to hook function
- Direct jump to address
- Write bytes to address
- Recoverable Hook
- Recoverable Hook from Exception (if caught)
- Specified Module Hook
- Dynamic Compile & Syringe Technique
- Hook Conflict Detection
- Download newest DynamicPatcher from Releases (Recommended) or Actions.
- Unzip to game folder.
- Open config file
DynamicPatcher\dynamicpatcher.config.json
and sethide_console
to false, in order to check if DynamicPatcher work.- You can try something mentioned in Release.
- Run game by Ares's
Syringe
.
If DynamicPatcher not work, check the below:
- Runtime VC++ Redistributable 2015 - 2019 x86 and .NET Framework 4.8
- Run as Administrator
Put PatcherLoader.dll
and DynamicPatcher.dll
on your YR directory and launch Syringe targeting your YR executable (usually gamemd.exe
).
Create the directory DynamicPatcher
and put dynamicpatcher.config.json
& compiler.config.json
on it.
Create the directory DynamicPatcher\Libraries
and put necessary assembly on it.
Everythings could be gained from released files.(recommend)
DP includes some function of syringe, but at present it needs syringe to activate. In the future, we can activate DP through PatcherLauncher.
The patcher will search exist files at first or detected every file changes later. Next compile the file and syringe.
**Patcher will check the file time between code files and compiled assemblies and dependencies to skip unnecessary compile.
** If you meet some stranger problem, try deleting the directory DynamicPatcher\Build
.
the file DynamicPatcher\dynamicpatcher.config.json
explanation:
try_catch_callable
: try-catch invoke a hook function.
force_gc_collect
: forces garbage collection per 10s.
hide_console
: hide the console during start-up.
the file DynamicPatcher\compiler.config.json
explanation:
references
: the assemblies it referenced.
preprocessor_symbols
: define preprocessor symbols.
show_hidden
: show hidden message of compiler
load_temp_file_in_memory
: load temp file into memory. set false if want to Save & Load. set true if want to modify code dynamically.
emit_pdb
: emit pdb message
force_compile
: force compile all files at start-up.
pack_assembly
: pack/unpack builded assemblies for release.
- Compile or take the DynamicPatcher without DEVMODE.
- Set
pack_assembly
to true (DynamicPatcher\Packages
needed). - Remove the directory
DynamicPatcher\Build
Each hook are writed like the below
namespace PatcherSample
{
public class HookTest
{
[Hook(HookType.AresHook, Address = 0x6FCFA0, Size = 5)]
static public unsafe UInt32 ShowFirer(REGISTERS* R)
{
ref TechnoClass rTechno = ref ((Pointer<TechnoClass>)R->ESI).Ref;
ref TechnoTypeClass rType = ref rTechno.Type.Ref;
ref HouseClass rHouse = ref rTechno.Owner.Ref;
unsafe
{
string ID = rType.Base.GetUIName();
string HouseID = rHouse.Type.Ref.Base.GetUIName();
Logger.Log("{0}({1}) fired", ID, HouseID);
};
int rof = 1919810;
if (rTechno.Owner == HouseClass.Player)
{
rof = new Random().Next(0, 50);
}
else
{
rof = new Random().Next(114, 514);
}
Logger.Log("next ROF: " + rof);
R->EAX = (uint)rof;
Logger.Log("");
return 0x6FCFBE;
}
static public object writebytesfunc() => new byte[]{0x11,0x45,0x14,0x19,0x19,0x81};
public delegate object writebytesdlg();
[Hook(HookType.WriteBytesHook, Address = 0x7E03E0, Size = 8)]
static public writebytesdlg writebytestest = writebytesfunc;
static public object errorlogtestfunc() => throw new InvalidOperationException("you can't call this function.");
public delegate object errorlogtestdlg();
[Hook(HookType.WriteBytesHook, Address = 0x7E03F0, Size = 5)]
static public errorlogtestdlg errorlogtest = errorlogtestfunc;
}
}
- HookAttribute Target
- Method
- Field
- Property
The extension is divided into 2 parts โโ dynamic and static.
Dynamic means that you can edit when game running.
-
Dynamic
- Hooks
- ...
-
Static (Projects included in solution file named by '.sln')
- APIs (Many helpers)
- Structure Definitions
- Managers
- ...
Sample has some simple feature below:
- Multi-extension manage
- Decorators
- Scripts
- Update script when recompiling (unsafe)
- Save & Load
YRPP is a static part of Extension.
It give some game structure and helpers in C# style.
This project has no direct affiliation with Electronic Arts Inc. Command & Conquer, Command & Conquer Red Alert 2, Command & Conquer Yuri's Revenge are registered trademarks of Electronic Arts Inc. All Rights Reserved.