Для AI-first навигации см. AI Memory / Processes — там описаны подключение к процессу, работа с указателями, readers и место pattern scanning в memory workflow.
Pattern scanning — это способ искать в памяти конкретные последовательности байтов. Он полезен, когда нужно найти функции, данные или код, которые во время работы программы не всегда находятся по одному и тому же адресу.
Класс BytePattern добавлен для поддержки нескольких способов задания паттернов. Это упрощает работу с разными форматами, которые обычно используются при сканировании памяти.
Pattern scanning доступен для любого типа, реализующего интерфейс IMemory, например:
using var process = LocalProcess.ByProcessName("pathofexile"); //uses naive RPM under the hood
Log.Info($"Process: {process}");
var modules = process.GetProcessModules(); //enumerate all loaded modules
using var memory = process.MemoryOfModule("pathofexile.exe"); //memory implements IMemory
Log.Info($"Process memory: {memory}, base: {memory.BaseAddress.ToHexadecimal()}");
// will find a singular offset pointing at 4th byte in the sequence
var offset = memory.FindOffset(BytePattern.FromTemplate("55 8B ?? ^ EC 00"));
// will return dictionary with all found offsets for all given patterns
var playerPattern = BytePattern.FromTemplate("55 8B ?? ^ EC 00");
var targetPattern = BytePattern.FromTemplate("BB AA ??");
var offsetsByPattern = memory.FindOffset(playerPattern, targetPattern);
// by using Get* instead of Find* the code will throw an exception in case pattern is not found
var criticalOffset = memory.GetOffset(BytePattern.FromTemplate("55 8B ?? ^ EC 00"));
Массивы байтов
var pattern = BytePattern.FromPattern(new byte[] {0x55, 0x8B, 0xEC});
Совпадёт только с этой последовательностью байтов.
Паттерны в стиле C
\xAA\xBB\xCC, как в C-style patterns.var pattern = BytePattern.FromTemplate("\x55\x8B\xEC");
Эквивалентно массиву байтов [0x55, 0x8B, 0xEC].
Шестнадцатеричные строки с wildcard-байтами
?? означает wildcard, то есть любой байт.var pattern = BytePattern.FromTemplate("55 8B ?? 83");
Совпадёт с любой последовательностью, которая начинается с 55 8B, затем содержит любой байт, а после него — 83.
Маскированные паттерны
x, а wildcard — как ?.var pattern = BytePattern.FromMaskedPattern(new byte[] { 0x55, 0x8B, 0xEC, 0x00, 0x08 }, "xxx??");
55 8B EC, а затем содержит любые два байта.Шаблоны со смещением
^.var pattern = BytePattern.FromTemplate("55 8B ?? ^ EC 00");
Здесь offset ставится прямо перед EC, то есть с пропуском 3 байтов. Это значит, что после нахождения паттерна итоговый offset будет Offset + 3