Skip to content

Releases

CheatEngine.Mcp 2.0.0-beta.4

Pre-release

Choose a tag to compare

@ShadowNineX ShadowNineX released this 16 Oct 18:29
0866b6e

CheatEngine.Mcp 2.0.0-beta.4

This Windows x64 prerelease updates the Client/SDK dependencies, fixes two tool adapters and expands automated coverage across the complete MCP catalog. Download CheatEngine.Mcp-2.0.0-beta.4-win-x64.zip and verify it with SHA256SUMS.txt. The ZIP contains the single plugin DLL, matching gateway executable, installation instructions and licenses.

Changes since beta.3

  • Updated CheatEngine.Client to 1.1.0 and CheatEngine.SDK to 2.0.1, including regenerated normal and Native AOT dependency locks.
  • Fixed code_get_comments so its address array reaches Lua as one argument, and fixed process_list_threads to use CE's documented zero-based StringList indexer.
  • Added catalog-derived routing/refusal checks for every backend tool, positive adapter evidence for all 193 backend tools, and gateway-local discovery checks. New catalog entries must have reviewed adapter-test mappings.
  • Expanded standalone Lua adapter tests and execution-argument, conversion/calculation and pointer-file boundary, failure and cleanup tests.
  • Added a bounded live workflow scenario that tests target, gateway and host restarts independently of the unresolved plugin reload bridge.
  • Preserved the latest test-platform package updates from main.

Validation and known limits

The recorded automated baseline passes 5,314 portable tests in both Debug and Release and 651 standalone Lua tests, with no failures or skips. Combined coverage reaches 94.50% of instrumented handwritten product C# lines, including 94.37% in Tools. This C# percentage does not measure embedded Lua branch coverage or native CE behavior.

The release pipeline checks the isolated bundled DLL, reflected catalog, Native AOT gateway smoke responses, ZIP contents and checksums. Native evidence for 37 backend tools comes from the separately identified private dependency-refresh candidate recorded in the all-tool qualification report; it does not qualify newly rebuilt release bytes. Another 156 backend tools still need native success fixtures, and same-process plugin reload remains unqualified. SDK provider-stack guards reject invalid states; the original intermittent dispatcher corruption was investigated, but its root cause remains unresolved. This beta is not stable v2.0.0 sign-off.

Installation, upgrade and rollback

Use Cheat Engine 7.7 x64 with the x64 .NET 10, ASP.NET Core 10 and Windows Desktop 10 runtimes. The gateway is self-contained. All four optional execution capabilities remain enabled by default; configure their exposure for your setup. The recorded bounded native workflows explicitly disabled them.

Back up the previous matching plugin/gateway pair, configuration and CE settings. Disable the plugin and close CE and the gateway before extracting beta.4 into a new folder. Install CheatEngine.Mcp.dll, point the MCP client at the matching CheatEngine.Mcp.Gateway.exe, then use instance_list to discover a fresh instance ID. Keep both binaries from the same ZIP. To roll back, close both processes and restore the previous matching pair and registration. See the recovery guide for locked files and partial upgrades.

CheatEngine.Mcp 2.0.0-beta.3

Pre-release

Choose a tag to compare

@ShadowNineX ShadowNineX released this 11 Oct 13:05
059f249

CheatEngine.Mcp 2.0.0-beta.3

This Windows x64 prerelease adds the MCP roadmap work since beta.2. Download CheatEngine.Mcp-2.0.0-beta.3-win-x64.zip and verify it with SHA256SUMS.txt. The ZIP contains the single Cheat Engine plugin DLL, the matching gateway executable, installation instructions, and licenses.

Changes since beta.2

  • Added bounded pointer access analysis and pointer-chain validation, plus an explicit C# compile-and-export tool. Compilation does not inject the result.
  • Added prepared module, region, thread, symbol, and breakpoint navigation resources. Call the corresponding explicit enumeration tool first; stale or target-mismatched snapshots are refused. Full CE enumeration can still block regardless of result limits.
  • Bounded structure lookup and element paging, fixed thread-list ownership, and retained failed pointer-search cleanup reservations.
  • Improved effect metadata, unavailable-field handling, error correlation, packaged catalog checks, and Debug/Release portable CI coverage.
  • Removed the prerelease exports resource URI; call module_list_exports explicitly. Clients should handle omitted unavailable fields and prepare navigation snapshots before reading them.

