all repos — gemini-redirect @ 920dbf76a2de03bdf23db741d4ca79433c7e3b7e

blog/woce-2/index.html (view raw)

  1<!DOCTYPE html><html lang=en><head><meta charset=utf-8><meta name=description content="Official Lonami's website"><meta name=viewport content="width=device-width, initial-scale=1.0, user-scalable=yes"><title> Writing our own Cheat Engine: Exact Value scanning | Lonami's Blog </title><link rel=stylesheet href=/style.css><body><article><nav class=sections><ul class=left><li><a href=/>lonami's site</a><li><a href=/blog class=selected>blog</a><li><a href=/golb>golb</a></ul><div class=right><a href=https://github.com/LonamiWebs><img src=/img/github.svg alt=github></a><a href=/blog/atom.xml><img src=/img/rss.svg alt=rss></a></div></nav><main><h1 class=title>Writing our own Cheat Engine: Exact Value scanning</h1><div class=time><p>2021-02-12<p>last updated 2021-02-19</div><p>This is part 2 on the <em>Writing our own Cheat Engine</em> series:<ul><li><a href=/blog/woce-1>Part 1: Introduction</a> (start here if you're new to the series!)<li>Part 2: Exact Value scanning<li><a href=/blog/woce-3>Part 3: Unknown initial value</a><li><a href=/blog/woce-4>Part 4: Floating points</a></ul><p>In the introduction, we spent a good deal of time enumerating all running processes just so we could find out the pid we cared about. With the pid now in our hands, we can do pretty much anything to its corresponding process.<p>It's now time to read the process' memory and write to it. If our process was a single-player game, this would enable us to do things like setting a very high value on the player's current health pool, making us invincible. This technique will often not work for multi-player games, because the server likely knows your true current health (the most you could probably do is make the client render an incorrect value). However, if the server is crappy and it trusts the client, then you're still free to mess around with your current health.<p>Even if we don't want to write to the process' memory, reading is still very useful. Maybe you could enhance your experience by making a custom overlay that displays useful information, or something that makes noise if it detects the life is too low, or even simulating a keyboard event to automatically recover some mana when you're running low.<p>Be warned about anti-cheat systems. Anything beyond a basic game is likely to have some protection measures in place, making the analysis more difficult (perhaps the values are scrambled in memory), or even pinging the server if it detects something fishy.<p><strong>I am not responsible for any bans!</strong> Use your brain before messing with online games, and don't ruin the fun for everyone else. If you get caught for cheating, I don't want to know about it.<p>Now that all <a href=https://www.urbandictionary.com/define.php?term=script%20kiddie>script kiddies</a> have left the room, let's proceed with the post.<h2 id=exact-value-scanning>Exact Value scanning</h2><details open><summary>Cheat Engine Tutorial: Step 2</summary> <blockquote><p>Now that you have opened the tutorial with Cheat Engine let's get on with the next step.<p>You can see at the bottom of this window is the text Health: xxx. Each time you click 'Hit me' your health gets decreased.<p>To get to the next step you have to find this value and change it to 1000<p>To find the value there are different ways, but I'll tell you about the easiest, 'Exact Value': First make sure value type is set to at least 2-bytes or 4-bytes. 1-byte will also work, but you'll run into an easy to fix problem when you've found the address and want to change it. The 8-byte may perhaps works if the bytes after the address are 0, but I wouldn't take the bet. Single, double, and the other scans just don't work, because they store the value in a different way.<p>When the value type is set correctly, make sure the scantype is set to 'Exact Value'. Then fill in the number your health is in the value box. And click 'First Scan'. After a while (if you have a extremely slow pc) the scan is done and the results are shown in the list on the left<p>If you find more than 1 address and you don't know for sure which address it is, click 'Hit me', fill in the new health value into the value box, and click 'Next Scan'. Repeat this until you're sure you've found it. (that includes that there's only 1 address in the list.....)<p>Now double click the address in the list on the left. This makes the address pop-up in the list at the bottom, showing you the current value. Double click the value, (or select it and press enter), and change the value to 1000.<p>If everything went ok the next button should become enabled, and you're ready for the next step.<p>Note: If you did anything wrong while scanning, click "New Scan" and repeat the scanning again. Also, try playing around with the value and click 'hit me'</blockquote></details><h2 id=our-first-scan>Our First Scan</h2><p>The Cheat Engine tutorial talks about "value types" and "scan types" like "exact value".<p>The <strong>value types</strong> will help us narrow down <em>what</em> we're looking for. For example, the integer type <code>i32</code> is represented in memory as 32 bits, or 4 bytes. However, <code>f32</code> is <em>also</em> represented by 4 bytes, and so is <code>u32</code>. Or perhaps the 4 bytes represent RGBA values of a color! So any 4 bytes in memory can be interpreted in many ways, and it's up to us to decide which way we interpret the bytes in.<p>When programming, numbers which are 32-bit wide are common, as they're a good (and fast) size to work with. Scanning for this type is often a good bet. For positive numbers, <code>i32</code> is represented the same as <code>u32</code> in memory, so even if the value turns out to not be signed, the scan is likely to work. Focusing on <code>i32</code> will save us from scanning for <code>f32</code> or even other types, like interpreting 8 bytes for <code>i64</code>, <code>f64</code>, or less bytes like <code>i16</code>.<p>The <strong>scan types</strong> will help us narrow down <em>how</em> we're looking for a value. Scanning for an exact value means what you think it does: interpret all 4 bytes in the process' memory as our value type, and check if they exactly match our value. This will often yield a lot of candidates, but it will be enough to get us started. Variations of the exact scan include checking for all values below a threshold, above, in between, or even just… unknown.<p>What's the point of scanning for unknown values if <em>everything</em> in memory is unknown? Sometimes you don't have a concrete value. Maybe your health pool is a bar and it nevers tell you how much health you actually have, just a visual indicator of your percentage left, even if the health is not stored as a percentage. As we will find later on, scanning for unknown values is more useful than it might appear at first.<p>We can access the memory of our own program by guessing random pointers and trying to read from them. But Windows isolates the memory of each program, so no pointer we could ever guess will let us read from the memory of another process. Luckily for us, searching for "read process memory winapi" leads us to the <a href=https://docs.microsoft.com/en-us/windows/win32/api/memoryapi/nf-memoryapi-readprocessmemory><code>ReadProcessMemory</code></a> function. Spot on.<pre><code class=language-rust data-lang=rust>pub fn read_memory(&self, addr: usize, n: usize) -> io::Result&LTVec&LTu8>> {
  2    todo!()
  3}
  4</code></pre><p>Much like trying to dereference a pointer pointing to released memory or even null, reading from an arbitrary address can fail for the same reasons (and more). We will want to signal this with <code>io::Result</code>. It's funny to note that, even though we're doing something that seems wildly unsafe (reading arbitrary memory, even if the other process is mutating it at the same time), the function is perfectly safe. If we cannot read something, it will return <code>Err</code>, but if it succeeds, it has taken a snapshot of the memory of the process, and the returned value will be correctly initialized.<p>The function will be defined inside our <code>impl Process</code>, since it conveniently holds an open handle to the process in question. It takes <code>&self</code>, because we do not need to mutate anything in the <code>Process</code> instance. After adding the <code>memoryapi</code> feature to <code>Cargo.toml</code>, we can perform the call:<pre><code class=language-rust data-lang=rust>let mut buffer = Vec::&LTu8>::with_capacity(n);
  5let mut read = 0;
  6
  7// SAFETY: the buffer points to valid memory, and the buffer size is correctly set.
  8if unsafe {
  9    winapi::um::memoryapi::ReadProcessMemory(
 10        self.handle.as_ptr(),
 11        addr as *const _,
 12        buffer.as_mut_ptr().cast(),
 13        buffer.capacity(),
 14        &mut read,
 15    )
 16} == FALSE
 17{
 18    Err(io::Error::last_os_error())
 19} else {
 20    // SAFETY: the call succeeded and `read` contains the amount of bytes written.
 21    unsafe { buffer.set_len(read as usize) };
 22    Ok(buffer)
 23}
 24</code></pre><p>Great! But the address space is somewhat large. 64 bits large. Eighteen quintillion, four hundred and forty-six quadrillion, seven hundred and forty-four trillion, seventy-three billion, seven hundred and nine million, five hundred and fifty-one thousand, six hundred and sixteen<sup class=footnote-reference><a href=#1>1</a></sup> large. You gave up reading that, didn't you? Anyway, 18'446'744'073'709'551'616 is a <em>big</em> number.<p>I am not willing to wait for the program to scan over so many values. I don't even have 16 <a href=https://en.wikipedia.org/wiki/Orders_of_magnitude_(data)>exbibytes</a> of RAM installed on my laptop yet<sup class=footnote-reference><a href=#2>2</a></sup>! What's up with that?<h2 id=memory-regions>Memory regions</h2><p>The program does not actually have all that memory allocated (surprise!). Random-guessing an address is extremely likely to point out to invalid memory. Reading from the start of the address space all the way to the end would not be any better. And we <strong>need</strong> to do better.<p>We need to query for the memory regions allocated to the program. For this purpose we can use <a href=https://docs.microsoft.com/en-us/windows/win32/api/memoryapi/nf-memoryapi-virtualqueryex><code>VirtualQueryEx</code></a>.<blockquote><p>Retrieves information about a range of pages within the virtual address space of a specified process.</blockquote><p>We have enumerated things before, and this function is not all that different.<pre><code class=language-rust data-lang=rust>fn memory_regions(&self) -> io::Result&LTwinapi::um::winnt::MEMORY_BASIC_INFORMATION> {
 25    let mut info = MaybeUninit::uninit();
 26
 27    // SAFETY: the info structure points to valid memory.
 28    let written = unsafe {
 29        winapi::um::memoryapi::VirtualQueryEx(
 30            self.handle.as_ptr(),
 31            std::ptr::null(),
 32            info.as_mut_ptr(),
 33            mem::size_of::&LTwinapi::um::winnt::MEMORY_BASIC_INFORMATION>(),
 34        )
 35    };
 36    if written == 0 {
 37        Err(io::Error::last_os_error())
 38    } else {
 39        // SAFETY: a non-zero amount was written to the structure
 40        Ok(unsafe { info.assume_init() })
 41    }
 42}
 43</code></pre><p>We start with a base address of zero<sup class=footnote-reference><a href=#3>3</a></sup> (<code>std::ptr::null()</code>), and ask the function to tell us what's in there. Let's try it out, with the <code>impl-debug</code> crate feature in <code>Cargo.toml</code>:<pre><code class=language-rust data-lang=rust>dbg!(process.memory_regions());
 44</code></pre><pre><code>>cargo run
 45Compiling memo v0.1.0
 46
 47error[E0277]: `winapi::um::winnt::MEMORY_BASIC_INFORMATION` doesn't implement `std::fmt::Debug`
 48   --> src\main.rs:185:5
 49    |
 50185 |     dbg!(process.memory_regions());
 51    |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ `winapi::um::winnt::MEMORY_BASIC_INFORMATION` cannot be formatted using `{:?}` because it doesn't implement `std::fmt::Debug`
 52</code></pre><p>That's annoying. It seems not everything has an <code>impl std::fmt::Debug</code>, and <a href=https://github.com/retep998/winapi-rs/issues/548#issuecomment-355278090>you're supposed to send a PR</a> if you want it to have debug, even if the <code>impl-debug</code> feature is set. I'm surprised they don't auto-generate all of this and have to rely on manually adding <code>Debug</code> as needed? Oh well, let's get rid of the feature and print it out ourselves:<pre><code>eprintln!(
 53    "Region:
 54    BaseAddress: {:?}
 55    AllocationBase: {:?}
 56    AllocationProtect: {:?}
 57    RegionSize: {:?}
 58    State: {:?}
 59    Protect: {:?}
 60    Type: {:?}",
 61    region.BaseAddress,
 62    region.AllocationBase,
 63    region.AllocationProtect,
 64    region.RegionSize,
 65    region.State,
 66    region.Protect,
 67    region.Type,
 68);
 69</code></pre><p>Hopefully we don't need to do this often:<pre><code>>cargo run
 70   Compiling memo v0.1.0
 71    Finished dev [unoptimized + debuginfo] target(s) in 0.60s
 72     Running `target\debug\memo.exe`
 73
 74Region:
 75    BaseAddress: 0x0
 76    AllocationBase: 0x0
 77    AllocationProtect: 0
 78    RegionSize: 65536
 79    State: 65536
 80    Protect: 1
 81    Type: 0
 82</code></pre><p>Awesome! There is a region at <code>null</code>, and the <code>AllocationProtect</code> of zero indicates that "the caller does not have access" when the region was created. However, <code>Protect</code> is <code>1</code>, and that is the <em>current</em> protection level. A value of one indicates <a href=https://docs.microsoft.com/en-us/windows/win32/memory/memory-protection-constants><code>PAGE_NOACCESS</code></a>:<blockquote><p>Disables all access to the committed region of pages. An attempt to read from, write to, or execute the committed region results in an access violation.</blockquote><p>Now that we know that the first region starts at 0 and has a size of 64 KiB, we can simply query for the page at <code>(current base + current size)</code> to fetch the next region. Essentially, we want to loop until it fails, after which we'll know there are no more pages<sup class=footnote-reference><a href=#4>4</a></sup>:<pre><code class=language-rust data-lang=rust>pub fn memory_regions(&self) -> Vec&LTwinapi::um::winnt::MEMORY_BASIC_INFORMATION> {
 83    let mut base = 0;
 84    let mut regions = Vec::new();
 85    let mut info = MaybeUninit::uninit();
 86
 87    loop {
 88        // SAFETY: the info structure points to valid memory.
 89        let written = unsafe {
 90            winapi::um::memoryapi::VirtualQueryEx(
 91                self.handle.as_ptr(),
 92                base as *const _,
 93                info.as_mut_ptr(),
 94                mem::size_of::&LTwinapi::um::winnt::MEMORY_BASIC_INFORMATION>(),
 95            )
 96        };
 97        if written == 0 {
 98            break regions;
 99        }
100        // SAFETY: a non-zero amount was written to the structure
101        let info = unsafe { info.assume_init() };
102        base = info.BaseAddress as usize + info.RegionSize;
103        regions.push(info);
104    }
105}
106</code></pre><p><code>RegionSize</code> is:<blockquote><p>The size of the region beginning at the base address in which all pages have identical attributes, in bytes.</blockquote><p>…which also hints that the value we want is "base address", not the "allocation base". With these two values, we can essentially iterate over all the page ranges:<pre><code class=language-rust data-lang=rust>dbg!(process.memory_regions().len());
107</code></pre><pre><code>>cargo run
108   Compiling memo v0.1.0
109    Finished dev [unoptimized + debuginfo] target(s) in 0.63s
110     Running `target\debug\memo.exe`
111
112[src\main.rs:189] process.memory_regions().len() = 367
113</code></pre><p>That's a lot of pages!<h2 id=protection-levels>Protection levels</h2><p>Let's try to narrow the amount of pages down. How many pages aren't <code>PAGE_NOACCESS</code>?<pre><code class=language-rust data-lang=rust>dbg!(process
114    .memory_regions()
115    .into_iter()
116    .filter(|p| p.Protect != winapi::um::winnt::PAGE_NOACCESS)
117    .count());
118</code></pre><pre><code>295
119</code></pre><p>Still a fair bit! Most likely, there are just a few interleaved <code>NOACCESS</code> pages, and the rest are allocated each with different protection levels. How much memory do we need to scan through?<pre><code class=language-rust data-lang=rust>dbg!(process
120    .memory_regions()
121    .into_iter()
122    .filter(|p| p.Protect != winapi::um::winnt::PAGE_NOACCESS)
123    .map(|p| p.RegionSize)
124    .sum::&LTusize>());
125</code></pre><pre><code>4480434176
126</code></pre><p>Wait, what? What do you mean over 4 GiB? The Task Manager claims that the Cheat Engine Tutorial is only using 2.1 MB worth of RAM! Perhaps we can narrow down the <a href=https://docs.microsoft.com/en-us/windows/win32/memory/memory-protection-constants>protection levels</a> a bit more. If you look at the scan options in Cheat Engine, you will notice the "Memory Scan Options" groupbox. By default, it only scans for memory that is writable, and doesn't care if it's executable or not:<pre><code class=language-rust data-lang=rust>let mask = winnt::PAGE_EXECUTE_READWRITE
127    | winnt::PAGE_EXECUTE_WRITECOPY
128    | winnt::PAGE_READWRITE
129    | winnt::PAGE_WRITECOPY;
130
131dbg!(process
132    .memory_regions()
133    .into_iter()
134    .filter(|p| (p.Protect & mask) != 0)
135    .map(|p| p.RegionSize)
136    .sum::&LTusize>());
137</code></pre><p>Each memory protection level has its own bit, so we can OR them all together to have a single mask. When ANDing this mask with the protection level, if any bit is set, it will be non-zero, meaning we want to keep this region.<p>Don't ask me why there isn't a specific bit for "write", "read", "execute", and there are only bits for combinations. I guess this way Windows forbids certain combinations.<pre><code>2580480
138</code></pre><p>Hey, that's close to the value shown by the Task Manager! A handfull of megabytes is a lot more manageable than 4 entire gigabytes.<h2 id=actually-running-our-first-scan>Actually running our First Scan</h2><p>Okay, we have all the memory regions from which the program can read, write, or execute. Now we also can read the memory in these regions:<pre><code class=language-rust data-lang=rust>let regions = process
139    .memory_regions()
140    .into_iter()
141    .filter(|p| (p.Protect & mask) != 0)
142    .collect::&LTVec<_>>();
143
144println!("Scanning {} memory regions", regions.len());
145
146regions.into_iter().for_each(|region| {
147    match process.read_memory(region.BaseAddress as _, region.RegionSize) {
148        Ok(memory) => todo!(),
149        Err(err) => eprintln!(
150            "Failed to read {} bytes at {:?}: {}",
151            region.RegionSize, region.BaseAddress, err,
152        ),
153    }
154})
155</code></pre><p>All that's left is for us to scan for a target value. To do this, we want to iterate over all the <a href=https://doc.rust-lang.org/stable/std/primitive.slice.html#method.windows><code>slice::windows</code></a> of size equal to the size of our scan type.<pre><code class=language-rust data-lang=rust>let target: i32 = ...;
156let target = target.to_ne_bytes();
157
158// -snip-
159
160// inside the Ok match, replacing the todo!() -- this is where the first scan happens
161Ok(memory) => memory
162    .windows(target.len())
163    .enumerate()
164    .for_each(|(offset, window)| {
165        if window == target {
166            println!(
167                "Found exact value at [{:?}+{:x}]",
168                region.BaseAddress, offset
169            );
170        }
171    })
172</code></pre><p>We convert the 32-bit exact target value to its memory representation as a byte array in <a href=https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes>native byte order</a>. This way we can compare the target bytes with the window bytes. Another option is to interpret the window bytes as an <code>i32</code> with <code>from_be_bytes</code>, but <code>slice::windows</code> gives us slices of type <code>&[u8]</code>, and <code>from_be_bytes</code> wants an <code>[u8; 4]</code> array, so it's a bit more annoying to convert.<p>This is enough to find the value in the process' memory!<pre><code>Found exact value at [0x10000+aec]
173Failed to read 12288 bytes at 0x13f8000: Only part of a ReadProcessMemory or WriteProcessMemory request was completed. (os error 299)
174Found exact value at [0x14f0000+3188]
175Found exact value at [0x14f0000+ac74]
176...
177Found exact value at [0x10030e000+1816]
178Found exact value at [0x7ff8f7b93000+441a]
179...
180Found exact value at [0x7ff8fb381000+4023]
181</code></pre><p>The tutorial starts out with health "100", which is what I scanned. Apparently, there are nearly a hundred of <code>100</code>-valued integers stored in the memory of the tutorial.<p>Attentive readers will notice that some values are located at an offset modulo 4. In Cheat Engine, this is known as "Fast Scan", which is enabled by default with an alignment of 4. Most of the time, values are aligned in memory, and this alignment often corresponds with the size of the type itself. For 4-byte integers, it's common that they're 4-byte aligned.<p>We can perform a fast scan ourselves with <a href=https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.step_by><code>step_by</code></a><sup class=footnote-reference><a href=#5>5</a></sup>:<pre><code class=language-rust data-lang=rust>memory
182    .windows(target.len())
183    .enumerate()
184    .step_by(4)
185    .for_each(...)
186</code></pre><p>As a bonus, over half the addresses are gone, so we have less results to worry about<sup class=footnote-reference><a href=#6>6</a></sup>.<h2 id=next-scan>Next Scan</h2><p>The first scan gave us way too many results. We have no way to tell which is the correct one, as they all have the same value. What we need to do is a <em>second</em> scan at the <em>locations we just found</em>. This way, we can get a second reading, and compare it against a new value. If it's the same, we're on good track, and if not, we can discard a location. Repeating this process lets us cut the hundreds of potential addresses to just a handful of them.<p>For example, let's say we're scanning our current health of <code>100</code> in a game. This gives us over a hundred addresses that point to the value of <code>100</code>. If we go in-game and get hit<sup class=footnote-reference><a href=#7>7</a></sup> by some enemy and get our health down to, say, <code>99</code> (we have a lot of defense), we can then read the memory at the hundred memory locations we found before. If this second reading is not <code>99</code>, we know the address does not actually point to our health pool and it just happened to also contain a <code>100</code> on the first scan. This address can be removed from the list of potential addresses pointing to our health.<p>Let's do that:<pre><code class=language-rust data-lang=rust>// new vector to hold the locations, before getting into `memory.windows`' for-each
187let mut locations = Vec::with_capacity(regions.len());
188
189// -snip-
190
191// updating the `println!("Found exact value...")` to store the location instead.
192if window == target {
193    locations.push(region.BaseAddress as usize + offset);
194}
195
196// -snip-
197
198// performing a second scan on the locations the first scan found.
199let target: i32 = ...;
200let target = target.to_ne_bytes();
201locations.retain(|addr| match process.read_memory(*addr, target.len()) {
202    Ok(memory) => memory == target,
203    Err(_) => false,
204});
205
206println!("Now have {} locations", locations.len());
207</code></pre><p>We create a vector to store all the locations the first scan finds, and then retain those that match a second target value. You may have noticed that we perform a memory read, and thus a call to the Windows API, for every single address. With a hundred locations to read from, this is not a big deal, but oftentimes you will have tens of thousands of addresses. For the time being, we will not worry about this inefficiency, but we will get back to it once it matters:<pre><code>Scanning 98 memory regions
208Which exact value to scan for?: 100
209Failed to read 12288 bytes at 0x13f8000: Only part of a ReadProcessMemory or WriteProcessMemory request was completed. (os error 299)
210...
211Found 49 locations
212Which exact value to scan for next?: 99
213Now have 1 locations
214</code></pre><p>Sweet! In a real-world scenario, you will likely need to perform these additional scans a couple of times, and even then, there may be more than one value left no matter what.<p>For good measure, we'll wrap our <code>retain</code> in a <code>while</code> loop<sup class=footnote-reference><a href=#8>8</a></sup>:<pre><code class=language-rust data-lang=rust>while locations.len() != 1 {
215    let target: i32 = ...;
216    let target = target.to_ne_bytes();
217    locations.retain(...);
218}
219</code></pre><h2 id=modifying-memory>Modifying memory</h2><p>Now that we have very likely locations pointing to our current health in memory, all that's left is writing our new desired value to gain infinite health<sup class=footnote-reference><a href=#9>9</a></sup>. Much like how we're able to read memory with <code>ReadProcessMemory</code>, we can write to it with <a href=https://docs.microsoft.com/en-us/windows/win32/api/memoryapi/nf-memoryapi-writeprocessmemory><code>WriteProcessMemory</code></a>. Its usage is straightforward:<pre><code class=language-rust data-lang=rust>pub fn write_memory(&self, addr: usize, value: &[u8]) -> io::Result&LTusize> {
220    let mut written = 0;
221
222    // SAFETY: the input value buffer points to valid memory.
223    if unsafe {
224        winapi::um::memoryapi::WriteProcessMemory(
225            self.handle.as_ptr(),
226            addr as *mut _,
227            value.as_ptr().cast(),
228            value.len(),
229            &mut written,
230        )
231    } == FALSE
232    {
233        Err(io::Error::last_os_error())
234    } else {
235        Ok(written)
236    }
237}
238</code></pre><p>Similar to how writing to a file can return short, writing to a memory location could also return short. Here we mimic the API for writing files and return the number of bytes written. The documentation indicates that we could actually ignore the amount written by passing <code>ptr::null_mut()</code> as the last parameter, but it does no harm to retrieve the written count as well.<pre><code class=language-rust data-lang=rust>let new_value: i32 = ...;
239locations
240    .into_iter()
241    .for_each(|addr| match process.write_memory(addr, &new_value) {
242        Ok(n) => eprintln!("Written {} bytes to [{:x}]", n, addr),
243        Err(e) => eprintln!("Failed to write to [{:x}]: {}", addr, e),
244    });
245</code></pre><p>And just like that:<pre><code>Now have 1 location(s)
246Enter new memory value: 1000
247Failed to write to [15d8b90]: Access is denied. (os error 5)
248</code></pre><p>…oh noes. Oh yeah. The documentation, which I totally didn't forget to read, mentions:<blockquote><p>The handle must have <code>PROCESS_VM_WRITE</code> and <code>PROCESS_VM_OPERATION</code> access to the process.</blockquote><p>We currently open our process with <code>PROCESS_QUERY_INFORMATION</code> and <code>PROCESS_VM_READ</code>, which is enough for reading, but not for writing. Let's adjust <code>OpenProcess</code> to accomodate for our new requirements:<pre><code class=language-rust data-lang=rust>winapi::um::processthreadsapi::OpenProcess(
249    winnt::PROCESS_QUERY_INFORMATION
250        | winnt::PROCESS_VM_READ
251        | winnt::PROCESS_VM_WRITE
252        | winnt::PROCESS_VM_OPERATION,
253    FALSE,
254    pid,
255)
256</code></pre><p>Behold:<pre><code>Now have 1 location(s)
257Enter new memory value: 1000
258Written 4 bytes to [15d8b90]
259</code></pre><p><img src=https://user-images.githubusercontent.com/6297805/107829541-3f4f2d00-6d8a-11eb-87c4-e2f2d505afbc.png alt="Tutorial complete with memo"><p>Isn't that active <em>Next</em> button just beautiful?<h2 id=finale>Finale</h2><p>This post somehow ended up being longer than part one, but look at what we've achieved! We completed a step of the Cheat Engine Tutorial <em>without using Cheat Engine</em>. Just pure Rust. Figuring out how a program works and reimplementing it yourself is a great way to learn what it's doing behind the scenes. And now that this code is yours, you can extend it as much as you like, without being constrained by Cheat Engine's UI. You can automate it as much as you want.<p>And we're not even done. The current tutorial has nine steps, and three additional graphical levels.<p>In the <a href=/blog/woce-3>next post</a>, we'll tackle the third step of the tutorial: Unknown initial value. This will pose a challenge, because with just 2 MiB of memory, storing all the 4-byte aligned locations would require 524288 addresses (<code>usize</code>, 8 bytes). This adds up to twice as much memory as the original program (4 MiB), but that's not our main concern, having to perform over five hundred thousand API calls is!<p>Remember that you can <a href=https://github.com/lonami/memo>obtain the code for this post</a> over at my GitHub. You can run <code>git checkout step2</code> after cloning the repository to get the right version of the code.<h3 id=footnotes>Footnotes</h3><div class=footnote-definition id=1><sup class=footnote-definition-label>1</sup><p>I did in fact use an online tool to spell it out for me.</div><div class=footnote-definition id=2><sup class=footnote-definition-label>2</sup><p>16 GiB is good enough for my needs. I don't think I'll ever upgrade to 16 EiB.</div><div class=footnote-definition id=3><sup class=footnote-definition-label>3</sup><p>Every address we query should have a corresponding region, even if it's not allocated or we do not have access. This is why we can query for the memory address zero to get its corresponding region.</div><div class=footnote-definition id=4><sup class=footnote-definition-label>4</sup><p>Another option is to <a href=https://docs.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsysteminfo><code>GetSystemInfo</code></a> to determine the <code>lpMinimumApplicationAddress</code> and <code>lpMaximumApplicationAddress</code> and only work within bounds.</div><div class=footnote-definition id=5><sup class=footnote-definition-label>5</sup><p>Memory regions are page-aligned, which is a large power of two. Our alignment of 4 is much lower than this, so we're guaranteed to start off at an aligned address.</div><div class=footnote-definition id=6><sup class=footnote-definition-label>6</sup><p>If it turns out that the value was actually misaligned, we will miss it. You will notice this if, after going through the whole process, there are no results. It could mean that either the value type is wrong, or the value type is misaligned. In the worst case, the value is not stored directly but is rather computed with something like <code>maximum - stored</code>, or XORed with some magic value, or a myriad other things.</div><div class=footnote-definition id=7><sup class=footnote-definition-label>7</sup><p>You could do this without getting hit, and just keep on repeating the scan for the same value over and over again. This does work, but the results are suboptimal, because there are also many other values that didn't change. Scanning for a changed value is a better option.</div><div class=footnote-definition id=8><sup class=footnote-definition-label>8</sup><p>You could actually just go ahead and try to modify the memory at the hundred addresses you just found, although don't be surprised if the program starts to misbehave!</div><div class=footnote-definition id=9><sup class=footnote-definition-label>9</sup><p>Okay, we cannot fit infinity in an <code>i32</code>. However, we can fit sufficiently large numbers. Like <code>1000</code>, which is enough to complete the tutorial.</div></main><footer><div><p>Share your thoughts, or simply come hang with me <a href=https://t.me/LonamiWebs><img src=/img/telegram.svg alt=Telegram></a> <a href=mailto:totufals@hotmail.com><img src=/img/mail.svg alt=Mail></a></div></footer></article><p class=abyss>Glaze into the abyss… Oh hi there!