Skip to content

RetroAchievements website

RA discord server

Memory Inspector Overview

Here is a short overview of the Memory Inspector and its features. This tool can be found on “RetroAachievements” tab on any emulator integrated with RA.

Memory Inspector Dialoglink

memoryinspector-num

1. Reset tolink

Click on one of these buttons to start a new test. For most things 8-bit test would be appropriate.

2. Filter Valueslink

Usually filter for either == (equals to) last known value or != (different than) last known value. If you know the exact value you expect something to be, you can use Given Value, or if you're convinced that a value should have increased, you could try > (greater than) or < (less than).

3. Filter!link

With every press of this button, you are filtering out values that do not match in memory between the last test and now.

4. Results windowlink

memoryinspector-filter jpg

After filtering you'll see in the results window exactly what happened, how many values you've got and how many are left. Some points to note:

  • Search results show live value changes, so you can more easily identify usable addresses.
  • Search results are highlighted depending on their criteria. For addresses that don't fit the search filter, they will be highlighted in red. This can be disabled on the Highlights checkbox, if preferred.
  • You can also manually exclude any selected addresses from the search. Use Ctrl or Shift to multi-select.
  • Results History: You can move backwards (<<) or forwards (>>) through your previous filtered searches. Keep in mind if you start a new search (such as New 8-bit Test), your history will be cleared.

5. Watchinglink

Any properly formed value in this area will be watched in the watch windows and bound to the code notes on the right. The addresses must be 0x (that's zero, then letter x), followed by hexadecimal digits.

6. Watch windowlink

Any watched variable and the variables around it will be shown in this window.

7. Code Noteslink

Once you've found a memory address you want to make a note of, ensure the value is entered into the 'Watching' dropdown box. Next you can write a short description in the textbox next to it, and click Save Note. This will send the memory address and your description to the database, so it can be shared with all developers who work on this game.

Click the dropdown arrow to view what memory addresses have been found so far, and you will be shown the description in the box next to it, to tell you what this memory address is for.

Try and keep your descriptions simple and clear, so they can be easily understood. To rename a note, select it in the drop-down menu, update the description, and click Save Note. A dialog will prompt you to overwrite the existing note - check that it is a good change, and click OK.

If you wish to remove a note, select it in the dropdown menu, and click Remove.

8. Memory Bookmarkslink

When you click on the Open Memory Bookmarker button you'll see this dialog:

memoryinspector-bookmark jpg

With this, you can view multiple designated addresses at once instead of having to shuffle around in the Inspector.

The bookmarks can be renamed by double-clicking their description. If you double-click on the address, you can move straight to that point in the Mem Inspector.

Bookmarked addresses will show in the Memory Inspector as green. From here you can also Freeze any bookmarks.

This is helpful for things like health or consumables. Frozen values can be manipulated directly from the inspector. Keep in mind, freezing occurs 1 frame after gameplay. This means even when frozen, the value will change for atleast one frame before returning to the frozen value. These will always be displayed as yellow.

Comments