# CE-MCP-Plugin **Repository Path**: htqs_admin/CE-MCP-Plugin ## Basic Information - **Project Name**: CE-MCP-Plugin - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: CE-MCP-Plugin - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-11 - **Last Updated**: 2026-09-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # CE-MCP-Plugin Cheat Engine MCP (Memory Cheat Plugin) - AI Integration Plugin for Cheat Engine ## 项目简介 CE-MCP-Plugin是一个为Cheat Engine开发的AI集成插件，允许Cheat Engine与外部AI工具建立稳定连接，接收并执行AI发送的指令。该插件为Cheat Engine提供了AI驱动的内存修改和游戏作弊功能。 ## 功能特性 ### AI连接功能 - 与AI服务器建立TCP连接 - 支持接收和解析AI指令 - 支持通过Lua脚本向AI发送命令 - 异步通信设计，不阻塞Cheat Engine主界面 ### 指令支持 本插件支持**75个命令**，涵盖以下功能类别： #### 基础功能 - **SHOW_MESSAGE**: 显示消息框 - **PAUSE_PROCESS**: 暂停目标进程 - **UNPAUSE_PROCESS**: 恢复目标进程 #### 内存操作 - **READ_MEMORY**: 读取内存，格式：`READ_MEMORY:address,type` - **WRITE_MEMORY**: 写入内存，格式：`WRITE_MEMORY:address,value,type` - **FREEZE_MEMORY**: 冻结内存，格式：`FREEZE_MEMORY:address,size` - **UNFREEZE_MEMORY**: 解冻内存，格式：`UNFREEZE_MEMORY:freeze_id` - **FIX_MEMORY**: 修复内存，格式：`FIX_MEMORY` #### 汇编与反汇编 - **AUTO_ASSEMBLE**: 执行自动汇编脚本 - **ASSEMBLE**: 汇编指令，格式：`ASSEMBLE:address,instruction` - **DISASSEMBLE**: 反汇编指令，格式：`DISASSEMBLE:address` - **DISASSEMBLE_EX**: 增强反汇编指令，提供更详细的指令信息，格式：`DISASSEMBLE_EX:address` #### 寄存器操作 - **CHANGE_REGISTER**: 修改寄存器，格式：`CHANGE_REGISTER:address,register_name,value` #### DLL注入 - **INJECT_DLL**: 注入DLL，格式：`INJECT_DLL:dll_path,optional_function_name` #### 进程管理 - **PROCESS_LIST**: 获取进程列表，格式：`PROCESS_LIST` - **GET_PROCESS_ID**: 根据进程名获取进程ID，格式：`GET_PROCESS_ID:process_name` - **OPEN_PROCESS**: 打开进程，格式：`OPEN_PROCESS:process_id` #### 变速齿轮 - **SPEEDHACK**: 设置游戏速度，格式：`SPEEDHACK:speed_value` #### 高级功能 - **GET_ADDRESS_FROM_POINTER**: 通过基址和偏移获取最终地址 - **ADDRESS_TO_NAME**: 将地址转换为符号名称 - **NAME_TO_ADDRESS**: 将符号名称转换为地址 - **PREVIOUS_OPCODE**: 获取指定地址的前一条指令 - **NEXT_OPCODE**: 获取指定地址的下一条指令 - **SET_BREAKPOINT**: 设置断点 - **REMOVE_BREAKPOINT**: 移除断点 - **CONTINUE_FROM_BREAKPOINT**: 从断点继续执行 #### 内存表管理（18个命令） - **CREATE_TABLE_ENTRY**: 创建新的内存表条目 - **GET_TABLE_ENTRY**: 获取内存表条目 - **SET_ENTRY_DESCRIPTION**: 设置条目描述 - **GET_ENTRY_DESCRIPTION**: 获取条目描述 - **SET_ENTRY_ADDRESS**: 设置条目地址 - **GET_ENTRY_ADDRESS**: 获取条目地址 - **SET_ENTRY_TYPE**: 设置条目类型 - **GET_ENTRY_TYPE**: 获取条目类型 - **SET_ENTRY_VALUE**: 设置条目值 - **GET_ENTRY_VALUE**: 获取条目值 - **SET_ENTRY_SCRIPT**: 设置条目脚本 - **GET_ENTRY_SCRIPT**: 获取条目脚本 - **SET_ENTRY_COLOR**: 设置条目颜色 - **FREEZE_ENTRY**: 冻结条目 - **UNFREEZE_ENTRY**: 解冻条目 - **IS_ENTRY_FROZEN**: 检查条目是否冻结 - **MEMREC_APPENDTOENTRY**: 追加到条目 - **DELETE_ENTRY**: 删除条目 #### 窗口管理（11个命令） - **GET_MAIN_WINDOW_HANDLE**: 获取主窗口句柄 - **HIDE_ALL_CE_WINDOWS**: 隐藏所有CE窗口 - **UNHIDE_MAIN_CE_WINDOW**: 显示主CE窗口 - **MESSAGE_DIALOG**: 显示消息对话框 - **CLOSE_CE**: 关闭Cheat Engine - **FORM_CENTER_SCREEN**: 表单居中 - **FORM_HIDE**: 隐藏表单 - **FORM_SHOW**: 显示表单 - **IMAGE_LOAD_IMAGE_FROM_FILE**: 从文件加载图像 - **IMAGE_TRANSPARENT**: 设置图像透明度 - **IMAGE_STRETCH**: 拉伸图像 #### UI控件管理（13个命令） - **CREATE_PANEL**: 创建面板 - **CREATE_BUTTON**: 创建按钮 - **CREATE_LABEL**: 创建标签 - **CREATE_EDIT**: 创建编辑框 - **CREATE_COMBO_BOX**: 创建下拉框 - **CREATE_CHECK_BOX**: 创建复选框 - **CREATE_TIMER**: 创建定时器 - **TIMER_SET_INTERVAL**: 设置定时器间隔 - **CREATE_MEMO**: 创建备忘录 - **CREATE_GROUP_BOX**: 创建分组框 - **CONTROL_SET_CAPTION**: 设置控件标题 - **CONTROL_GET_CAPTION**: 获取控件标题 - **CONTROL_SET_POSITION**: 设置控件位置 - **CONTROL_GET_POSITION**: 获取控件位置 - **CONTROL_SET_SIZE**: 设置控件大小 - **CONTROL_GET_SIZE**: 获取控件大小 - **DESTROY_OBJECT**: 销毁对象 #### 其他功能 - **LOAD_MODULE**: 加载模块 - **GENERATE_API_HOOK_SCRIPT**: 生成API Hook脚本 - **DEBUG_PROCESS**: 调试进程 - **AA_ADD_COMMAND**: 添加AutoAssembler命令 - **AA_DEL_COMMAND**: 删除AutoAssembler命令 ### Cheat Engine集成 - 注册主菜单插件，快捷键Ctrl+A - 提供Lua API，支持CE脚本调用 - 动态加载和卸载支持 - 完整的CE SDK集成 ## 技术栈 - 语言: C - 开发环境: Visual Studio 2019+ - 依赖: Windows SDK, Winsock2 - Cheat Engine SDK版本: 6 ## 安装方法 1. 编译插件： - 使用Visual Studio打开`CE-MCP-Plugin.sln` - 选择Release配置和Win32平台 - 编译生成`CE-MCP-Plugin.dll` 2. 安装插件： - 将编译好的`CE-MCP-Plugin.dll`复制到Cheat Engine的`plugins`目录 - 启动Cheat Engine - 在Cheat Engine主菜单中找到"CE-MCP-Plugin"选项 ## 使用说明 ### 1. 配置AI服务器 插件默认连接到`127.0.0.1:8888`地址。要修改AI服务器地址，请修改源代码中的以下变量： ```c char aiServerIP[16] = "127.0.0.1"; // AI服务器IP int aiServerPort = 8888; // AI服务器端口 ``` ### 2. 启动插件 1. 启动Cheat Engine 2. 插件会自动加载并尝试连接到AI服务器 3. 成功连接后会显示"Connected to AI server"消息 4. 在Cheat Engine主菜单中可以找到"CE-MCP-Plugin"选项 ### 3. AI命令格式 AI服务器可以向插件发送以下格式的命令： ``` COMMAND:parameters ``` 例如： ``` SHOW_MESSAGE:Hello from AI SPEEDHACK:2.0 AUTO_ASSEMBLE:[ENABLE]\nalloc(newmem,2048)\nnewmem:\n mov eax,100\n ret\n[DISABLE]\n dealloc(newmem) ``` ### 4. 使用Lua API 插件提供了`aiSendCommand` Lua函数，可以在CE脚本中调用： ```lua -- 向AI发送命令 local result = aiSendCommand("GET_HEALTH:player1") print(result) ``` ## 开发说明 ### 项目结构 ``` CE-MCP-Plugin/ ├── CE-MCP-Plugin.c # 主源代码文件（1611行，75个命令） ├── CE-MCP-Plugin.def # DLL导出函数定义 ├── CE-MCP-Plugin.sln # Visual Studio解决方案 ├── CE-MCP-Plugin.vcxproj # Visual Studio项目文件 ├── .github/ │ └── workflows/ │ └── msbuild.yml # GitHub Actions CI/CD工作流 ├── bla.cpp # 示例辅助文件 ├── bla.h # 示例头文件 ├── cepluginsdk.h # Cheat Engine SDK头文件 ├── lua.h # Lua 5.3头文件 ├── lualib.h # Lua标准库头文件 ├── lauxlib.h # Lua辅助库头文件 ├── luaconf.h # Lua配置头文件 ├── example-c.vcproj # 示例项目文件 ├── example-c.vcxproj.filters # 示例项目过滤器 └── README.md # 项目文档 ``` ### 编译选项 - 支持Win32和x64平台 - 支持Debug和Release配置 - 依赖Cheat Engine SDK头文件 ### 扩展开发 要添加新的AI指令支持，请修改`ExecuteAICommand`函数： ```c void ExecuteAICommand(AICommand* cmd) { if (strcmp(cmd->command, "NEW_COMMAND") == 0) { // 实现新指令逻辑 } // 其他指令... } ``` ## 注意事项 1. 确保AI服务器正在指定端口运行 2. 插件仅支持Windows平台 3. 需要Cheat Engine 7.0或更高版本 4. 建议在测试环境中使用，避免在在线游戏中使用 5. 使用时请遵守相关法律法规 ## 许可证 本项目采用MIT许可证，详见LICENSE文件。 ## 更新日志 ### v1.0 (2026-01-04) - 初始版本发布 - 实现AI连接功能 - 支持多种CE操作指令 - 提供Lua API ## 联系方式 如有问题或建议，请通过以下方式联系： - 提交GitHub Issue - 发送邮件至：[evildoerhacker@gmail.com] --- **免责声明**：本插件仅用于学习和研究目的，请勿用于非法用途。使用本插件造成的任何后果，由使用者自行承担。