132 lines
4.6 KiB
Plaintext
132 lines
4.6 KiB
Plaintext
// ============================================================================
|
||
// DevLab — 开发者体验实验室
|
||
//
|
||
// 目标：把 EVEngine「运行时即编辑器」的开发循环浓缩成一个 5 分钟可跑的示例。
|
||
// 必须用 --debug 运行（make devlab 已带），否则 DevTools 不加载：
|
||
//
|
||
// F4 运行时控制台 / REPL（eve.dev.console.*）
|
||
// F6/F7 保存 / 恢复脚本状态快照（eve.dev.saveSnapshot / loadSnapshot）
|
||
// F9 AI / MCP 面板（eve.dev.ai.*）
|
||
// Pause 暂停游戏循环 F5 继续 F8 单帧
|
||
// F10/F11 语句级单步（step over / step into）
|
||
// 空格或「触发运行时错误」按钮 → 制造一个错误，观察 break-on-error 与错误切片
|
||
//
|
||
// 热重载：修改本文件任意函数后保存，脚本软重载立即生效（lab.reloads +1），
|
||
// 小球也会按新公式运动。修改 assets 或 JSON 资源则走 eve_asset_reload。
|
||
// ============================================================================
|
||
|
||
// 热重载持久化：EveScript persist 声明保留已创建的 C++ 对象与累计状态。
|
||
persist lab = {
|
||
count = 0
|
||
reloads = 0
|
||
x = 120.0
|
||
y = 180.0
|
||
vx = 96.0
|
||
vy = 60.0
|
||
lastLog = ""
|
||
}
|
||
|
||
// --- 热重载试验台：改这个函数，保存，看小球运动立刻变化 ---
|
||
function bounceDir(v, maxV) {
|
||
// 例如：把 0.85 改成 0.5 会让反弹衰减；改成 1.0 保持速度。
|
||
return (v < 0.0 || v > maxV) ? -0.85 : 1.0;
|
||
}
|
||
|
||
function labLog(text) {
|
||
lab.lastLog = text;
|
||
print("[devlab] " + text + "\n");
|
||
if ("dev" in eve && "console" in eve.dev)
|
||
eve.dev.console.info(text);
|
||
}
|
||
|
||
function devReady() {
|
||
return ("dev" in eve);
|
||
}
|
||
|
||
eve_init = function() {
|
||
gfx.setBackgroundColor(0.07, 0.09, 0.14, 1.0);
|
||
|
||
ui.setTheme("dark");
|
||
ui.beginBuild();
|
||
ui.beginWindow("DevLab", "root");
|
||
ui.text("EVEngine DevLab", "title");
|
||
ui.text("", "status");
|
||
ui.text("", "hint");
|
||
ui.button("触发运行时错误", "boom");
|
||
ui.end();
|
||
ui.mountBuildAs("labui");
|
||
ui.select("labui");
|
||
ui.setHostOverlay(true);
|
||
ui.setHostPos(12.0, 12.0, 0.0, 0.0);
|
||
|
||
if (devReady()) {
|
||
// 错误即暂停，配合 DAP / MCP 观察调用栈与错误切片。
|
||
eve.dev.setBreakOnError(true);
|
||
eve.dev.ai.note("devlab started");
|
||
labLog("DevTools attached: F4 console / F6-F7 snapshot / F9 AI panel");
|
||
} else {
|
||
labLog("DevTools not attached — run with --debug (make devlab)");
|
||
}
|
||
};
|
||
|
||
// 软重载后（脚本变更）调用：只做增量，不重建窗口 / 实体 / UI。
|
||
eve_reload <- function() {
|
||
lab.reloads += 1;
|
||
labLog("script hot-reloaded (" + lab.reloads + " times)");
|
||
if (devReady())
|
||
eve.dev.ai.note("hot reload #" + lab.reloads);
|
||
};
|
||
|
||
// 非 .nut 资源变更后调用（hot.tryReload 已处理的内置资源除外）。
|
||
eve_asset_reload <- function(path) {
|
||
labLog("asset changed: " + path);
|
||
};
|
||
|
||
function makeError() {
|
||
// 触发一次脚本错误：--debug 下会停在抛出点（break on error），
|
||
// 并在控制台 / DAP / MCP 生成错误切片，指出是哪一行导致的。
|
||
local missing = lab.nope_missing_field;
|
||
missing += 1;
|
||
}
|
||
|
||
eve_update = function(dt) {
|
||
lab.count += 1;
|
||
|
||
// 小球运动：热改 bounceDir 后保存，立即按新行为运动。
|
||
lab.vx *= bounceDir(lab.x, config.width - 48.0);
|
||
lab.vy *= bounceDir(lab.y, config.height - 48.0);
|
||
lab.x += lab.vx * dt;
|
||
lab.y += lab.vy * dt;
|
||
|
||
// 输入：空格触发演示错误。
|
||
if (keyboard.isDown("Space") || keyboard.isDown("space"))
|
||
makeError();
|
||
|
||
// UI 按钮：触发演示错误。
|
||
local c = ui.consumeClick();
|
||
while (c != "") {
|
||
if (c == "labui/boom")
|
||
makeError();
|
||
c = ui.consumeClick();
|
||
}
|
||
|
||
// HUD 刷新（每帧低频率文本更新，安全）。
|
||
ui.select("labui");
|
||
local paused = devReady() && eve.dev.isPaused() ? " [PAUSED]" : "";
|
||
ui.setText("status",
|
||
"frames=" + lab.count + " reloads=" + lab.reloads +
|
||
" pos=(" + lab.x.tointeger() + "," + lab.y.tointeger() + ")" + paused);
|
||
local hint =
|
||
devReady()
|
||
? "F4 控制台 · F6/F7 快照 · F9 AI 面板 · Pause 暂停 · Space 触发错误"
|
||
: "DevTools 未加载：请用 make devlab（--debug）运行";
|
||
ui.setText("hint", hint);
|
||
};
|
||
|
||
eve_render = function() {
|
||
gfx.clear();
|
||
gfx.drawSolidRect(lab.x - 20.0, lab.y - 20.0, 40.0, 40.0, 0.32, 0.78, 0.95, 1.0);
|
||
gfx.drawSolidRect(0.0, config.height - 48.0, config.width.tofloat(), 48.0, 0.16, 0.18, 0.24, 1.0);
|
||
ui.beginFrameAndRender();
|
||
};
|