cheatengine 5.8.15 → 5.8.17

package/README.md

@@ -7,7 +7,7 @@ MCP bridge enabling AI assistants to directly control Cheat Engine for game hack
 ## Architecture
 
 ```
-AI <--MCP/JSON-RPC--> ce_mcp_server.py <--Named Pipe--> ce_mcp_bridge.lua (CE)
+AI <--MCP/JSON-RPC--> ce_mcp_server.js <--Named Pipe--> ce_mcp_bridge.lua (CE)
                            ↑
                   Background auto-reconnect
 ```
@@ -16,7 +16,7 @@ AI <--MCP/JSON-RPC--> ce_mcp_server.py <--Named Pipe--> ce_mcp_bridge.lua (CE)
 
 ### Quick Start (NPX) - Recommended
 
-1. **Install Dependencies**: `pip install pywin32`
+1. **Prerequisites**: Node.js 14+ (no other dependencies needed)
 
 2. **Load in CE** (choose one):
    - **Auto-load**: Copy `ce_mcp_bridge.lua` to CE's `autorun` folder (e.g. `D:\Cheat Engine\autorun\`)
@@ -45,8 +45,8 @@ If you prefer to run from source:
 {
   "mcpServers": {
     "cheat-engine": {
-      "command": "python",
-      "args": ["D:/path/to/ce_mcp/ce_mcp_server.py"]
+      "command": "node",
+      "args": ["D:/path/to/ce_mcp/ce_mcp_server.js"]
     }
   }
 }
@@ -384,45 +384,45 @@ Add a new record to Cheat Table.
 ## Recommended Workflows
 
 ### Pointer Tracing