Support and known limits

The plugin runs in Cheat Engine 7.7 x64 and needs the x64 .NET 10, ASP.NET Core 10, and Windows Desktop 10 runtimes. The x64 gateway is self-contained. The four optional execution capabilities remain enabled by default; configure their exposure for your own setup. See the support matrix for details.

Portable tests, package checks, and the gateway smoke test do not establish live Cheat Engine qualification. An intermittent native Lua dispatch corruption and an empty Settings plugin-list failure remain unresolved. The new standalone navigation/Settings Lua cases and the broader live lifecycle, performance, install/upgrade, and rollback checks have not run on this release candidate. This prerelease is not the stable v2.0.0 sign-off; qualification status records the remaining work.

Upgrade and rollback

Keep a backup of the existing matching plugin and gateway, your configuration, and CE settings. Disable the plugin, close Cheat Engine and the gateway, then install both beta.3 files from this ZIP in a new folder. Replace only this plugin's old CE entry if its path changed, point your MCP client at the new gateway, and discover a fresh instanceId with instance_list. Do not mix beta.2 and beta.3 files. To roll back, close both processes and restore the previous matching pair and registration. The recovery guide covers locked files and partial upgrades.

CheatEngine.Mcp 2.0.0-beta.2

Pre-release

Choose a tag to compare

@ShadowNineX ShadowNineX released this 30 Sep 15:39
c51a0ec

CheatEngine.Mcp 2.0.0-beta.2

Windows x64 beta for Cheat Engine 7.7, built from c51a0ec.

Downloads

Download CheatEngine.Mcp-2.0.0-beta.2-win-x64.zip and extract it into a permanent folder. This is the complete distribution:

  • CheatEngine.Mcp.dll: the single Cheat Engine plugin DLL, containing its managed dependencies and native Lua bridge.
  • CheatEngine.Mcp.Gateway.exe: the separate, standalone stdio MCP gateway.
  • README.md: installation, configuration, updating, and connection instructions.
  • LICENSE and THIRD-PARTY-NOTICES.md: licenses for the project and bundled dependencies.

SHA256SUMS.txt contains the ZIP's SHA-256 checksum. GitHub's automatically generated source archives are for building from source.

Install and connect

  1. Install the Windows x64 .NET 10 frameworks required by Cheat Engine's managed host and the plugin: Microsoft.NETCore.App, Microsoft.AspNetCore.App, and Microsoft.WindowsDesktop.App. Follow the included README to configure Cheat Engine's ce.runtimeconfig.json.
  2. In Cheat Engine, open Edit > Settings > Plugins, add CheatEngine.Mcp.dll from the extracted folder, and enable it.
  3. Configure your AI application's stdio MCP server command to the full path of CheatEngine.Mcp.Gateway.exe.
  4. Call instance_list, then use the returned instanceId for calls to that Cheat Engine instance. One gateway supports multiple enabled Cheat Engine instances.

The gateway is a standalone Native AOT executable. The plugin requires the installed .NET frameworks. Costura extracts its embedded native Lua bridge into a per-user cache when loading it.

Operator guidance is provided through MCP resources and workflow prompts. No separate skill installation is required. Defaults are built in; the included README explains optional JSON settings and file-access roots.

To update an earlier installation, close Cheat Engine and the gateway before replacing the files. Add the new DLL plugin entry and preserve personal configuration in the user data directory.

Packaging improvements

  • Install the plugin as one DLL, with the gateway kept as its own executable.
  • Releases use one complete ZIP and a checksum file, produced and verified by eng/Release.ps1.
  • Bundled dependencies remain isolated between plugin load contexts.
  • The regression probe compares the bundled plugin's reflected tools, schemas, resources, and prompts with the reviewed MCP contract.

Validation

Debug and Release portable suites passed with 3,968 tests each, zero failures, and zero skips. The published DLL passed fresh-process loading, native bridge resolution, dependency isolation, and reflection checks in two load contexts. The Native AOT gateway passed its executable MCP smoke check.

