Files
EVEngine/examples/devlab

DevLab — 开发者体验实验室

把 EVEngine「运行时即编辑器」的开发循环浓缩成一个 5 分钟可跑的示例。 必须用 --debug 运行(make devlab 已带该参数),否则 DevTools 不加载。

运行

make devlab
# 等价于:make run/<platform>-debug GAME=examples/devlab RUN_ARGS=--debug

体验路线(按顺序)

  1. F4 运行时控制台 / REPL:启动时脚本已写入日志(eve.dev.console.info)。 按 F4 打开控制台,输入 eve.dev.console.eval("lab.count") 回车,可读到当前帧计数; 也可以在控制台直接改状态,比如 eve.dev.console.eval("lab.vx = -200.0"),小球立刻反向。
  2. 热重载:打开 main.nut,改 bounceDir 的返回值(例如 0.85 → 1.0),保存。 控制台与 HUD 都会显示 script hot-reloaded,小球运动立即按新逻辑变化——不用重启引擎。
  3. F6/F7 状态快照:按 F6 保存当前脚本状态;让小球继续跑几秒;按 F7 恢复。 帧计数与小球位置会回到保存点——这是 AI 测试和「改代码→复位→重跑」闭环的基础。
  4. Pause 暂停循环:按 Pause 暂停游戏循环(HUD 显示 [PAUSED]),F8 单帧、F10/F11 语句级单步、F5 继续。
  5. 错误切片:按空格或点「触发运行时错误」。--debug 下错误会停在抛出点 (break on error),并在控制台 / DAP / MCP 生成错误切片,指出是哪一行、哪个调用路径导致的。
  6. F9 AI / MCP 面板:按 F9 打开面板,可看到本示例写入的 session note。 配合 eve run --debug --mcp-port=7529,Cursor / Claude 等 Agent 可以像人一样暂停、求值、 截图、改场景、复位状态(见 docs/dev/AI与MCP支持.md)。

它展示了什么

设计目标 对应体验
开发系统 = 游戏运行时 调试器、控制台、快照与游戏共用同一个进程
内置热重载 改脚本函数保存即生效,C++ 实体不重建
暂停游戏循环调试 Pause / F5 / F8 / F10 / F11 与 DAP
运行快照 F6 保存 / F7 恢复,供人机闭环测试
AI 原生控制面 F9 面板 + MCP 工具(求值、快照、截图、场景操作)