-```python
-# Automatic (preferred)
-result = ce_find_pointer_path(address="0x255D5E758")
-# Returns: base_address, offsets, ce_pointer_notation
-
-# Manual (if automatic fails)
-# 1. Find what accesses the address
-accesses = ce_find_what_accesses(address="0x255D5E758")
-# 2. Get register value (e.g., rcx = 0x255D5E658)
-# 3. Search for pointer storing that value
-pointers = ce_value_scan(value="0x255D5E658", type="qword")
-# 4. Repeat until finding game.exe+offset
+```json
+// Automatic (preferred)
+{"name": "ce_find_pointer_path", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// Returns: base_address, offsets, ce_pointer_notation
+
+// Manual (if automatic fails)
+// 1. Find what accesses the address
+{"name": "ce_find_what_accesses", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// 2. Get register value from result (e.g., RBX=0x255D5E658)
+// 3. Search for pointer storing that value
+{"name": "ce_value_scan", "arguments": {"value": "0x255D5E658", "type": "qword"}}
+// 4. Repeat until finding game.exe+offset
 ```
 
 ### Function Analysis
-```python
-# 1. Find function boundaries
-bounds = ce_find_function_boundaries(address="0x14587EDB0")
+```json
+// 1. Find function boundaries
+{"name": "ce_find_function_boundaries", "arguments": {"address": "0x14587EDB0"}}
 
-# 2. Trace execution
-trace = ce_break_and_trace(address="0x14587EDB0", max_steps=100)
+// 2. Trace execution
+{"name": "ce_break_and_trace", "arguments": {"address": "0x14587EDB0", "max_steps": 100}}
 
-# 3. Generate signature for updates
-sig = ce_generate_signature(address="0x14587EDB0")
+// 3. Generate signature for updates
+{"name": "ce_generate_signature", "arguments": {"address": "0x14587EDB0"}}
 ```
 
 ### Reverse Engineering Unknown Code
-```python
-# 1. Disassemble
-code = ce_disassemble(address="0x14587EDB0", count=20)
+```json
+// 1. Disassemble
+{"name": "ce_disassemble", "arguments": {"address": "0x14587EDB0", "count": 20}}
 
-# 2. Symbolic trace to understand logic
-symbolic = ce_symbolic_trace(address="0x14587EDB0", initial_state={"rcx": "this"})
+// 2. Symbolic trace to understand logic
+{"name": "ce_symbolic_trace", "arguments": {"address": "0x14587EDB0", "initial_state": {"rcx": "this"}}}
 
-# 3. Build CFG for complex functions
-cfg = ce_build_cfg(address="0x14587EDB0")
+// 3. Build CFG for complex functions
+{"name": "ce_build_cfg", "arguments": {"address": "0x14587EDB0"}}
 
-# 4. Detect patterns
-patterns = ce_detect_patterns(address="0x14587EDB0")
+// 4. Detect patterns
+{"name": "ce_detect_patterns", "arguments": {"address": "0x14587EDB0"}}
 ```
 
 ---

package/README_CN.md

@@ -7,16 +7,16 @@ MCP 桥接器，让 AI 助手直接控制 Cheat Engine 进行游戏修改和逆
 ## 架构
 
 ```
-AI <--MCP/JSON-RPC--> ce_mcp_server.py <--命名管道--> ce_mcp_bridge.lua (CE)
+AI <--MCP/JSON-RPC--> ce_mcp_server.js <--命名管道--> ce_mcp_bridge.lua (CE)
                            ↑
-                  后台自动重连
+                   后台自动重连
 ```
 
 ## 安装
 
 ### 快速开始 (NPX) - 推荐
 
-1. **安装依赖**: `pip install pywin32`
+1. **环境要求**: Node.js 14+ (无需其他依赖)
 
 2. **在 CE 中加载** (二选一):
    - **自动加载**: 将 `ce_mcp_bridge.lua` 复制到 CE 的 `autorun` 文件夹 (如 `D:\Cheat Engine\autorun\`)
@@ -45,8 +45,8 @@ AI <--MCP/JSON-RPC--> ce_mcp_server.py <--命名管道--> ce_mcp_bridge.lua (CE)
 {
   "mcpServers": {
     "cheat-engine": {
-      "command": "python",
-      "args": ["D:/path/to/ce_mcp/ce_mcp_server.py"]
+      "command": "node",
+      "args": ["D:/path/to/ce_mcp/ce_mcp_server.js"]
     }
   }
 }
@@ -384,45 +384,45 @@ Hook 函数以拦截调用并捕获参数。
 ## 推荐工作流
 
 ### 指针追踪
-```python
-# 自动 (首选)
-result = ce_find_pointer_path(address="0x255D5E758")
-# 返回: base_address, offsets, ce_pointer_notation
-
-# 手动 (自动失败时)
-# 1. 查找访问该地址的代码
-accesses = ce_find_what_accesses(address="0x255D5E758")
-# 2. 获取寄存器值 (如 rcx = 0x255D5E658)
-# 3. 搜索存储该值的指针
-pointers = ce_value_scan(value="0x255D5E658", type="qword")
-# 4. 重复直到找到 game.exe+offset
+```json
+// 自动 (首选)
+{"name": "ce_find_pointer_path", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// 返回: base_address, offsets, ce_pointer_notation
+
+// 手动 (自动失败时)
+// 1. 查找访问该地址的代码
+{"name": "ce_find_what_accesses", "arguments": {"address": "0x255D5E758", "user_prompted": true}}
+// 2. 从结果获取寄存器值 (如 RBX=0x255D5E658)
+// 3. 搜索存储该值的指针
+{"name": "ce_value_scan", "arguments": {"value": "0x255D5E658", "type": "qword"}}
+// 4. 重复直到找到 game.exe+offset
 ```
 
 ### 函数分析
-```python
-# 1. 查找函数边界
-bounds = ce_find_function_boundaries(address="0x14587EDB0")
+```json
+// 1. 查找函数边界
+{"name": "ce_find_function_boundaries", "arguments": {"address": "0x14587EDB0"}}
 
-# 2. 跟踪执行
-trace = ce_break_and_trace(address="0x14587EDB0", max_steps=100)
+// 2. 跟踪执行
+{"name": "ce_break_and_trace", "arguments": {"address": "0x14587EDB0", "max_steps": 100}}
 
-# 3. 生成特征码用于更新
-sig = ce_generate_signature(address="0x14587EDB0")
+// 3. 生成特征码用于更新
+{"name": "ce_generate_signature", "arguments": {"address": "0x14587EDB0"}}
 ```
 
 ### 逆向未知代码
-```python
-# 1. 反汇编
-code = ce_disassemble(address="0x14587EDB0", count=20)
+```json
+// 1. 反汇编
+{"name": "ce_disassemble", "arguments": {"address": "0x14587EDB0", "count": 20}}
 
-# 2. 符号跟踪理解逻辑
-symbolic = ce_symbolic_trace(address="0x14587EDB0", initial_state={"rcx": "this"})
+// 2. 符号跟踪理解逻辑
+{"name": "ce_symbolic_trace", "arguments": {"address": "0x14587EDB0", "initial_state": {"rcx": "this"}}}
 
-# 3. 为复杂函数构建 CFG
-cfg = ce_build_cfg(address="0x14587EDB0")
+// 3. 为复杂函数构建 CFG
+{"name": "ce_build_cfg", "arguments": {"address": "0x14587EDB0"}}
 
-# 4. 检测模式
-patterns = ce_detect_patterns(address="0x14587EDB0")
+// 4. 检测模式
+{"name": "ce_detect_patterns", "arguments": {"address": "0x14587EDB0"}}
 ```
 
 ---