Home

Awesome

ram-watch-cheat-engine

<img src="screenshot.png" width="800" />

Sample videos:

Overview

RAM watch is a powerful tool for researching games - for modding, speedrunning, writing cheat codes, or just generally learning how the game works.

The tool-assisted speedrun community makes extensive use of RAM watch on emulated games. The most popular Gamecube/Wii emulator is Dolphin, and so far, Cheat Engine has been the most popular RAM watch solution for Dolphin. Here's a nice tutorial by aldelaro on using Cheat Engine with Dolphin.

In addition to supporting RAM viewing, searching, and editing, Cheat Engine also includes a Lua scripting engine. This opens up many more possibilities for boosting research productivity, including:

This repository contains:

Game compatibility

The main focus of the framework is on games running in Dolphin emulator. Most disc-based Gamecube and Wii games will work in this framework. Any games included in this repository's games folder are confirmed to work.

The start-address calculation used in this framework doesn't work for every Dolphin game. In particular, many Virtual Console and WiiWare games will not work, and there may be a few disc-based Gamecube/Wii games using advanced memory features which won't work here. We need to resolve issue #4 to support these games.

The framework can also be used for PC games and other emulators. If the start address changes in those games, though, then you'll have to figure out the address calculation yourself.

Requirements

Windows, Mac, or Linux. Cheat Engine and Dolphin are supported on all of these platforms, though Windows is probably easiest for Cheat Engine. Also, the tutorial here assumes Windows, but the explanations shouldn't change that much between platforms.

No programming or Lua experience is required for the first few tutorial sections. For the later sections on writing your own displays and game scripts, some programming experience will make it easier, but the tutorial attempts to walk through things slowly for beginners.

Getting started

Go through the Tutorial until you've got enough knowledge to do your game research.

Here's the first tutorial section: Get a RAM watch script up and running.

As a general recommendation, it's okay to skip doing a tutorial section if it doesn't really apply to you, but reading the sections you skip is probably still a good idea.

Support

If you're having problems before even touching the Lua code, you might want to read aldelaro's tutorial on using Cheat Engine with Dolphin.

If you're getting Lua errors or the Lua script isn't doing what you expect, try the troubleshooting and debugging page.

If you've got a question, problem, error message, etc. that you want to ask about, try this TASvideos forum thread. Note: In the Lua Engine window, the latest Lua error appears BELOW previous errors.

If you've got more of a suggestion or request, or you think you've found a bug, it might fit better in the GitHub issues section. In general, though, feel free to post at either GitHub or TASvideos.

I encourage asking questions publicly with the methods above so others can learn too, but messaging me (yoshifan) directly is fine too. Feel free to contact me on Twitter or Discord, send a TASvideos PM, or whatever is convenient.

Disclaimer

Cheat Engine is a powerful tool, so don't be too careless when using it. For example, if you ever attempt to edit memory (such as when using the F-Zero GX stat-editing layouts), make extra sure that you've selected the Dolphin.exe process in Cheat Engine, and not some other process on your computer.

The primary authors of this GitHub repository are not affiliated with Dolphin, Cheat Engine, or the companies behind the games mentioned here.

Credits

Masterjun, for writing the Dolphin + Cheat Engine RAM watch script that this project was based on: http://tasvideos.org/forum/viewtopic.php?t=14379 (2013.08.26)

Tales, for providing the Sonic Adventure DX and Sonic Adventure 2: Battle scripts that were added to this repository (with slight modifications).

aldelaro, for the Dolphin + Cheat Engine tutorial I've linked a few times in these docs.