RA3-COPILOT · 红色警戒3 作战辅助系统

/ 01

作战辅助系统

不是外挂式的作弊器，而是一套「可观测、可干预、可被 AI 驱动」的战术面板。挂载点采用「特征码 + RVA」双通道定位，愿景是覆盖红色警戒3 的全部版本。

Ra3-Copilot 以注入方式在游戏进程内运行，直接用游戏自己的渲染设备绘制菜单 —— 不弹独立窗口、不抢焦点、切出游戏也不会静音。

它由三部分组成：功能核（表驱动的内存 hook，负责资源 / 战斗 / 单位操作）、 渲染层（inline-hook 游戏渲染管线，把面板画在画面内）、 副官接口（进程内 HTTP + MCP，让 AI 读取战局并下达指令）。

所有写入类操作都经过安全护栏，且只在你主动触发时执行；注入前对每个挂载点做 特征码字节级校验，不匹配就拒绝挂载。

TECH SPEC

目标引擎: 红色警戒3 (C&C)
基线版本: v1.12.3444.25830
当前适配: 日冕 Mod 3.258
适配愿景: 覆盖全部 RA3 版本
架构: x86 / PE32
渲染: d3d9 inline-hook
面板: ImGui（游戏内）
接口: 127.0.0.1:17832
AI 接入: MCP stdio

/ 02

战术模块

八大模块，覆盖从资源到战场的全部干预点。

资源

资金实时读写、电力与科技点、全科技解锁。

建造

快速建造、免费建造、封锁敌方建造队列。

战斗

己方无敌、无限弹药、超武就绪 / 压制敌方超武、秒杀模式、无限缩放。

单位

选中单位变速 / 改血 / 收编 / 摧毁 / 满级。

协议

秘密协议与兵种升级直授，按阵营列目录、门槛明示。

召唤

按代码投放单位与基地车；海面折跃信标按兵种抽取。

空投

现金 / 治疗 / 晋升箱与海陆投仓，支持周期自动空投。

副官接口

MCP 工具与进程内 HTTP，把战局开放给 AI。

/ 03

系统架构

功能核（内存 hook）+ 渲染层（inline-hook）+ 副官接口，三层协作。

injector.exe (x86) ──CreateRemoteThread(LoadLibraryW)──► ra3copilot.dll (in-game)
                                                            │
                     ┌──────────────────────────────────────┼────────────────────────┐
                     ▼                                      ▼                        ▼
            features 功能核                          overlay 渲染层             httpapi / mcp 副官接口
            表驱动 hook（名/RVA/AOB/stub）               读 d3d9 vtable[16/17/42]        进程内 HTTP 127.0.0.1:17832
            push-ret 与 E9 detour                    → MinHook inline-hook           MCP stdio 服务器
            stub（MASM）→ 改内存 / 记录对象              → Present 内渲染 ImGui          → AI 读战局 / 投放部队

/ 04

快速上手

需要先进入对局；注入器与游戏同为 32 位。

STEP 01

启动游戏

通过启动器进入对局（遭遇战 / 战役均可）。

STEP 02

注入

运行 Ra3Copilot.exe，点「注入修改器」，自动提权并挂载。

STEP 03

呼出面板

游戏内按 INSERT 呼出多面板，功能按资源 / 战斗 / 单位 / 召唤分组，快捷键可在「设置」里改。

/ 05

脑机接口

19 个标准 MCP 工具，把进程内能力开放给 AI 客户端，让它成为你的副官。

工具	作用
`get_battle_state`	我方 / 敌方兵力、资金、选中单位
`list_objects` `object_detail`	全图对象枚举 / 单对象内部结构
`search_units`	单位检索（中文名 / 模板名 / 哈希）
`summon_unit` `get_spawn_point`	投放单位 / 落点探测
`drop_crate` `burst_crate`	空投补给箱 / 连续投放
`selected_action`	复制 / 增援 / 基地车 / 收编 / 摧毁 / 满级
`set_units` `unit_status`	变速改血 / 单位状态施加与解除
`command_unit` `build_structure`	移动 / 攻击 / 建造
`toggle_feature` `set_freebuild`	资源 / 战斗 / 地图类开关
`raw`	任意路由透传，直接读写内存、按 RVA 调函数

{
  "mcpServers": {
    "ra3-copilot": {
      "command": "python",
      "args": ["<仓库>/ra3-copilot/mcp/ra3_mcp.py"]
    }
  }
}

注入即常驻监听 127.0.0.1:17832，不需要额外开关；raw 可用环境变量 RA3_MCP_ALLOW_RAW=0 关闭。

/ 06