魔兽争霸 III 云脚本（MLS）本地测试工具，Rust 编写，单文件运行，自带原生 GUI，并保留 Bridge HTTP 接口供客户端对接。

用于在本地模拟平台云脚本运行环境，支持多客户端连接、事件收发、存档读写，无需连接线上平台。

mls-sim-rs/          Rust 模拟器源码
  src/               核心代码
  config.example.json 配置示例
docs/                使用文档
参考/mls-master/     平台官方 API 文档和 demo 脚本

需要 Rust 工具链（rustup + cargo）。

cd mls-sim-rs
cargo build --release

产物：target/release/mls-sim.exe，约 5MB，无外部依赖。

方式一：命令行指定脚本目录

mls-sim.exe --script-dir "D:/你的脚本目录/script"

启动后自动创建房间、加载 main.lua、打开原生 GUI。

方式二：使用配置文件

复制 config.example.json 为 config.json，修改里面的路径：

copy config.example.json config.json
mls-sim.exe

方式三：空启动后在 GUI 里建房

mls-sim.exe

在原生 GUI 的“房间”页点击“新建”手动创建房间。

curl http://127.0.0.1:5000/api/health

{
  "host": "127.0.0.1",
  "port": 5000,
  "auto_open_browser": true,
  "archive_dir": "./archives",
  "auto_room": {
    "script_dir": "D:/你的脚本目录/script",
    "mode_id": 0,
    "players": [
      {"index": 0, "name": "玩家1", "items": {"VIP001": 1}},
      {"index": 1, "name": "玩家2"}
    ]
  }
}

启动后打开 MLS 云脚本环境模拟 窗口，功能包括：

• 创建/停止/销毁房间
• 查看玩家状态（在线/离线、等级、道具）
• 模拟玩家断线、重连、退出
• 向云脚本发送自定义事件
• 实时查看脚本日志（支持级别过滤和搜索）
• 实时查看出站事件（脚本发给客户端的事件）
• 查看房间完整状态 JSON

客户端（War3 地图脚本或 Python/其他语言模拟）通过 HTTP 与模拟器通信：

发送事件给云脚本:  POST /api/bridge/event
轮询云脚本返回:    GET  /api/bridge/poll/{room_id}/{player_index}

Python 示例：

import requests, time

BASE = "http://127.0.0.1:5000"
ROOM = "room-001"

# 发送事件
requests.post(f"{BASE}/api/bridge/event", json={
    "room_id": ROOM, "player_index": 0,
    "ename": "buy_tower", "evalue": '{"id":1}'
})

# 轮询
while True:
    r = requests.get(f"{BASE}/api/bridge/poll/{ROOM}/0")
    for ev in r.json().get("events", []):
        print(f"[{ev['ename']}] {ev['evalue']}")
    time.sleep(0.05)

• 云脚本通过 MsSaveScriptArchive 等 API 写入存档
• 房间停止时自动保存到 archives/<脚本目录名>.json
• 下次创建同名脚本房间时自动读取上次存档
• 配置文件中手动指定的存档数据优先级高于自动读取

完整复刻平台 MLS 运行时 API，详见 Lua 接口参考：

• Log.Debug/Info/Error — 日志
• Timer.After/NewTicker — 定时器
• RegisterEvent/UnregisterEvent — 事件注册
• MsSendMlEvent — 发送事件给客户端
• MsGetPlayerName/MapLevel/MapExp/PlayedTime/PlayedCount — 玩家查询
• MsGetRoomStartTs/LoadedTs/GameTime/PlayerCount/ModeId — 房间查询
• MsGetPlayerItem/MsConsumeItem — 道具
• MsGet/SaveScriptArchive — 脚本存档
• MsGetCommonArchive/ReadArchive/CfgArchive — 普通/只读/全局存档
• MsSetReadArchive — 设置只读存档（触发 _rdata）
• MsEnd — 停止脚本
• json.encode/decode — JSON
• require — 模块加载（支持相对路径和 . 分隔）

见 docs 文档中心：

• 项目总览
• 用户指南
• 快速开始
• 程序使用说明
• 模拟器架构
• HTTP 接口参考
• Lua 接口参考
• 客户端对接
• 常见问题
• 与线上环境的差异