cheatengine 5.8.27 → 5.8.29

package/README.md

@@ -25,7 +25,7 @@ AI <--MCP/JSON-RPC--> ce_mcp_server.js <--Named Pipe--> ce_mcp_bridge.lua (CE)
      dofile([[D:\path\to\ce_mcp_bridge.lua]])
      ```
 
-3. **Configure MCP** (`.kiro/settings/mcp.json`):
+3. **Configure MCP** :
    ```json
    {
      "mcpServers": {
@@ -157,17 +157,19 @@ Write a value to memory.
 
 ### Scanning & Search
 
-#### `ce_aob_scan(aob_string, module?, protection?, max_results?)`
+#### `ce_aob_scan(aob_string, module?, protection?, start?, stop?, max_results?)`
 Scan memory for Array of Bytes pattern. Supports `??` wildcards.
 
 **Parameters:**
 - `aob_string` (string, required): Pattern like `"48 89 5C 24 ?? 48 83 EC 20"`
 - `module` (string, optional): Limit scan to module (e.g. `"game.exe"`)
 - `protection` (string, optional): Memory protection flags (default: `"-C+X"`)
+- `start` (string, optional): Start address if module not specified
+- `stop` (string, optional): Stop address if module not specified
 - `max_results` (integer, optional): Maximum results (default: 100)
 
 #### `ce_value_scan(value, type, module?, protection?)`
-Scan for a specific value. Useful for pointer tracing. **One-shot scan - for iterative scanning use Scan Sessions.**
+Scan for a specific value. Useful for pointer tracing. Auto-aligns scan based on type for performance. **One-shot scan - for iterative scanning use Scan Sessions.**
 
 **Parameters:**
 - `value` (string, required): Value to search (e.g. `"0x255D5E758"` or `"12345"`)
@@ -182,7 +184,7 @@ Scan for a specific value. Useful for pointer tracing. **One-shot scan - for ite
 Implements CE's core "First Scan → Next Scan" workflow with session management. Sessions auto-expire after 5 minutes of inactivity.
 
 #### `ce_scan_new(value, type, module?, protection?)`
-Start a new scan session.
+Start a new scan session. Auto-aligns scan based on type for performance (4-byte for dword/float, 8-byte for qword/double).
 
 #### `ce_scan_next(session_id, value, scan_type?, value2?)`
 Continue scanning (filter) an existing session.

package/README_CN.md

@@ -7,7 +7,7 @@ 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)
                            ↑
                   后台自动重连
 ```
@@ -16,7 +16,7 @@ AI <--MCP/JSON-RPC--> ce_mcp_server.py <--命名管道--> 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\`)
@@ -25,7 +25,7 @@ AI <--MCP/JSON-RPC--> ce_mcp_server.py <--命名管道--> ce_mcp_bridge.lua (CE)
      dofile([[D:\path\to\ce_mcp_bridge.lua]])
      ```
 
-3. **配置 MCP** (`.kiro/settings/mcp.json`):
+3. **配置 MCP** :
    ```json
    {
      "mcpServers": {
@@ -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"]
     }
   }
 }
@@ -157,17 +157,19 @@ Hook 名称现在会验证以防止 AA 脚本注入:
 
 ### 扫描与搜索
 
-#### `ce_aob_scan(aob_string, module?, protection?, max_results?)`
+#### `ce_aob_scan(aob_string, module?, protection?, start?, stop?, max_results?)`
 扫描内存中的字节数组模式。支持 `??` 通配符。
 
 **参数:**
 - `aob_string` (string, 必需): 模式如 `"48 89 5C 24 ?? 48 83 EC 20"`
 - `module` (string, 可选): 限制扫描到模块 (如 `"game.exe"`)
 - `protection` (string, 可选): 内存保护标志 (默认: `"-C+X"`)
+- `start` (string, 可选): 起始地址（未指定 module 时使用）
+- `stop` (string, 可选): 结束地址（未指定 module 时使用）
 - `max_results` (integer, 可选): 最大结果数 (默认: 100)
 
 #### `ce_value_scan(value, type, module?, protection?)`
-扫描特定值。用于指针追踪。**一次性扫描 - 迭代扫描请使用扫描会话。**
+扫描特定值。用于指针追踪。根据类型自动对齐扫描以优化性能。**一次性扫描 - 迭代扫描请使用扫描会话。**
 
 **参数:**
 - `value` (string, 必需): 要搜索的值 (如 `"0x255D5E758"` 或 `"12345"`)
@@ -182,7 +184,7 @@ Hook 名称现在会验证以防止 AA 脚本注入:
 实现 CE 核心的 "首次扫描 → 再次扫描" 工作流，带会话管理。会话在 5 分钟不活动后自动过期。
 
 #### `ce_scan_new(value, type, module?, protection?)`
-开始新的扫描会话。
+开始新的扫描会话。根据类型自动对齐扫描以优化性能（dword/float 用 4 字节对齐，qword/double 用 8 字节对齐）。
 
 #### `ce_scan_next(session_id, value, scan_type?, value2?)`
 继续扫描（过滤）现有会话。

package/ce_mcp_bridge.lua

@@ -1500,46 +1500,9 @@ Handlers.execute_lua = function(p)
     local ok, result = pcall(fn)
     if not ok then error("Runtime error: " .. tostring(result)) end
     return { result = result }
-end
-
-Handlers.get_selected_address = function()
-    local mv = getMemoryViewForm()
-    if mv then
-        local dv = mv.DisassemblerView
-        if dv and dv.SelectedAddress then
-            return { address = Utils.formatHex(dv.SelectedAddress) }
-        end
-    end
-    error("No address selected in Memory View")
-end
-
--- Handler: get_logs - Retrieve log entries with filtering
-Handlers.get_logs = function(p)
-    local count = p.count or 100
-    local minLevel = p.min_level or p.minLevel or LogLevel.DEBUG
-
-    -- Convert string level to number if needed
-    if type(minLevel) == "string" then
-        local levelMap = {
-            debug = LogLevel.DEBUG,
-            info = LogLevel.INFO,
-            warn = LogLevel.WARN,
-            error = LogLevel.ERROR
-        }
-        minLevel = levelMap[minLevel:lower()] or LogLevel.DEBUG
-    end
-
-    local entries = Logger.getEntries(count, minLevel)
-    local stats = Logger.getStats()
-
-    return {
-        entries = entries,
-        count = #entries,
-        stats = stats
-    }
-end
-
--- Handler: stats - Return comprehensive execution statistics
+end
+
+-- Handler: stats - Return comprehensive execution statistics
 Handlers.stats = function(p)
     local metrics = Metrics.getSummary()
     local logStats = Logger.getStats()
@@ -7473,9 +7436,8 @@ local SYNC_COMMANDS = {
     register_symbol = true,
     unregister_symbol = true,
     allocate_memory = true,
-    execute_lua = true,
-    get_selected_address = true,
-    -- Hook commands
+    execute_lua = true,
+    -- Hook commands
     hook_function = true,
     unhook_function = true,
     -- Emulation commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cheatengine",
-  "version": "5.8.27",
+  "version": "5.8.29",
   "description": "Cheat Engine MCP Server - AI-assisted reverse engineering bridge",
   "main": "ce_mcp_server.js",
   "bin": {

package/src/tool-registry.js

@@ -1,6 +1,6 @@
 /**
  * Tool Registry for MCP Tools
- * Defines all 60+ tools available in the Cheat Engine MCP Bridge
+ * Defines all 55 tools available in the Cheat Engine MCP Bridge
  */
 
 const ToolCategory = {
@@ -108,32 +108,12 @@ class ToolRegistry {
 
     this._register(new Tool(
       'ce_execute_lua',
-      'Execute raw Lua code in CE',
+      'Execute Lua code with full access to CE APIs. Returns {result}.',
       'execute_lua',
       ToolCategory.SYSTEM,
       [new ToolParam('code', 'string', 'Lua code to execute', true)]
     ));
 
-    this._register(new Tool(
-      'ce_get_selected_address',
-      'Get the currently selected address in CE Memory View/Disassembler',
-      'get_selected_address',
-      ToolCategory.SYSTEM
-    ));
-
-    this._register(new Tool(
-      'ce_get_logs',
-      'Get log entries from the Cheat Engine MCP Bridge Lua side. ' +
-      'Returns: {entries: [{timestamp, level, category, message, data}], count}. ' +
-      'Useful for debugging and monitoring bridge operations.',
-      'get_logs',
-      ToolCategory.SYSTEM,
-      [
-        new ToolParam('count', 'integer', 'Maximum number of log entries to return (default: 100)', false, 100),
-        new ToolParam('min_level', 'integer', 'Minimum log level to include: 1=DEBUG, 2=INFO, 3=WARN, 4=ERROR (default: 1)', false, 1),
-      ]
-    ));
-
     this._register(new Tool(
       'ce_list_processes',
       'List running processes. Use before ce_attach_process to find available targets. ' +