Earlier live qualification exercised a focused two-instance Cheat Engine scenario. This beta does not claim live coverage of every exposed tool, every debugger backend, or DBVM. Use the plugin only with software you own or are authorized to inspect or modify.

CheatEngine.Mcp 2.0.0-beta.1

Pre-release

Choose a tag to compare

@ShadowNineX ShadowNineX released this 27 Sep 15:10
93d19d0

CheatEngine.Mcp 2.0.0-beta.1

First public beta of the CheatEngine.Client-based MCP plugin and gateway for Windows x64.

Download

Recommended: CheatEngine.Mcp-2.0.0-beta.1-win-x64.zip. It contains:

  • CheatEngine.Mcp.dll: the CE plugin with its bundled managed dependencies and native bridge.
  • CheatEngine.Mcp.Gateway.exe: the self-contained stdio MCP gateway.
  • skills/cheatengine-mcp/: the separate optional AI skill, tool catalog, and operator guides.
  • INSTALL.md, README.md, appsettings.example.json, licenses, SHA256SUMS.txt, and VALIDATION.json.

The DLL and EXE are also attached individually. CheatEngine.Mcp-skill-2.0.0-beta.1.zip
contains the standalone skill folder. The release-level SHA256SUMS.txt covers all four assets.
GitHub's automatically generated source archives contain source code, not these prebuilt binaries.

Install

  1. Extract the complete Windows x64 ZIP into a stable directory.
  2. Install the x64 .NET 10, ASP.NET Core 10, and Windows Desktop 10 runtimes, then configure CE's ce.runtimeconfig.json for .NET 10 as shown in the README.
  3. In Cheat Engine 7.7 x64, add and enable CheatEngine.Mcp.dll under Edit > Settings > Plugins. Preserve its filename. Look for "MCP: Enabled" in CE's menu.
  4. Configure your AI client's stdio MCP server command to point to CheatEngine.Mcp.Gateway.exe. For Codex: codex mcp add cheatengine -- "C:\Tools\CheatEngine.Mcp\CheatEngine.Mcp.Gateway.exe" (adjust the path), then restart the client/session.
  5. Optionally copy the complete skills/cheatengine-mcp folder to your AI client's skill directory. For Codex: %USERPROFILE%\.agents\skills\cheatengine-mcp.

No SDK or source build is needed for the prebuilt download. Cheat Engine and its host
runtimes are not included. The gateway includes its own runtime. See the included
INSTALL.md and the full installation guide.

Included workflows

  • One MCP connection routing to multiple explicit Cheat Engine instances.
  • Process attachment, memory reads/writes, address-list editing, freezing, and speedhack controls.
  • Value scans synchronized with CE's visible scan tab, plus independent named scanners.
  • Pointer snapshots/rescans, disassembly, debugger captures, Lua, and Auto Assembler tools.
  • JSON configuration and a visible enabled/disabled backend status in Cheat Engine.

Validation

  • Release build: zero warnings and errors.
  • Unit, transport, and native Lua tests: 211 passed, 0 failed, 0 skipped.
  • Live qualification of the exact attached DLL and EXE on CE 7.7.1.10828: 1 passed, 0 failed, 0 skipped.
  • The live scenario used two private CE instances and separate disposable targets through one gateway. It checked discovery, loaded paths, memory operations, address-list freeze/unfreeze, speedhack readback, visible/independent scanner isolation, disassembly, and shutdown isolation.
  • CE user settings were restored, the installed CE source was unchanged, and cleanup reported no failures.
  • Bundle writer and style/whitespace checks passed. Binary hashes and test scope are included in VALIDATION.json.

Beta limitations

This is a prerelease for testing. Validation does not cover every exposed tool,
every MCP client, clean-machine installation, all debugger backends, or DBVM.
Speedhack readback does not establish timing accuracy. Pointer maps are bounded MCP
snapshots, not CE's native pointer-map files. The main scanner retains CE's visible
memory range and filtering options.

CE 7.7's VEH debugger crashed during an observed second attachment to the same target.
MCP guards that sequence; restart the target before reattaching. See the included
scanning-and-debugging guide. Lua, Auto Assembler, and dedicated mutation tools are
enabled by default; explicit configuration can disable Lua or Auto Assembler.

Source commit: 93d19d0.