cheatengine 5.8.27 → 5.8.28

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/package.json

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